Skip to content

Slot: Provenance Chain (provenance_chain)

Ordered W3C-PROV-style chain of upstream tool runs — see envar_toolrun. Recommended (not required): a record is reproducible in principle without the full chain, but real reproduction needs it.

Tier: recommended

Why this slot matters

The final tool run is rarely the whole story — downloads, geocoding, and intermediate transforms precede it; without the ordered chain back to the raw source, end-to-end reproduction and error tracing are impossible even when the last step is pinned.

In plain terms

Data usually passes through several tools before the final value appears — download, geocode, extract. This block lists those earlier steps in order, like a chain of custody reaching back to the original raw source.

URI: envar:slot/provenance_chain

Applicable Classes

Name Description Modifies Slot
EnvironmentalExposureRecord A single environmental-exposure record sidecar: the complete metadata graph t... no
DailyMaxTemperatureRecord Canonical record for daily maximum 2 m air temperature (Tmax) no
DailyMinTemperatureRecord Canonical record for daily minimum 2 m air temperature (Tmin) no
WetBulbGlobeTemperatureOutdoorRecord Canonical record for outdoor WBGT under the Liljegren 2008 formulation no
ExtremeHeatDayFlagRecord Canonical record for a daily binary extreme-heat-day flag, defined against a ... no

Properties

Type and Range

Property Value
Range ProvenanceChain
Domain Of EnvironmentalExposureRecord
Slot Group dataset_and_provenance

Cardinality and Requirements

Property Value

Examples

Value
None

See Also

Identifier and Mapping Information

Annotations

property value
tier recommended
justification The final tool run is rarely the whole story — downloads, geocoding, and intermediate transforms precede it; without the ordered chain back to the raw source, end-to-end reproduction and error tracing are impossible even when the last step is pinned.
explanation Data usually passes through several tools before the final value appears — download, geocode, extract. This block lists those earlier steps in order, like a chain of custody reaching back to the original raw source.
covered_by None

Schema Source

Mappings

Mapping Type Mapped Value
self envar:provenance_chain
native envar:provenance_chain

LinkML Source

name: provenance_chain
annotations:
  tier:
    tag: tier
    value: recommended
  justification:
    tag: justification
    value: The final tool run is rarely the whole story — downloads, geocoding, and
      intermediate transforms precede it; without the ordered chain back to the raw
      source, end-to-end reproduction and error tracing are impossible even when the
      last step is pinned.
  explanation:
    tag: explanation
    value: Data usually passes through several tools before the final value appears
      — download, geocode, extract. This block lists those earlier steps in order,
      like a chain of custody reaching back to the original raw source.
  covered_by:
    tag: covered_by
    annotations:
      omop_gaia:
        tag: omop_gaia
        annotations:
          extent:
            tag: extent
            value: partial
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: gaia_catalog/meta_etl_*.json (ETL recipe) + gaia_db/spatial_join_log.txt
          note:
            tag: note
            value: 'Gaia''s ETL descriptor plus join log capture upstream steps but
              not as an ordered per-run W3C-PROV chain. Conservative: partial.'
      degauss:
        tag: degauss
        annotations:
          extent:
            tag: extent
            value: absent
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: no column
          note:
            tag: note
            value: DeGAUSS emits no ordered upstream-run chain.
      amadeus:
        tag: amadeus
        annotations:
          extent:
            tag: extent
            value: absent
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: no column
          note:
            tag: note
            value: Amadeus emits no ordered upstream-run chain.
      cher:
        tag: cher
        annotations:
          extent:
            tag: extent
            value: partial
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: dataset_lineage (parent-child links) + lineage_notes
          note:
            tag: note
            value: 'C-HER''s dataset_lineage links parent and child resources, but
              is a dataset-lineage graph, not an ordered per-run W3C-PROV chain. Conservative:
              partial.'
      codata:
        tag: codata
        annotations:
          extent:
            tag: extent
            value: out_of_layer
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: no column
          note:
            tag: note
            value: Ordered tool-run provenance is instance-layer; out of scope for
              CODATA.
description: 'Ordered W3C-PROV-style chain of upstream tool runs — see envar_toolrun.
  Recommended (not required): a record is reproducible in principle without the full
  chain, but real reproduction needs it.'
title: Provenance Chain
examples:
- description: abridged — see tests/data/valid/EnvironmentalExposureRecord-tmax_ideal.yaml
    for a full instance
  object:
    provenance_chain_terminus_type: raw_source_download
    provenance_chain_steps:
    - tool_name: geocoder
      tool_version: 3.3.0
      run_timestamp_utc: '2026-05-23T14:02:11Z'
from_schema: https://w3id.org/linkml/microschemas/envar
see_also:
- https://www.w3.org/TR/prov-o/
rank: 1000
domain_of:
- EnvironmentalExposureRecord
slot_group: dataset_and_provenance
range: ProvenanceChain
inlined: true