Standing Diversity Through Time Binner

Bin range-through standing diversity using positive-duration half-open ranges on a supplied increasing forward-time axis, excluding endpoint-only touches; ranges do not prove continuous actual occupancy.

Description

Range-through diversity counts taxa whose observed ranges overlap a time bin.

Range-through diversity counts taxa whose observed ranges overlap a time bin. Positive overlap differs from merely touching an endpoint.

When to use Standing Diversity Through Time Binner

Use this tool to bin range-through standing diversity using positive-duration half-open ranges on a supplied increasing forward-time axis, excluding endpoint-only touches; ranges do not prove continuous actual occupancy.

Prepare the fossil measurements or occurrence records and the chosen calibration parameters. Retain the stated coordinate, age and measurement conventions.

How to use Standing Diversity Through Time Binner and understand its results

Prepare the fossil measurements or occurrence records and the chosen calibration parameters. Retain the stated coordinate, age and measurement conventions.
Enter rangeStartTimesMyr, rangeEndTimesMyr, binBoundariesMyr using the field table and calculation rules, then run the tool.
Read rangeThroughDiversityByBin. The explanation below defines the units, signs, ordering and any flags or placeholder values.
If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.

Input field	Meaning	Value type; see rules below	Requirement
rangeStartTimesMyr	Range start times myr	list of number	Required
rangeEndTimesMyr	Range end times myr	list of number	Required
binBoundariesMyr	Bin boundaries myr	list of number	Required

Align forward-time starts and ends with strictly positive range lengths and increasing bin boundaries. Count overlap in each half-open bin; overlap workload is bounded.^[1]

Paired lists must be nonempty and have equal lengths. Each sequence checked for increasing order must contain at least two strictly increasing values.

overlap = start < bin end AND end > bin start

Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.

Output field	Meaning	Value type
rangeThroughDiversityByBin	Range through diversity by bin	list of number

json

{
  "input": {
    "rangeStartTimesMyr": [
      0,
      1,
      3
    ],
    "rangeEndTimesMyr": [
      2,
      3,
      4
    ],
    "binBoundariesMyr": [
      0,
      1,
      2,
      3,
      4
    ]
  },
  "output": {
    "rangeThroughDiversityByBin": [
      1,
      2,
      1,
      1
    ]
  }
}

Limitations and assumptions

Range-through presence does not prove continuous actual occupancy; use forward time rather than unconverted age-before-present values.

Numbers and computed results must be finite; overflow produces an error. Numeric lists are limited to 100,000 entries; the rules above may require smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.

Alternative or Complementary methods

Use Sampled-in-Bin Occurance Normalizer: Normalize sampled-in-bin occurrence counts by measured rock exposure and caller recovery probability, not by unequal bin duration alone; no unsampled-bin imputation. For a complementary task, use Extinction Magnitude Percent Taxa: Compare distinct before/after observed taxa with comparable detection, separating lost/surviving/new records; absent observations do not themselves establish biological extinction.

References

Standing Diversity Through Time Binner — tool.io

Similar or alternative tools

Sampled-in-Bin Occurance Normalizer
Normalize sampled-in-bin occurrence counts by measured rock exposure and caller recovery probability, not by unequal bin duration alone; no unsampled-bin imputation.
Extinction Magnitude Percent Taxa
Compare distinct before/after observed taxa with comparable detection, separating lost/surviving/new records; absent observations do not themselves establish biological extinction.