Skip to content

Main content

Specimen Body Part Count Gap Tool

Compare explicit observation counts with a supplied specimen record expectation.

Loading tool…

Description

Compare explicit observation counts with a supplied specimen record expectation.

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.

Compare explicit observation counts with a supplied specimen record expectation.

When to use this tool

Use Specimen Body Part Count Gap 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

  1. Enter observed, expected. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read gap. Use the output convention below.

Subtract expected from observed to return gap, requiring both counts to be nonnegative safe integers.1

Input fieldMeaning and unitsAccepted input
observedObservedRequired. Safe integer; minimum 0.
expectedExpectedRequired. Safe integer; minimum 0.
Output fieldInterpretationReturned shape
gapGapRequired. Safe integer.
json
{
  "input": {
    "observed": 6,
    "expected": 8
  },
  "output": {
    "gap": -2
  }
}

Limitations and assumptions

  • A negative gap reports fewer observed parts than supplied expectations. The tool does not identify a species, distinguish missing observations from absent anatomy, or select the expected count.
  • 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

  1. Calculation and input contract: zoology/specimen-body-part-count-gap — tool.io

Similar or alternative tools