Description
For positive originalMass and retainedMass within zero through originalMass return fraction=retainedMass/originalMass.
Botanical laboratory records distinguish wet mass, dry matter, carriers, extract mass, and assay response. A fraction or reference comparison depends on the chosen material basis and supplied analytical method. Voucher and monograph metadata help identify records but do not themselves authenticate a specimen or establish product quality.
For positive originalMass and retainedMass within zero through originalMass return fraction=retainedMass/originalMass.
When to use this tool
Use Voucher Material Retention Fraction when you need this mass-basis, assay-response, extraction, or source-record calculation for supplied laboratory data.
How to use the tool and how it works
- Enter retainedMass, originalMass. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read fraction. Use the output convention below.
For positive originalMass and retainedMass within zero through originalMass return fraction=retainedMass/originalMass.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| retainedMass | Retained Mass | Required. Finite number; minimum 0. |
| originalMass | Original Mass | Required. Finite number; strictly above 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| fraction | Dimensionless fraction under the stated numerator and denominator. | Required. Finite number. |
{
"input": {
"retainedMass": 3,
"originalMass": 12
},
"output": {
"fraction": 0.25
}
}Limitations and assumptions
- Masses need the same basis and unit. This is material retention, not authentication of a voucher, confirmation of storage quality, or an assessment of medicinal efficacy.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Signed zero is exported as zero.
Alternative or Complementary methods
Use the appropriate authenticated reference material, analytical protocol, and source records for a full laboratory assessment. Verify moisture basis, response factors, and extract/carrier definitions before comparing results.
References
Similar or alternative tools
- Botanical Moisture Dry Weight Share
For positive wetMass and waterMass within zero through wetMass return dryMass=wetMass-waterMass and dryFraction=dryMass/wetMass.
- Medicinal Plant Powder Sieve Fraction
For positive initialMass and nonnegative retainedMasses with sum<=initialMass return each mass/initialMass, cumulativeRetained in supplied sieve order, and unaccountedMass=initialMass-sum(retainedMasses).