README
======

Dataset title:
Data for: Thermoacoustic streaming in a linear temperature gradient

Creators:
Per Augustsson and Enrico Corato

Responsible organization:
Lund University

See the Researchdata.se catalogue entry for this dataset for compete metadata, including the dataset description, recommended citation, contact information and information about how to obtain the dataset. 

Description: The dataset contains the experimental and numerical data for teh publication titled "Thermoacoustic streaming in a linear temperature gradient" by Corato et al, PRE 2025. The code necessary to analyse and plot the data is also included. 

License: CC-BY4.0

Access restrictions:


Essential information for dataset reuse.
----------------------------------------

The raw images were acquired as state in the related publication. 
The camera sampling was 30 Hz for all particle images but for the onlyT case for which it was 2 Hz. For the temeprature transition data the sampling was 10 Hz, as stated in the folder name. 
The software "DefocusTraker" is necessary to track the particles and it is available online (https://defocustracking.com/defocustracker/).


Dataset organization
--------------------

-README.txt (this file)
- Code
	- processing_defocustracker.m
	- postProcessing_defocustracker_pub.m
	- calc_vect_field_3d.m
	- Tcal_Tmeas_pub.m
- Experiments
	- Tmapping
		pulsedLight_20Hz_duty20perc
			- readME_Tdata.txt
			- BG_onlyWater
				- Default
			- Tcal
				- YY
					- Default
			- gradT
				- 20ch1_50ch2_Acu
					- repetitions
						- Default
				- 20ch1_50ch2_noAcu
					- repetitions
						- Default
				- transition_10Hz_duty10perc
					- soundOFF_ON_X
						- Default
					- soundON_OFF_X
						- Default
					- videos processed via MATLAB code from the corresponding image dataset
	- particleTracking
		- readME_particles.txt;
		- levitation:
			- BG_onlyWater_z15e7(_2 repetition)
				- Default
			- Zstack
				- repetitions
					- Default
			- tracking _z15e7um
				- repetitions
					- Default
		- streaming:
			- BG_onlyWater_z15e7(_2 repetition)
				- Default
			- Zstack
				- repetitions
					- Default
			- tracking _z15e7um
				- only Sound
					- repetitions
						- Default
				- onlyT_20ch1_50ch2
					- repetitions
						- Default
				- Thermoac_grad10C
					- repetitions
						- Default
				- Thermoac_grad20C
					- repetitions
						- Default
				- Thermoac_grad30C
					- repetitions
						- Default
- Model:
	- heatgradient_ideal_pub.mph
	- heatgradient_curved_pub.mph


Datafile descriptions
----------------------
Folders:
- Experiments:
	- particleTracking:
		- levitation (for Figure 4 in the publication):
			- background imges with only water in the channel (BG_onlyWater...);
			- stack of images at known height position (Zstack);
			- particle images during experiments (tracking...);
				- repetitions (XXX):
					- raw .tif images (Default).
		- streaming:
			- background imges with only water in the channel (BG_onlyWater...);
			- stack of images at known height position (Zstack);
			- particle images during experiments (tracking...):
				- different conditions: onlySound (Figure 2b), onlyT_20ch1_50ch2 (Figure 2d), Thermoac_grad10C (Figure 3a), Thermoac_grad20C (Figure 3b), Thermoac_grad30C (Figure 2f and 3c):
					- repetitions (XXX):
						- raw .tif images (Default, 100 images each).
	- Tmapping:
		- the folder (pulsedLight_20Hz_duty20perc) states the lighting condition (i.e. 20 Hz with a 20% duty cycle):
			- background imges with only water in the channel (BG_onlyWater...);
			- calibration images at known temperatures (Tcal):
				- one folder at each temperature YY:
					- two repetitions (bothYY...):
						- raw .tif images used for calibration (Default, 100 images each).
			- temperature gradient images with sound (20ch1_50ch2_Acu), without sound (20ch1_50ch2_noAcu), and with the transition between the two (transition_10Hz_duty10perc):
				- repetitions
					- raw .tif images (Default, 100 images each).
- Model:
	- COMSOL simulation with ideal pressure field (heatgradient_ideal_pub.mph);
	- COMSOL simulation with curved pressure field (heatgradient_curved_pub.mph).
- Code:
	- MATLAB code to process the data with DefocusTraker (processing_defocustracker.m);
	- MATLAB code to postprocess and plot the data from DefocusTraker (postProcessing_defocustracker_pub.m);
		- calls calc_vect_field_3d.m, which computer the velocity maps in 3D from the velocity of single particles;
	- MATLAB code to process the temperature data (Tcal_Tmeas_pub.m).

					
Reference information
---------------------

Source code information:
- MATLAB 2024a was used to produce the code for analysis and plotting (.m files);
	- the software "DefocusTraker" (https://defocustracking.com/) was used to process the particle images; 
- COMSOL Multiphysics 6.3 was used for the 2D simulations. 

Data Quality:
The images are either 16- or 8-bit greyscale images. No manipulation was done before performing the data analysis in MATLAB.