Description
Multiply each dry-basis fraction by dryMatterFraction; keep wet-basis fractions unchanged.
Nutrient labels can report elements, oxide equivalents or fractions on wet, dry or anhydrous material bases. Stoichiometric conversion requires a verified chemical identity and the correct factor direction. A supplied source label and numerical factor record assumptions rather than proving the underlying chemical definition.
Multiply each dry-basis fraction by dryMatterFraction; keep wet-basis fractions unchanged.
When to use this tool
Use Nutrient Reporting Basis Gap when checking the stated nutrient, moisture or elemental-equivalent convention.
How to use the tool and how it works
- Enter reportedFraction, dryMatterFraction, referenceFraction, sourceIsDryBasis, referenceIsDryBasis. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read sourceWetFraction, referenceWetFraction, gap. Use the output convention below.
Require reported, reference and dry-matter fractions in [0,1]. Multiply each dry-basis fraction by dryMatterFraction; keep wet-basis fractions unchanged. Return both wet-basis values and source-minus-reference gap.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| reportedFraction | Reported Fraction | Required. Finite number; minimum 0; maximum 1. |
| dryMatterFraction | Dry material mass/wet material mass; shared by both reporting-basis conversions. | Required. Finite number; minimum 0; maximum 1. |
| referenceFraction | Reference Fraction | Required. Finite number; minimum 0; maximum 1. |
| sourceIsDryBasis | Source Is Dry Basis | Required. Boolean. |
| referenceIsDryBasis | Reference Is Dry Basis | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| sourceWetFraction | Source Wet Fraction | Required. Finite number. |
| referenceWetFraction | Reference Wet Fraction | Required. Finite number. |
| gap | Gap | Required. Finite number. |
{
"input": {
"reportedFraction": 0.2,
"dryMatterFraction": 0.5,
"referenceFraction": 0.1,
"sourceIsDryBasis": true,
"referenceIsDryBasis": false
},
"output": {
"sourceWetFraction": 0.1,
"referenceWetFraction": 0.1,
"gap": 0
}
}Limitations and assumptions
- Both values use the same supplied dry-matter conversion; matching fractions do not establish matching analytical methods or nutrient definitions.
- 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. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Check the original label, analytical method and authoritative chemical definition before applying a conversion or comparing nutrient quantities.
References
Similar or alternative tools
- Nutrient Moisture Basis Gap
Return expectedDryBasis=asReceived/dryFraction and supplied-minus-expected residual.
- Fertilizer Nutrient Basis Factor
Return mass*fraction, multiplying by the factor only when reportElement=true for reportedEquivalent.