Description
Sum every nonnegative masses entry for specimenMass.
Specimen measurements and animal observations depend on a defined body part, reference value, unit, and observation window. A mass fraction, size ratio, or timing share summarizes those inputs. The counting and measurement conventions must stay explicit when comparing specimens or records.
Sum every nonnegative masses entry for specimenMass.
When to use this tool
Use Specimen Organ Measurement Share when you need to compare supplied specimen measurements or observation records under an explicit reference and denominator.
How to use the tool and how it works
- Enter organIds, masses, measured, selectedOrgan. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read specimenMass, selectedMeasuredMass, share, defined. Inspect defined before interpreting the associated values.
Sum every nonnegative masses entry for specimenMass. Sum entries only where measured is true and organIds equals selectedOrgan for selectedMeasuredMass, then divide by specimenMass when positive. All three arrays must align.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| organIds | Organ Ids | Required. Array of Text; maximum UTF-16 length 8192.; maximum items 256. |
| masses | Masses | Required. Array of Finite number; minimum 0.; maximum items 256. |
| measured | Measured | Required. Array of Boolean.; maximum items 256. |
| selectedOrgan | Selected Organ | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| specimenMass | Sum of all supplied masses, including rows whose measured flag is false. | Required. Finite number. |
| selectedMeasuredMass | Selected Measured Mass | Required. Finite number. |
| share | Dimensionless fraction using the denominator stated in the mechanics; not a percentage numeral. | Required. Finite number. |
| defined | Whether the associated denominator or quantity is defined; inspect before interpreting a placeholder. | Required. Boolean. |
{
"input": {
"organIds": [
"A",
"B"
],
"masses": [
2,
3
],
"measured": [
true,
false
],
"selectedOrgan": "A"
},
"output": {
"specimenMass": 5,
"selectedMeasuredMass": 2,
"share": 0.4,
"defined": true
}
}Limitations and assumptions
- The denominator includes supplied mass even when measured is false. A zero total returns share zero with defined false; repeated organ rows count separately, and no specimen or organ is identified.
- The field tables state structural bounds; the mechanics also specify cross-field constraints. Malformed inputs and unsupported domains cause errors. A successful false flag, empty branch value, or zero placeholder has the meaning stated above and is distinct from an input error.
- 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 compatible measurements and observation records to verify the chosen denominator and reference before interpreting a specimen comparison.
References
Similar or alternative tools
- Specimen Measurement Reference Offset
Compare supplied specimen measurements after explicit zero correction without species norms.
- Animal Specimen Fresh Dry Mass Factor
Calculate waterFraction=(freshMass-dryMass)/freshMass, dryMatterFraction=dryMass/freshMass, and ashFreeDryMass=dryMass-ashMass.