Skip to content

Main content

Species Occurrence Basis Of Record Token

Preserve an explicit occurrence basis-of-record term and vocabulary source without inferring evidence quality.

Loading tool…

Description

Preserve an explicit occurrence basis-of-record term and vocabulary source.

Biodiversity records distinguish surveyed sites, nondetection, counts, sampling units, voucher references and source-qualified taxonomic states. A coordinate-precision label changes metadata rather than protecting a location. Relative abundance and mean count per represented unit depend on their supplied denominators and survey scope.

Preserve an explicit occurrence basis-of-record term and vocabulary source.

When to use this tool

Use Species Occurrence Basis Of Record Token when you already have occurrenceId, suppliedBasis, vocabularySource and need to preserve an explicit occurrence basis-of-record term and vocabulary source.

How to use the tool and how it works

  1. Enter occurrenceId, suppliedBasis, vocabularySource. 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 token. Use the output convention below.

Enter occurrenceId, suppliedBasis, vocabularySource using the field constraints below. Encode these values, in exactly that order, as a JSON array and return the serialized array as text in token. String values are preserved without trimming or external terminology lookup.1

Input fieldMeaning and unitsAccepted input
occurrenceIdOccurrence IdRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
suppliedBasisSupplied BasisRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
vocabularySourceVocabulary SourceRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
tokenTokenRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "occurrenceId": "O17",
    "suppliedBasis": "HumanObservation",
    "vocabularySource": "source V4"
  },
  "output": {
    "token": "[\"O17\",\"HumanObservation\",\"source V4\"]"
  }
}

Limitations and assumptions

  • The result records supplied values without inferring evidence quality. Sources and asserted relationships are not independently authenticated.
  • 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.

Alternative or Complementary methods

Review specimens, original observations, sampling design and controlled taxonomic sources. Use complete detection, population and spatial methods when a local count fraction, source label or precision bin cannot answer the ecological or disclosure question.

References

  1. Calculation and input contract: biodiversity/species-occurrence-basis-of-record-token — tool.io

Similar or alternative tools