Slot: Provenance Chain Steps (provenance_chain_steps)

Ordered list of upstream ToolRuns, from oldest to most recent, whose outputs were inputs to this run.

Tier: recommended

Why this slot matters

A value like a daily temperature is usually the end of several runs (geocode, then extract); without the ordered steps a consumer can verify only the last hop, and any upstream error is invisible. The chain lets anyone walk the full derivation back to its root.

In plain terms

A step-by-step history of every program run that led to this data, oldest first — like a parcel's tracking history showing each station it passed through on the way to you.

URI: envar:slot/provenance_chain_steps

Applicable Classes

Name	Description	Modifies Slot
ProvenanceChain	The ordered list of all upstream `ToolRun`s whose outputs were inputs to this...	no

Properties

Type and Range

Property	Value
Range	ToolRun
Domain Of	ProvenanceChain

Cardinality and Requirements

Property	Value
Multivalued	Yes

Examples

Value
None

Identifier and Mapping Information

Annotations

property	value
tier	recommended
justification	A value like a daily temperature is usually the end of several runs (geocode, then extract); without the ordered steps a consumer can verify only the last hop, and any upstream error is invisible. The chain lets anyone walk the full derivation back to its root.
explanation	A step-by-step history of every program run that led to this data, oldest first — like a parcel's tracking history showing each station it passed through on the way to you.
covered_by	None

Schema Source

from schema: https://w3id.org/linkml/microschemas/envar

Mappings

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

LinkML Source

name: provenance_chain_steps
annotations:
  tier:
    tag: tier
    value: recommended
  justification:
    tag: justification
    value: A value like a daily temperature is usually the end of several runs (geocode,
      then extract); without the ordered steps a consumer can verify only the last
      hop, and any upstream error is invisible. The chain lets anyone walk the full
      derivation back to its root.
  explanation:
    tag: explanation
    value: A step-by-step history of every program run that led to this data, oldest
      first — like a parcel's tracking history showing each station it passed through
      on the way to you.
  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
              (SQL NOTICE lines)
          note:
            tag: note
            value: 'Gaia''s ETL descriptor plus the spatial-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 on its native outputs.
      amadeus:
        tag: amadeus
        annotations:
          extent:
            tag: extent
            value: absent
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: no column
          note:
            tag: note
            value: No native Amadeus file records an ordered upstream-run chain.
      cher:
        tag: cher
        annotations:
          extent:
            tag: extent
            value: partial
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: dataset_lineage table (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 tool chain.
      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 list of upstream `ToolRun`s, from oldest to most recent, whose
  outputs were inputs to this run.
title: Provenance Chain Steps
examples:
- description: a single upstream geocoding step preceding the daymet run
  object:
    tool_name: geocoder
    tool_version: 3.3.0
    run_timestamp_utc: '2026-05-23T14:02:11Z'
    output_file_sha256: 5b6c7d8e9f0a...
from_schema: https://w3id.org/linkml/microschemas/envar
see_also:
- https://www.w3.org/TR/prov-o/
rank: 1000
domain_of:
- ProvenanceChain
range: ToolRun
multivalued: true
inlined: true
inlined_as_list: true