Skip to content

Main content

Fish Standard Total Length Gap Tool

Calculate fish standard total length gap from explicit caller-supplied inputs.

Loading tool…

Description

Return their difference and total/standard when standard is positive, otherwise ratio zero and defined false.

Fish morphometrics relate lengths, masses, ratios, and geometric components under stated measurement conventions. Standard, fork, and total lengths have distinct anatomical bases and should not be treated as interchangeable labels.

Return their difference and total/standard when standard is positive, otherwise ratio zero and defined false.

When to use this tool

Use Fish Standard Total Length Gap when you need one explicit morphometric component using compatible supplied measurements.

How to use the tool and how it works

  1. Enter standardLength, totalLength. 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 difference, ratio, defined. Inspect defined before interpreting the associated values.

Require totalLength at least nonnegative standardLength. Return their difference and total/standard when standard is positive, otherwise ratio zero and defined false.1

Input fieldMeaning and unitsAccepted input
standardLengthStandard LengthRequired. Finite number; minimum 0.
totalLengthTotal LengthRequired. Finite number.
Output fieldInterpretationReturned shape
differenceDifferenceRequired. Finite number.
ratioRatio on the numerator and denominator basis stated above.Required. Finite number.
definedWhether the associated ratio has its required denominator; inspect before using a zero placeholder.Required. Boolean.
json
{
  "input": {
    "standardLength": 20,
    "totalLength": 25
  },
  "output": {
    "difference": 5,
    "ratio": 1.25,
    "defined": true
  }
}

Limitations and assumptions

  • The ratio's zero value is a placeholder; measurements must share units and conventions, and no species conversion or anatomical validation is performed.
  • 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 measurement landmarks, species-specific models, and uncertainty before interpreting biological condition or comparing samples.

References

  1. Calculation and input contract: ichthyology/fish-standard-total-length-gap — tool.io

Similar or alternative tools