This program will take 2D vesicle area measurements (e.g. output from ImageJ) and calculate 3D vesicle number densities, an important characteristic of multi-phase magma.
Currently you must manually enter the paths to your input files, sample name, and clast vesicularity on lines 341 to 344 before running the program.
The required inputs are two CSV files of image data and vesicle areas, clast vesicularity, and sample number. The column headings for the CSV files are described below and example data is provided with the program.
This must be a CSV file with one column per image and the measured vesicle areas forming the rows. The column headings are the names of each image and must be without spaces. For the scanned images only the titles scan or billet are accepted. The remainder take the form like: 25a, 25b, 100aa, 100ab, 250aac, 250bba, etc. As long as the magnification goes first it does not matter what follows.
This must be a CSV file with one column per parameter as follows:
| Column heading | Description | Data type |
|---|---|---|
| image | name of image (see areas file description) | string |
| scale_factor | scale in pixels per millimetre | float |
| width | width of image in pixels | integer |
| height | height of image in pixels | integer |
| edge_grey | edge vesicles mean grey-scale value from ImageJ* | integer |
| crystals_grey | crystals mean grey-scale value from ImageJ* | integer |
| vesicles_grey | vesicles mean grey-scale value from ImageJ* | integer |
* Documentation for this is in preparation
This method is based on the following research which is cited in relevant sections of the code:
Sahagian DL, Proussevitch AA (1998) 3D particle size distributions from 2D observations: stereology for natural applications. Journal of Volcanology and Geothermal Research 84:173–196. doi: 10/fwnv97
Shea T, Houghton BF, Gurioli L, Cashman KV, Hammer JE, Hobden BJ (2010) Textural studies of vesicles in volcanic rocks: An integrated methodology. Journal of Volcanology and Geothermal Research 190:271–289. doi: 10/bmn9xt