analyze_svf is an automated program developed in MATLAB for analyzing sooting images and extracting soot volume fraction (SVF) quantitatively. The program can analyze images with both fixed and free-floating droplets during a burn.
- Install MATLAB on your computer.
- Clone or download the analyze_svf repository from Github.
- Open MATLAB and navigate to the folder where the repository and image data is located.
- Run the program by typing analyze_svf in the MATLAB command window.
- Load the original image and the attenuated image when prompted. The program will automatically convert the images to grayscale intensity matrices with an 8-bit unsigned integer.
- Measure the droplet radius manually and input a potential range of droplet radius, usually at a range of ±10 pixels from the manual measurement, to facilitate the program to identify the centers of droplets and the radiuses of the droplets for both images.
- Verify the droplet selection by checking the prompt windows for the images, which will show the droplet boundary marked in a red circle.
- Input the number of ROI under investigation. For one ROI analysis, the program will ask the user to input the endpoint of analysis using a mouse. For multi-ROI analysis, the user will input a direction-of-analysis (DOA) angle θ by doing two mouse inputs, start and end accordingly.
- With the DOA angle defined, the program draws other ROIs based on evenly dividing up the DOA angle so that the angle between any two ROIs on the same quadrant is θ/(nROI-1).
- The program will extract the soot volume fraction for each ROI and output the results.
analyze_svf uses the following MATLAB toolboxes and functions: Image Processing Toolbox: imfindcircles.m and improfile.m Financial Toolbox: tsmovavg.m
If using analyze_svf in your research, please cite the following paper: Y. Xu, Y. Shen, C.T. Avedisian, M.C. Hicks, M.Y. Choi, Quantitative Investigation of Sooting Dynamics in Droplet Combustion Using An Automated Image Analysis Algorithm, Fuel, 2023, 354: 129313. https://doi.org/10.1016/j.fuel.2023.129313.
MIT license