Skip to content

Main content

Stream Substrate Grain Class Boundary Tool

Use caller-supplied increasing grain-size boundaries with lower-inclusive and upper-exclusive classes; no sediment taxonomy is selected.

Loading tool…

Description

Return a grain-class index under supplied boundaries.

Aquatic sampling expands observed counts using supplied area, filtered volume or processed fractions. Net efficiency, slip and grain-class boundaries affect that accounting. A scaled count or one-point class assignment does not establish true population abundance, detection probability or a universal substrate classification.

Return a grain-class index under supplied boundaries.

When to use this tool

Use Stream Substrate Grain Class Boundary when checking the stated aquatic sampling-volume, density or class-boundary convention.

How to use the tool and how it works

  1. Enter diameter, boundaries, labels. Follow any array-alignment requirements below. 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 index, label. Use the output convention below.

Return a grain-class index under supplied boundaries. Require diameter >= 0, strictly increasing nonnegative boundaries and one extra label; choose first boundary strictly above diameter, otherwise final class.1

Input fieldMeaning and unitsAccepted input
diameterDiameterRequired. Finite number.
boundariesStrictly increasing caller-chosen class boundaries; equality belongs to the higher class.Required. Array of finite number; maximum items 256.
labelsLabelsRequired. Array of text; maximum UTF-16 length 8192; maximum items 256.
Output fieldInterpretationReturned shape
indexIndexRequired. Safe integer.
labelLabelRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "diameter": 2,
    "boundaries": [
      1,
      2,
      4
    ],
    "labels": [
      "a",
      "b",
      "c",
      "d"
    ]
  },
  "output": {
    "index": 2,
    "label": "c"
  }
}

Limitations and assumptions

  • Equality belongs to the higher class; the classification scheme is supplied rather than a universal sediment standard.
  • 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

Use verified field methods, calibrated sampling efficiency and an appropriate statistical or classification scheme for abundance and ecological assessment.

References

  1. Calculation and input contract: aquatic-science/stream-substrate-grain-class-boundary — tool.io

Similar or alternative tools