Skip to content

Main content

Grain Class Boundary Closure Token Tool

Resolve one caller-supplied grain-size boundary without selecting a classification scale.

Loading tool…

Description

Label coarser above the boundary or at equality only when equalityToCoarser, otherwise finer.

Sediment and soil calculations distinguish mass basis, solid density, bulk volume, and grain-size conventions. Changing moisture or grain-size scale changes the denominator or coordinate, not the physical sample itself.

Label coarser above the boundary or at equality only when equalityToCoarser, otherwise finer.

When to use this tool

Use Grain Class Boundary Closure Token when you need an explicit sediment or material-basis conversion.

How to use the tool and how it works

  1. Enter diameter, boundary, equalityToCoarser. 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 side. Use the output convention below.

Require nonnegative diameter and boundary. Label coarser above the boundary or at equality only when equalityToCoarser, otherwise finer.1

Input fieldMeaning and unitsAccepted input
diameterDiameterRequired. Finite number; minimum 0.
boundaryBoundaryRequired. Finite number; minimum 0.
equalityToCoarserEquality To CoarserRequired. Boolean.
Output fieldInterpretationReturned shape
sideSideRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "diameter": 2,
    "boundary": 2,
    "equalityToCoarser": true
  },
  "output": {
    "side": "coarser"
  }
}

Limitations and assumptions

  • Both values share a size unit and the threshold and closure policy are supplied; no universal grain-class standard, actual size, or sediment origin is selected.
  • 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 a traceable laboratory and sampling method for the required material property. Align wet/dry basis, solid versus bulk density, grain-size scale, and interval definitions before comparing samples.

References

  1. Calculation and input contract: geomorphology/grain-class-boundary-closure-token — tool.io

Similar or alternative tools

  • Grain Size Phi Step

    Return log2(first/second) using log1p for a representable relative difference and a difference of logarithms otherwise.

  • Grain Size Phi Uncertainty Width Transform

    Compute phi as negative log2 of the numeric diameter in millimeters, reverse diameter extrema for phi bounds, and return logarithmic width.