Skip to content

Main content

Taxonomic Revision Treatment Span Tool

Calculate taxonomic revision treatment span from explicit caller-supplied inputs.

Loading tool…

Description

Return an inclusive treatment-page span after exclusions.

Taxonomic names, authorship strings, nomenclatural types and source-defined taxon concepts are related but distinct records. A literal token parser or source-label comparison can preserve a stated convention without resolving accepted taxonomy or establishing compliance with the applicable nomenclatural code.

Return an inclusive treatment-page span after exclusions.

When to use this tool

Use Taxonomic Revision Treatment Span when checking the stated taxonomic source, name-token, date or concept-support convention.

How to use the tool and how it works

  1. Enter firstPage, lastPage, excludedPages. 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 inclusiveSpan, includedPages. Use the output convention below.

Return an inclusive treatment-page span after exclusions. Require positive ordered page endpoints and in-range excludedPages; inclusiveSpan = last-first+1, includedPages subtracts distinct excluded page numbers.1

Input fieldMeaning and unitsAccepted input
firstPageFirst PageRequired. Safe integer; minimum 1.
lastPageLast PageRequired. Safe integer.
excludedPagesExcluded PagesRequired. Array of safe integer; maximum items 256.
Output fieldInterpretationReturned shape
inclusiveSpanInclusive SpanRequired. Safe integer.
includedPagesIncluded PagesRequired. Safe integer.
json
{
  "input": {
    "firstPage": 10,
    "lastPage": 20,
    "excludedPages": [
      12,
      15,
      15
    ]
  },
  "output": {
    "inclusiveSpan": 11,
    "includedPages": 9
  }
}

Limitations and assumptions

  • Pagination and exclusions are supplied; no taxonomic treatment, source content or bibliographic completeness is 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

Consult the original taxonomic treatment and applicable nomenclatural code, and use source-aware taxonomic resolution for accepted names, priority or type status.

References

  1. Calculation and input contract: biosystematics/taxonomic-revision-treatment-span — tool.io

Similar or alternative tools