Skip to content

Main content

Ecological Trait Unit Source Pair Tool

Preserve an explicit ecological trait unit and source without converting dimensions or assigning trait values.

Loading tool…

Description

Preserve an explicit ecological trait unit and source.

Ecological records need explicit sampling units, detection states, effort denominators, interval geometry and trait/abundance bases. Nondetection differs from absence, and shared sampling-unit labels do not alone diagnose pseudoreplication. A one-axis overlap or single weighted contribution is only a limited component of a broader ecological analysis.

Preserve an explicit ecological trait unit and source.

When to use this tool

Use Ecological Trait Unit Source Pair when you already have traitRecordId, suppliedUnit, unitSource and need to preserve an explicit ecological trait unit and source.

How to use the tool and how it works

  1. Enter traitRecordId, suppliedUnit, unitSource. 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 traitRecordId, suppliedUnit, unitSource 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
traitRecordIdTrait Record IdRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
suppliedUnitSupplied UnitRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
unitSourceUnit SourceRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
tokenTokenRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "traitRecordId": "T17",
    "suppliedUnit": "mm",
    "unitSource": "protocol P4"
  },
  "output": {
    "token": "[\"T17\",\"mm\",\"protocol P4\"]"
  }
}

Limitations and assumptions

  • The result records supplied values without converting dimensions or assigning trait values. 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 original survey records, sampling design, specimens and calibration definitions for an ecological conclusion. Use complete detection, population, community or process models as appropriate; local count rates and source labels do not infer unobserved states or ecological mechanisms.

References

  1. Calculation and input contract: ecology/ecological-trait-unit-source-pair — tool.io

Similar or alternative tools