Grain Size Support Share Tool

Description

Sum mass only for bins fully inside that interval and divide by total mass, otherwise return zero with defined false.

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.

Sum mass only for bins fully inside that interval and divide by total mass, otherwise return zero with defined false.

When to use this tool

Use Grain Size Support Share when you need an explicit sediment or material-basis conversion.

How to use the tool and how it works

Enter binMasses, binLowerDiameters, binUpperDiameters, supportedLower, supportedUpper. 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 totalMass, fullySupportedMass, supportedShare, defined. Inspect defined before interpreting the associated values.

Require aligned nonnegative masses and positive ordered size bounds, plus a positive supported interval. Sum mass only for bins fully inside that interval and divide by total mass, otherwise return zero with defined false.^[1]

Input field	Meaning and units	Accepted input
binMasses	Bin Masses	Required. Array of finite number; minimum 0; maximum items 256.
binLowerDiameters	Bin Lower Diameters	Required. Array of finite number; maximum items 256.
binUpperDiameters	Bin Upper Diameters	Required. Array of finite number; maximum items 256.
supportedLower	Supported Lower	Required. Finite number; strictly above 0.
supportedUpper	Supported Upper	Required. Finite number.

Output field	Interpretation	Returned shape
totalMass	Total Mass	Required. Finite number.
fullySupportedMass	Fully Supported Mass	Required. Finite number.
supportedShare	Supported Share	Required. Finite number.
defined	Whether the stated denominator or normalization exists; inspect before interpreting a zero placeholder.	Required. Boolean.

json

{
  "input": {
    "binMasses": [
      2,
      3
    ],
    "binLowerDiameters": [
      1,
      2
    ],
    "binUpperDiameters": [
      2,
      4
    ],
    "supportedLower": 1,
    "supportedUpper": 2
  },
  "output": {
    "totalMass": 5,
    "fullySupportedMass": 2,
    "supportedShare": 0.4,
    "defined": true
  }
}

Limitations and assumptions

Partially overlapping bins contribute nothing rather than a prorated mass; bin overlap, grain classification, source quality, and representative sampling are not verified.
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

Calculation and input contract: geomorphology/grain-size-support-share — 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.