Vesicularity Porosity Calculation Tool
Actual matched whole/all/open-vesicle specimen volumes, closed vesicles distinguished from connected porosity; not generic void ratio or rock identity. Caller independently establishes units, regime, calibration and applicability; this does not establish design-code compliance, authenticity, operational safety, treatment efficacy or a validated forecast.
Description
Vesicles are cavities within volcanic rock; only some may connect to an open pore network.
Vesicles are cavities within volcanic rock; only some may connect to an open pore network.1
Whole specimen, total vesicle, and connected vesicle volumes allow total vesicularity and connected porosity to be reported separately.
When to use Vesicularity Porosity Calculation Tool
Use this tool when you need to reproduce the stated calculation from measured records or independently selected model inputs. Prepare matched observations and independently established site, specimen, units, datum, and calibration context.
How to use Vesicularity Porosity Calculation Tool and understand its results
- Prepare matched observations and independently established site, specimen, units, datum, and calibration context.
- Enter observedVesicleVolumesMm3, observedMatchedWholeRockVolumesMm3, observedOpenConnectedVesicleVolumesMm3, following the field table and rules below, then run the tool.
- Read pooledVesicularityFraction, connectedVesicleFractionOfWhole. Use the output meanings below to interpret units, signs, flags, and any nested result fields.
- Correct reported input issues and run again. For a successful result, check the stated evidence coverage and assumptions before using it in your review.
| Input field | Meaning | Value type | Requirement |
|---|---|---|---|
| observedVesicleVolumesMm3 | Observed vesicle volumes mm3 | list of number | Required |
| observedMatchedWholeRockVolumesMm3 | Observed matched whole rock volumes mm3 | list of number | Required |
| observedOpenConnectedVesicleVolumesMm3 | Observed open connected vesicle volumes mm3 | list of number | Required |
Enter aligned specimen volumes in cubic millimetres. Whole-rock volume must be positive, and 0 ≤ connected vesicles ≤ all vesicles ≤ whole volume for every specimen. Pool volumes before dividing, so larger specimens contribute proportionally.
vesicularity = Σ(allVesicles)/Σ(wholeRock); connectedFraction = Σ(connectedVesicles)/Σ(wholeRock) Symbols follow the input and output meanings and the calculation rules above.
| Output field | Meaning | Value type |
|---|---|---|
| pooledVesicularityFraction | Pooled vesicularity fraction | number |
| connectedVesicleFractionOfWhole | Connected vesicle fraction of whole | number |
{
"input": {
"observedVesicleVolumesMm3": [
1,
3
],
"observedMatchedWholeRockVolumesMm3": [
10,
20
],
"observedOpenConnectedVesicleVolumesMm3": [
0.5,
1
]
},
"output": {
"pooledVesicularityFraction": 0.13333333333333333,
"connectedVesicleFractionOfWhole": 0.05
}
}Limitations and assumptions
Interpretation requires independently matched observations, units, site or specimen, and calibration. The calculation does not establish geological identity, operating safety, or an eruption forecast.
Missing required fields, unknown fields, wrong types, and violated calculation rules are input issues. Numeric values must be finite; nonfinite results are rejected. Evidence arrays must be dense, with no missing cells. Numeric observation lists allow at most 10,000 entries, subject to any smaller bounds stated above.
Alternative or Complementary methods
For a related review, use Scoria vs Pumice Vesicularity Split Checker: Scoria and pumice descriptions require more than a porosity number. This tool screens your density, composition, and vesicle evidence against explicit class requirements, keeping overlapping or incomplete possibilities visible. For a complementary step, use Perlite Expansion Ratio Industrial Lookup: Perlite expansion is a ratio between matched expanded and original volumes. Pooling those volumes gives a result weighted by original volume, which can differ from the simple average of specimen ratios.
References
-
Vesicularity Porosity Calculation Tool — tool.io
Similar or alternative tools
- Scoria vs Pumice Vesicularity Split Checker
Scoria and pumice descriptions require more than a porosity number. This tool screens your density, composition, and vesicle evidence against explicit class requirements, keeping overlapping or incomplete possibilities visible.
- Perlite Expansion Ratio Industrial Lookup
Perlite expansion is a ratio between matched expanded and original volumes. Pooling those volumes gives a result weighted by original volume, which can differ from the simple average of specimen ratios.