app.gainforest.dwc.measurement

gainforest.earth

Documentation

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

main record

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

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

Timestamp of record creation in the ATProto PDS.

measuredBy string Optional

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

maxGraphemes: 512 graphemes
measuredByID string Optional

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

maxGraphemes: 512 graphemes
measurementDate string Optional

Date the measurements were taken. ISO 8601 format.

maxGraphemes: 64 graphemes
measurementMethod string Optional

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

maxGraphemes: 1024 graphemes
measurementRemarks string Optional

Comments or notes about the measurement session.

maxGraphemes: 5000 graphemes
occurrenceID string Optional

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

maxGraphemes: 256 graphemes
occurrenceRef string at-uri Required

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

result union Required

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.

View raw schema
{
  "description": "A bundle of measurements, facts, or characteristics about an occurrence. One record per occurrence, with all measurements grouped inside a typed result union.",
  "key": "tid",
  "record": {
    "properties": {
      "createdAt": {
        "description": "Timestamp of record creation in the ATProto PDS.",
        "format": "datetime",
        "type": "string"
      },
      "measuredBy": {
        "description": "Person(s) who performed the measurements. Pipe-delimited for multiple.",
        "maxGraphemes": 512,
        "type": "string"
      },
      "measuredByID": {
        "description": "ORCID or other persistent identifier(s) for the measurer(s). Pipe-delimited for multiple.",
        "maxGraphemes": 512,
        "type": "string"
      },
      "measurementDate": {
        "description": "Date the measurements were taken. ISO 8601 format.",
        "maxGraphemes": 64,
        "type": "string"
      },
      "measurementMethod": {
        "description": "General protocol or method used (e.g., 'ForestGEO standard protocol', 'mist-net examination').",
        "maxGraphemes": 1024,
        "type": "string"
      },
      "measurementRemarks": {
        "description": "Comments or notes about the measurement session.",
        "maxGraphemes": 5000,
        "type": "string"
      },
      "occurrenceID": {
        "description": "The occurrenceID of the linked occurrence record (for cross-system interoperability with GBIF/DwC-A exports).",
        "maxGraphemes": 256,
        "type": "string"
      },
      "occurrenceRef": {
        "description": "AT-URI reference to the app.gainforest.dwc.occurrence record these measurements belong to.",
        "format": "at-uri",
        "type": "string"
      },
      "result": {
        "closed": false,
        "description": "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.",
        "refs": [
          "#floraMeasurement",
          "#faunaMeasurement",
          "#genericMeasurement"
        ],
        "type": "union"
      }
    },
    "required": [
      "occurrenceRef",
      "result",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}
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 of ref#measurementEntry Optional

Additional measurements not covered by the typed fields above.

maxLength: 50 items
bandNumber string Optional

Metal or color band/ring number (birds).

maxGraphemes: 128 graphemes
billDepth string Optional

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

maxGraphemes: 32 graphemes
billLength string Optional

Culmen length in millimeters (birds).

maxGraphemes: 32 graphemes
bodyConditionIndex string Optional

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

maxGraphemes: 32 graphemes
bodyConditionScore string Optional

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

maxGraphemes: 16 graphemes
bodyMass string Optional

Body mass in grams.

maxGraphemes: 32 graphemes
broodSize integer Optional

Number of surviving young.

minimum: 0
carapaceLength string Optional

Straight carapace length in millimeters (turtles/tortoises).

maxGraphemes: 32 graphemes
carapaceWidth string Optional

Straight carapace width in millimeters (turtles/tortoises).

maxGraphemes: 32 graphemes
clutchSize integer Optional

Number of eggs in nest (birds, reptiles).

minimum: 0
colorBandCombination string Optional

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

maxGraphemes: 256 graphemes
diseaseDescription string Optional

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

maxGraphemes: 512 graphemes
diseaseSignsPresent boolean Optional

Whether signs of disease are visible.

earLength string Optional

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

maxGraphemes: 32 graphemes
ectoparasiteLoad string Optional

Ectoparasite assessment.

maxGraphemes: 32 graphemes
Known values: none, light, moderate, heavy
fatScore string Optional

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

maxGraphemes: 8 graphemes
forearmLength string Optional

Forearm length in millimeters. Standard measurement for bats.

maxGraphemes: 32 graphemes
forkLength string Optional

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

maxGraphemes: 32 graphemes
geneticSampleId string Optional

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

maxGraphemes: 128 graphemes
groupSize integer Optional

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

minimum: 1
headBodyLength string Optional

Head-body length excluding tail in millimeters.

maxGraphemes: 32 graphemes
hindFootLength string Optional

Hind foot length in millimeters (mammals).

maxGraphemes: 32 graphemes
injuryDescription string Optional

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

maxGraphemes: 512 graphemes
injuryPresent boolean Optional

Whether visible injuries exist.

litterSize integer Optional

Number of offspring in litter (mammals).

minimum: 0
markDescription string Optional

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

maxGraphemes: 512 graphemes
nestHeight string Optional

Height of nest above ground in meters.

maxGraphemes: 32 graphemes
pectoralMuscleScore string Optional

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

maxGraphemes: 8 graphemes
pitTagId string Optional

Passive Integrated Transponder (microchip) number.

maxGraphemes: 128 graphemes
recaptureStatus string Optional

Whether this is a new capture or recapture.

maxGraphemes: 16 graphemes
Known values: new, recapture, unknown
shoulderHeight string Optional

Height at shoulder in millimeters (large mammals).

maxGraphemes: 32 graphemes
snoutVentLength string Optional

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

maxGraphemes: 32 graphemes
standardLength string Optional

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

maxGraphemes: 32 graphemes
tagId string Optional

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

maxGraphemes: 128 graphemes
tagType string Optional

Type of tag or mark applied.

maxGraphemes: 64 graphemes
Known values: 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 Optional

Tail length in millimeters.

maxGraphemes: 32 graphemes
tarsusLength string Optional

Tarsometatarsus length in millimeters (birds).

maxGraphemes: 32 graphemes
totalLength string Optional

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

maxGraphemes: 32 graphemes
wingLength string Optional

Flattened wing chord length in millimeters (birds).

maxGraphemes: 32 graphemes
wingspan string Optional

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

maxGraphemes: 32 graphemes
View raw schema
{
  "description": "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": {
      "description": "Additional measurements not covered by the typed fields above.",
      "items": {
        "ref": "#measurementEntry",
        "type": "ref"
      },
      "maxLength": 50,
      "type": "array"
    },
    "bandNumber": {
      "description": "Metal or color band/ring number (birds).",
      "maxGraphemes": 128,
      "type": "string"
    },
    "billDepth": {
      "description": "Depth of bill at base or gonys in millimeters (birds).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "billLength": {
      "description": "Culmen length in millimeters (birds).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "bodyConditionIndex": {
      "description": "Calculated condition index (mass/length ratio or regression residual).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "bodyConditionScore": {
      "description": "Standardized body condition score (scale varies by taxon: 1-5 or 1-9).",
      "maxGraphemes": 16,
      "type": "string"
    },
    "bodyMass": {
      "description": "Body mass in grams.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "broodSize": {
      "description": "Number of surviving young.",
      "minimum": 0,
      "type": "integer"
    },
    "carapaceLength": {
      "description": "Straight carapace length in millimeters (turtles/tortoises).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "carapaceWidth": {
      "description": "Straight carapace width in millimeters (turtles/tortoises).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "clutchSize": {
      "description": "Number of eggs in nest (birds, reptiles).",
      "minimum": 0,
      "type": "integer"
    },
    "colorBandCombination": {
      "description": "Description of color band arrangement (e.g., 'Red/White left, Blue/Metal right').",
      "maxGraphemes": 256,
      "type": "string"
    },
    "diseaseDescription": {
      "description": "Description of disease signs (mange, lesions, tumors, fungal infection, avian pox, chytrid).",
      "maxGraphemes": 512,
      "type": "string"
    },
    "diseaseSignsPresent": {
      "description": "Whether signs of disease are visible.",
      "type": "boolean"
    },
    "earLength": {
      "description": "Ear length from notch to tip in millimeters (mammals).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "ectoparasiteLoad": {
      "description": "Ectoparasite assessment.",
      "knownValues": [
        "none",
        "light",
        "moderate",
        "heavy"
      ],
      "maxGraphemes": 32,
      "type": "string"
    },
    "fatScore": {
      "description": "Subcutaneous fat deposit score (0-8 scale, birds).",
      "maxGraphemes": 8,
      "type": "string"
    },
    "forearmLength": {
      "description": "Forearm length in millimeters. Standard measurement for bats.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "forkLength": {
      "description": "Fork length (snout to fork of caudal fin) in millimeters (fish).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "geneticSampleId": {
      "description": "Identifier of tissue, hair, or feather sample collected for genetic analysis.",
      "maxGraphemes": 128,
      "type": "string"
    },
    "groupSize": {
      "description": "Total size of social group observed (herd, flock, pod, colony).",
      "minimum": 1,
      "type": "integer"
    },
    "headBodyLength": {
      "description": "Head-body length excluding tail in millimeters.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "hindFootLength": {
      "description": "Hind foot length in millimeters (mammals).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "injuryDescription": {
      "description": "Description of injuries (scars, wounds, missing limbs, broken wing).",
      "maxGraphemes": 512,
      "type": "string"
    },
    "injuryPresent": {
      "description": "Whether visible injuries exist.",
      "type": "boolean"
    },
    "litterSize": {
      "description": "Number of offspring in litter (mammals).",
      "minimum": 0,
      "type": "integer"
    },
    "markDescription": {
      "description": "Description of natural marks, scars, or unique identifying features.",
      "maxGraphemes": 512,
      "type": "string"
    },
    "nestHeight": {
      "description": "Height of nest above ground in meters.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "pectoralMuscleScore": {
      "description": "Pectoral muscle score (0-3 scale, birds).",
      "maxGraphemes": 8,
      "type": "string"
    },
    "pitTagId": {
      "description": "Passive Integrated Transponder (microchip) number.",
      "maxGraphemes": 128,
      "type": "string"
    },
    "recaptureStatus": {
      "description": "Whether this is a new capture or recapture.",
      "knownValues": [
        "new",
        "recapture",
        "unknown"
      ],
      "maxGraphemes": 16,
      "type": "string"
    },
    "shoulderHeight": {
      "description": "Height at shoulder in millimeters (large mammals).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "snoutVentLength": {
      "description": "Snout-vent length (SVL) in millimeters. Standard body measurement for reptiles and amphibians.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "standardLength": {
      "description": "Standard length (snout to caudal fin base) in millimeters (fish).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "tagId": {
      "description": "Ear tag, flipper tag, fin tag, or wing tag identifier.",
      "maxGraphemes": 128,
      "type": "string"
    },
    "tagType": {
      "description": "Type of tag or mark applied.",
      "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"
      ],
      "maxGraphemes": 64,
      "type": "string"
    },
    "tailLength": {
      "description": "Tail length in millimeters.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "tarsusLength": {
      "description": "Tarsometatarsus length in millimeters (birds).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "totalLength": {
      "description": "Total body length in millimeters (tip of snout/bill to tail tip).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "wingLength": {
      "description": "Flattened wing chord length in millimeters (birds).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "wingspan": {
      "description": "Full wingspan tip-to-tip in millimeters (birds, bats).",
      "maxGraphemes": 32,
      "type": "string"
    }
  },
  "type": "object"
}
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 Optional

Estimated aboveground biomass in kilograms, derived from allometric equations.

maxGraphemes: 32 graphemes
additionalMeasurements array of ref#measurementEntry Optional

Additional measurements not covered by the typed fields above.

maxLength: 50 items
annualDiameterIncrement string Optional

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

maxGraphemes: 32 graphemes
basalArea string Optional

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

maxGraphemes: 32 graphemes
basalDiameter string Optional

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

maxGraphemes: 32 graphemes
belowgroundBiomass string Optional

Estimated belowground (root) biomass in kilograms.

maxGraphemes: 32 graphemes
biomassAllometricEquation string Optional

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

maxGraphemes: 512 graphemes
bleachingStatus string Optional

Coral bleaching status.

maxGraphemes: 32 graphemes
Known values: none, pale, partially-bleached, fully-bleached, recently-dead
buttressHeight string Optional

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

maxGraphemes: 32 graphemes
canopyCoverPercent string Optional

Percentage of ground covered by the canopy of this individual.

maxGraphemes: 16 graphemes
carbonContent string Optional

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

maxGraphemes: 32 graphemes
colonyDiameter string Optional

Maximum colony diameter in centimeters (corals, sponges).

maxGraphemes: 32 graphemes
colonyHeight string Optional

Height of colony from base to apex in centimeters.

maxGraphemes: 32 graphemes
colonyMorphology string Optional

Colony growth form.

maxGraphemes: 64 graphemes
Known values: massive, branching, encrusting, foliose, tabular, columnar, free-living, other
crownDepth string Optional

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

maxGraphemes: 32 graphemes
crownDiameter string Optional

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

maxGraphemes: 32 graphemes
crownDieback string Optional

Percentage of crown showing dieback.

maxGraphemes: 16 graphemes
crownPosition string Optional

Canopy position relative to neighbors.

maxGraphemes: 32 graphemes
Known values: dominant, codominant, intermediate, suppressed, emergent
damageCause string Optional

Cause of damage.

maxGraphemes: 128 graphemes
Known values: wind, lightning, fire, drought, flood, animal, human, disease, pest, unknown, other
damageType string Optional

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

maxGraphemes: 256 graphemes
dbh string Optional

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

maxGraphemes: 32 graphemes
dbhMeasurementHeight string Optional

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

maxGraphemes: 32 graphemes
decayClass string Optional

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

maxGraphemes: 8 graphemes
depthBelowSurface string Optional

Depth of the organism below water surface in meters.

maxGraphemes: 32 graphemes
estimatedAge string Optional

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

maxGraphemes: 32 graphemes
floweringStatus string Optional

Current flowering/reproductive state.

maxGraphemes: 32 graphemes
Known values: none, budding, flowering, fruiting, senescing
girth string Optional

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

maxGraphemes: 32 graphemes
growthForm string Optional

Growth form classification of the organism.

maxGraphemes: 64 graphemes
Known values: tree, shrub, liana, palm, tree-fern, herb, grass, bamboo, epiphyte, succulent, mangrove, other
healthScore string Optional

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

maxGraphemes: 16 graphemes
heightMeasurementMethod string Optional

Method used for height measurement.

maxGraphemes: 128 graphemes
Known values: clinometer, laser-rangefinder, hypsometer, direct-pole, estimated, drone-photogrammetry, lidar, other
heightToFirstBranch string Optional

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

maxGraphemes: 32 graphemes
leafAreaIndex string Optional

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

maxGraphemes: 32 graphemes
liveTissueCoverPercent string Optional

Percentage of colony surface with live tissue.

maxGraphemes: 16 graphemes
phenology string Optional

Current phenological state.

maxGraphemes: 64 graphemes
Known values: leafless, flush, full-leaf, senescing, dormant
stemCount integer Optional

Number of stems for multi-stemmed individuals.

minimum: 1
totalHeight string Optional

Total height from ground to highest living point in meters.

maxGraphemes: 32 graphemes
vitalityStatus string Optional

Overall vitality status of the organism.

maxGraphemes: 32 graphemes
Known values: alive, dead-standing, dead-fallen, moribund, missing, unknown
woodDensity string Optional

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

maxGraphemes: 32 graphemes
View raw schema
{
  "description": "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": {
      "description": "Estimated aboveground biomass in kilograms, derived from allometric equations.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "additionalMeasurements": {
      "description": "Additional measurements not covered by the typed fields above.",
      "items": {
        "ref": "#measurementEntry",
        "type": "ref"
      },
      "maxLength": 50,
      "type": "array"
    },
    "annualDiameterIncrement": {
      "description": "Annual radial growth measured via dendrometer bands or core samples in millimeters per year.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "basalArea": {
      "description": "Cross-sectional area of trunk at breast height in square centimeters.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "basalDiameter": {
      "description": "Diameter at ground level or just above root flare in centimeters. Standard for shrubs and multi-stemmed plants.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "belowgroundBiomass": {
      "description": "Estimated belowground (root) biomass in kilograms.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "biomassAllometricEquation": {
      "description": "Reference to the allometric equation used for biomass estimation (e.g., 'Chave et al. 2014').",
      "maxGraphemes": 512,
      "type": "string"
    },
    "bleachingStatus": {
      "description": "Coral bleaching status.",
      "knownValues": [
        "none",
        "pale",
        "partially-bleached",
        "fully-bleached",
        "recently-dead"
      ],
      "maxGraphemes": 32,
      "type": "string"
    },
    "buttressHeight": {
      "description": "Height of buttress roots above ground in meters. Common in tropical trees.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "canopyCoverPercent": {
      "description": "Percentage of ground covered by the canopy of this individual.",
      "maxGraphemes": 16,
      "type": "string"
    },
    "carbonContent": {
      "description": "Estimated carbon stored in kilograms of carbon (typically 47-50% of dry biomass).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "colonyDiameter": {
      "description": "Maximum colony diameter in centimeters (corals, sponges).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "colonyHeight": {
      "description": "Height of colony from base to apex in centimeters.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "colonyMorphology": {
      "description": "Colony growth form.",
      "knownValues": [
        "massive",
        "branching",
        "encrusting",
        "foliose",
        "tabular",
        "columnar",
        "free-living",
        "other"
      ],
      "maxGraphemes": 64,
      "type": "string"
    },
    "crownDepth": {
      "description": "Vertical extent of crown in meters (total height minus height to crown base).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "crownDiameter": {
      "description": "Average crown diameter in meters (typically mean of multiple radial measurements).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "crownDieback": {
      "description": "Percentage of crown showing dieback.",
      "maxGraphemes": 16,
      "type": "string"
    },
    "crownPosition": {
      "description": "Canopy position relative to neighbors.",
      "knownValues": [
        "dominant",
        "codominant",
        "intermediate",
        "suppressed",
        "emergent"
      ],
      "maxGraphemes": 32,
      "type": "string"
    },
    "damageCause": {
      "description": "Cause of damage.",
      "knownValues": [
        "wind",
        "lightning",
        "fire",
        "drought",
        "flood",
        "animal",
        "human",
        "disease",
        "pest",
        "unknown",
        "other"
      ],
      "maxGraphemes": 128,
      "type": "string"
    },
    "damageType": {
      "description": "Type of damage observed (e.g., 'broken crown', 'leaning', 'uprooted', 'hollow', 'scarred', 'stripped bark').",
      "maxGraphemes": 256,
      "type": "string"
    },
    "dbh": {
      "description": "Diameter at breast height in centimeters. The core measurement in all tree inventories (ForestGEO, NFI, RAINFOR).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "dbhMeasurementHeight": {
      "description": "Height above ground where DBH was measured, in meters. Important when measured above buttress or irregularity. Default is 1.3m.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "decayClass": {
      "description": "Decay classification for dead trees (1-5 scale per ForestGEO/FIA protocols).",
      "maxGraphemes": 8,
      "type": "string"
    },
    "depthBelowSurface": {
      "description": "Depth of the organism below water surface in meters.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "estimatedAge": {
      "description": "Estimated age of the organism in years (from rings, radiocarbon, or allometry).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "floweringStatus": {
      "description": "Current flowering/reproductive state.",
      "knownValues": [
        "none",
        "budding",
        "flowering",
        "fruiting",
        "senescing"
      ],
      "maxGraphemes": 32,
      "type": "string"
    },
    "girth": {
      "description": "Circumference of trunk at breast height in centimeters. Alternative to DBH (convertible via pi).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "growthForm": {
      "description": "Growth form classification of the organism.",
      "knownValues": [
        "tree",
        "shrub",
        "liana",
        "palm",
        "tree-fern",
        "herb",
        "grass",
        "bamboo",
        "epiphyte",
        "succulent",
        "mangrove",
        "other"
      ],
      "maxGraphemes": 64,
      "type": "string"
    },
    "healthScore": {
      "description": "Numeric health or vigor score (protocol-dependent scale).",
      "maxGraphemes": 16,
      "type": "string"
    },
    "heightMeasurementMethod": {
      "description": "Method used for height measurement.",
      "knownValues": [
        "clinometer",
        "laser-rangefinder",
        "hypsometer",
        "direct-pole",
        "estimated",
        "drone-photogrammetry",
        "lidar",
        "other"
      ],
      "maxGraphemes": 128,
      "type": "string"
    },
    "heightToFirstBranch": {
      "description": "Height from ground to first major living branch (bole length) in meters.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "leafAreaIndex": {
      "description": "Leaf area index: total one-sided leaf area per unit ground area (m²/m²).",
      "maxGraphemes": 32,
      "type": "string"
    },
    "liveTissueCoverPercent": {
      "description": "Percentage of colony surface with live tissue.",
      "maxGraphemes": 16,
      "type": "string"
    },
    "phenology": {
      "description": "Current phenological state.",
      "knownValues": [
        "leafless",
        "flush",
        "full-leaf",
        "senescing",
        "dormant"
      ],
      "maxGraphemes": 64,
      "type": "string"
    },
    "stemCount": {
      "description": "Number of stems for multi-stemmed individuals.",
      "minimum": 1,
      "type": "integer"
    },
    "totalHeight": {
      "description": "Total height from ground to highest living point in meters.",
      "maxGraphemes": 32,
      "type": "string"
    },
    "vitalityStatus": {
      "description": "Overall vitality status of the organism.",
      "knownValues": [
        "alive",
        "dead-standing",
        "dead-fallen",
        "moribund",
        "missing",
        "unknown"
      ],
      "maxGraphemes": 32,
      "type": "string"
    },
    "woodDensity": {
      "description": "Specific gravity of wood (dry mass / green volume) in grams per cubic centimeter.",
      "maxGraphemes": 32,
      "type": "string"
    }
  },
  "type": "object"
}
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 array of ref#measurementEntry Required

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

maxLength: 100 items
View raw schema
{
  "description": "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": {
      "description": "Array of individual measurements, each with type, value, and optional unit.",
      "items": {
        "ref": "#measurementEntry",
        "type": "ref"
      },
      "maxLength": 100,
      "type": "array"
    }
  },
  "required": [
    "measurements"
  ],
  "type": "object"
}
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 Optional

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

maxGraphemes: 128 graphemes
measurementMethod string Optional

Method or instrument used to determine this specific measurement.

maxGraphemes: 512 graphemes
measurementRemarks string Optional

Notes about this specific measurement.

maxGraphemes: 1024 graphemes
measurementType string Required

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

maxGraphemes: 256 graphemes
measurementUnit string Optional

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

maxGraphemes: 64 graphemes
measurementValue string Required

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

maxGraphemes: 1024 graphemes
View raw schema
{
  "description": "A single measurement fact, aligned with one row of the Darwin Core MeasurementOrFact extension. Used in additionalMeasurements arrays and in genericMeasurement.",
  "properties": {
    "measurementAccuracy": {
      "description": "Potential error (e.g., '0.5 cm', '5%').",
      "maxGraphemes": 128,
      "type": "string"
    },
    "measurementMethod": {
      "description": "Method or instrument used to determine this specific measurement.",
      "maxGraphemes": 512,
      "type": "string"
    },
    "measurementRemarks": {
      "description": "Notes about this specific measurement.",
      "maxGraphemes": 1024,
      "type": "string"
    },
    "measurementType": {
      "description": "The nature of the measurement (e.g., 'DBH', 'tree height', 'canopy cover', 'tail length', 'soil pH').",
      "maxGraphemes": 256,
      "type": "string"
    },
    "measurementUnit": {
      "description": "The units for the value (e.g., 'cm', 'm', 'kg', '%', 'degrees Celsius').",
      "maxGraphemes": 64,
      "type": "string"
    },
    "measurementValue": {
      "description": "The value of the measurement (e.g., '45.2', 'present', 'blue').",
      "maxGraphemes": 1024,
      "type": "string"
    }
  },
  "required": [
    "measurementType",
    "measurementValue"
  ],
  "type": "object"
}

Lexicon Garden

@