Lexicon Garden

app.gainforest.dwc.measurement

A bundle of measurements, facts, or characteristics about an occurrence. One record per occurrence, with all measurements grouped inside a typed result union.

Repository @gainforest.earth did:plc:qoti4acfmc5wg6zzmtix6hse namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authoritydwc.gainforest.app
Indexed
Compare Edit in builder → Fork →

Record

record · key tid

Properties

createdAt

requiredstring · datetime

Timestamp of record creation in the ATProto PDS.

measuredBy

string

Person(s) who performed the measurements. Pipe-delimited for multiple.

  • maxGraphemes: 512

measuredByID

string

ORCID or other persistent identifier(s) for the measurer(s). Pipe-delimited for multiple.

  • maxGraphemes: 512

measurementDate

string

Date the measurements were taken. ISO 8601 format.

  • maxGraphemes: 64

measurementMethod

string

General protocol or method used (e.g., 'ForestGEO standard protocol', 'mist-net examination').

  • maxGraphemes: 1024

measurementRemarks

string

Comments or notes about the measurement session.

  • maxGraphemes: 5000

occurrenceID

string

The occurrenceID of the linked occurrence record (for cross-system interoperability with GBIF/DwC-A exports).

  • maxGraphemes: 256

occurrenceRef

requiredstring · at-uri

AT-URI reference to the app.gainforest.dwc.occurrence record these measurements belong to.

result

requiredunion

The typed measurement payload. Use floraMeasurement for sessile organisms (trees, plants, corals, sponges), faunaMeasurement for mobile organisms (mammals, birds, reptiles, amphibians, fish, insects), or genericMeasurement as a flexible fallback.

One of

#faunaMeasurement

object

Typed measurements for mobile organisms: mammals, birds, reptiles, amphibians, fish, insects, and other animals. Covers morphometrics, health assessments, reproductive measurements, and individual marking data. All numeric values stored as strings. Field descriptions include expected units for DwC-A export mapping.

Properties

additionalMeasurements

array

Additional measurements not covered by the typed fields above.

  • maxLength: 50
itemsref
Reference

bandNumber

string

Metal or color band/ring number (birds).

  • maxGraphemes: 128

billDepth

string

Depth of bill at base or gonys in millimeters (birds).

  • maxGraphemes: 32

billLength

string

Culmen length in millimeters (birds).

  • maxGraphemes: 32

bodyConditionIndex

string

Calculated condition index (mass/length ratio or regression residual).

  • maxGraphemes: 32

bodyConditionScore

string

Standardized body condition score (scale varies by taxon: 1-5 or 1-9).

  • maxGraphemes: 16

bodyMass

string

Body mass in grams.

  • maxGraphemes: 32

broodSize

integer

Number of surviving young.

  • minimum: 0

carapaceLength

string

Straight carapace length in millimeters (turtles/tortoises).

  • maxGraphemes: 32

carapaceWidth

string

Straight carapace width in millimeters (turtles/tortoises).

  • maxGraphemes: 32

clutchSize

integer

Number of eggs in nest (birds, reptiles).

  • minimum: 0

colorBandCombination

string

Description of color band arrangement (e.g., 'Red/White left, Blue/Metal right').

  • maxGraphemes: 256

diseaseDescription

string

Description of disease signs (mange, lesions, tumors, fungal infection, avian pox, chytrid).

  • maxGraphemes: 512

diseaseSignsPresent

boolean

Whether signs of disease are visible.

earLength

string

Ear length from notch to tip in millimeters (mammals).

  • maxGraphemes: 32

ectoparasiteLoad

string

Ectoparasite assessment.

  • maxGraphemes: 32
  • knownValues: none | light | moderate | heavy

fatScore

string

Subcutaneous fat deposit score (0-8 scale, birds).

  • maxGraphemes: 8

forearmLength

string

Forearm length in millimeters. Standard measurement for bats.

  • maxGraphemes: 32

forkLength

string

Fork length (snout to fork of caudal fin) in millimeters (fish).

  • maxGraphemes: 32

geneticSampleId

string

Identifier of tissue, hair, or feather sample collected for genetic analysis.

  • maxGraphemes: 128

groupSize

integer

Total size of social group observed (herd, flock, pod, colony).

  • minimum: 1

headBodyLength

string

Head-body length excluding tail in millimeters.

  • maxGraphemes: 32

hindFootLength

string

Hind foot length in millimeters (mammals).

  • maxGraphemes: 32

injuryDescription

string

Description of injuries (scars, wounds, missing limbs, broken wing).

  • maxGraphemes: 512

injuryPresent

boolean

Whether visible injuries exist.

litterSize

integer

Number of offspring in litter (mammals).

  • minimum: 0

markDescription

string

Description of natural marks, scars, or unique identifying features.

  • maxGraphemes: 512

nestHeight

string

Height of nest above ground in meters.

  • maxGraphemes: 32

pectoralMuscleScore

string

Pectoral muscle score (0-3 scale, birds).

  • maxGraphemes: 8

pitTagId

string

Passive Integrated Transponder (microchip) number.

  • maxGraphemes: 128

recaptureStatus

string

Whether this is a new capture or recapture.

  • maxGraphemes: 16
  • knownValues: new | recapture | unknown

shoulderHeight

string

Height at shoulder in millimeters (large mammals).

  • maxGraphemes: 32

snoutVentLength

string

Snout-vent length (SVL) in millimeters. Standard body measurement for reptiles and amphibians.

  • maxGraphemes: 32

standardLength

string

Standard length (snout to caudal fin base) in millimeters (fish).

  • maxGraphemes: 32

tagId

string

Ear tag, flipper tag, fin tag, or wing tag identifier.

  • maxGraphemes: 128

tagType

string

Type of tag or mark applied.

  • maxGraphemes: 64
  • knownValues: ear-tag | flipper-tag | wing-tag | dorsal-tag | pit-tag | leg-band | neck-collar | gps-collar | radio-transmitter | satellite-transmitter | paint-mark | tattoo | toe-clip | other

tailLength

string

Tail length in millimeters.

  • maxGraphemes: 32

tarsusLength

string

Tarsometatarsus length in millimeters (birds).

  • maxGraphemes: 32

totalLength

string

Total body length in millimeters (tip of snout/bill to tail tip).

  • maxGraphemes: 32

wingLength

string

Flattened wing chord length in millimeters (birds).

  • maxGraphemes: 32

wingspan

string

Full wingspan tip-to-tip in millimeters (birds, bats).

  • maxGraphemes: 32

#floraMeasurement

object

Typed measurements for sessile organisms: trees, woody plants, herbs, grasses, corals, sponges, lichens, and other non-mobile life forms. All numeric values stored as strings. Field descriptions include expected units for DwC-A export mapping.

Properties

abovegroundBiomass

string

Estimated aboveground biomass in kilograms, derived from allometric equations.

  • maxGraphemes: 32

additionalMeasurements

array

Additional measurements not covered by the typed fields above.

  • maxLength: 50
itemsref
Reference

annualDiameterIncrement

string

Annual radial growth measured via dendrometer bands or core samples in millimeters per year.

  • maxGraphemes: 32

basalArea

string

Cross-sectional area of trunk at breast height in square centimeters.

  • maxGraphemes: 32

basalDiameter

string

Diameter at ground level or just above root flare in centimeters. Standard for shrubs and multi-stemmed plants.

  • maxGraphemes: 32

belowgroundBiomass

string

Estimated belowground (root) biomass in kilograms.

  • maxGraphemes: 32

biomassAllometricEquation

string

Reference to the allometric equation used for biomass estimation (e.g., 'Chave et al. 2014').

  • maxGraphemes: 512

bleachingStatus

string

Coral bleaching status.

  • maxGraphemes: 32
  • knownValues: none | pale | partially-bleached | fully-bleached | recently-dead

buttressHeight

string

Height of buttress roots above ground in meters. Common in tropical trees.

  • maxGraphemes: 32

canopyCoverPercent

string

Percentage of ground covered by the canopy of this individual.

  • maxGraphemes: 16

carbonContent

string

Estimated carbon stored in kilograms of carbon (typically 47-50% of dry biomass).

  • maxGraphemes: 32

colonyDiameter

string

Maximum colony diameter in centimeters (corals, sponges).

  • maxGraphemes: 32

colonyHeight

string

Height of colony from base to apex in centimeters.

  • maxGraphemes: 32

colonyMorphology

string

Colony growth form.

  • maxGraphemes: 64
  • knownValues: massive | branching | encrusting | foliose | tabular | columnar | free-living | other

crownDepth

string

Vertical extent of crown in meters (total height minus height to crown base).

  • maxGraphemes: 32

crownDiameter

string

Average crown diameter in meters (typically mean of multiple radial measurements).

  • maxGraphemes: 32

crownDieback

string

Percentage of crown showing dieback.

  • maxGraphemes: 16

crownPosition

string

Canopy position relative to neighbors.

  • maxGraphemes: 32
  • knownValues: dominant | codominant | intermediate | suppressed | emergent

damageCause

string

Cause of damage.

  • maxGraphemes: 128
  • knownValues: wind | lightning | fire | drought | flood | animal | human | disease | pest | unknown | other

damageType

string

Type of damage observed (e.g., 'broken crown', 'leaning', 'uprooted', 'hollow', 'scarred', 'stripped bark').

  • maxGraphemes: 256

dbh

string

Diameter at breast height in centimeters. The core measurement in all tree inventories (ForestGEO, NFI, RAINFOR).

  • maxGraphemes: 32

dbhMeasurementHeight

string

Height above ground where DBH was measured, in meters. Important when measured above buttress or irregularity. Default is 1.3m.

  • maxGraphemes: 32

decayClass

string

Decay classification for dead trees (1-5 scale per ForestGEO/FIA protocols).

  • maxGraphemes: 8

depthBelowSurface

string

Depth of the organism below water surface in meters.

  • maxGraphemes: 32

estimatedAge

string

Estimated age of the organism in years (from rings, radiocarbon, or allometry).

  • maxGraphemes: 32

floweringStatus

string

Current flowering/reproductive state.

  • maxGraphemes: 32
  • knownValues: none | budding | flowering | fruiting | senescing

girth

string

Circumference of trunk at breast height in centimeters. Alternative to DBH (convertible via pi).

  • maxGraphemes: 32

growthForm

string

Growth form classification of the organism.

  • maxGraphemes: 64
  • knownValues: tree | shrub | liana | palm | tree-fern | herb | grass | bamboo | epiphyte | succulent | mangrove | other

healthScore

string

Numeric health or vigor score (protocol-dependent scale).

  • maxGraphemes: 16

heightMeasurementMethod

string

Method used for height measurement.

  • maxGraphemes: 128
  • knownValues: clinometer | laser-rangefinder | hypsometer | direct-pole | estimated | drone-photogrammetry | lidar | other

heightToFirstBranch

string

Height from ground to first major living branch (bole length) in meters.

  • maxGraphemes: 32

leafAreaIndex

string

Leaf area index: total one-sided leaf area per unit ground area (m²/m²).

  • maxGraphemes: 32

liveTissueCoverPercent

string

Percentage of colony surface with live tissue.

  • maxGraphemes: 16

phenology

string

Current phenological state.

  • maxGraphemes: 64
  • knownValues: leafless | flush | full-leaf | senescing | dormant

stemCount

integer

Number of stems for multi-stemmed individuals.

  • minimum: 1

totalHeight

string

Total height from ground to highest living point in meters.

  • maxGraphemes: 32

vitalityStatus

string

Overall vitality status of the organism.

  • maxGraphemes: 32
  • knownValues: alive | dead-standing | dead-fallen | moribund | missing | unknown

woodDensity

string

Specific gravity of wood (dry mass / green volume) in grams per cubic centimeter.

  • maxGraphemes: 32

#genericMeasurement

object

Flexible measurement container for organisms that do not fit the flora/fauna split, or for legacy compatibility. Contains an array of key-value measurement entries.

Properties

measurements

requiredarray

Array of individual measurements, each with type, value, and optional unit.

  • maxLength: 100
itemsref
Reference

#measurementEntry

object

A single measurement fact, aligned with one row of the Darwin Core MeasurementOrFact extension. Used in additionalMeasurements arrays and in genericMeasurement.

Properties

measurementAccuracy

string

Potential error (e.g., '0.5 cm', '5%').

  • maxGraphemes: 128

measurementMethod

string

Method or instrument used to determine this specific measurement.

  • maxGraphemes: 512

measurementRemarks

string

Notes about this specific measurement.

  • maxGraphemes: 1024

measurementType

requiredstring

The nature of the measurement (e.g., 'DBH', 'tree height', 'canopy cover', 'tail length', 'soil pH').

  • maxGraphemes: 256

measurementUnit

string

The units for the value (e.g., 'cm', 'm', 'kg', '%', 'degrees Celsius').

  • maxGraphemes: 64

measurementValue

requiredstring

The value of the measurement (e.g., '45.2', 'present', 'blue').

  • maxGraphemes: 1024

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • app.gainforest.dwc.occurrence

    record

    A single biodiversity occurrence record aligned with Simple Darwin Core (TDWG Standard 450, version 2023-09-13). Represents one organism or group of organisms at a particular place and time.

  • app.gainforest.dwc.defs

    Shared type definitions for Darwin Core aligned biodiversity records