Slot: Tool Run (tool_run)

The current ToolRun — see envar_toolrun.

Tier: core

Why this slot matters

Without the exact tool name, version, container image, parameters, and timestamp, the record cannot be re-run: "we used the daymet tool" is not reproducible, but a pinned container invocation is.

In plain terms

This block is the receipt for the software step that produced the values: which program ran, which exact version, with what settings, and when. With it, someone else can re-run the same step and get the same numbers.

URI: envar:slot/tool_run

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	ToolRun
Domain Of	EnvironmentalExposureRecord
Slot Group	dataset_and_provenance

Cardinality and Requirements

Property	Value
Required	Yes

Examples

Value
None

Identifier and Mapping Information

Annotations

property	value
tier	core
justification	Without the exact tool name, version, container image, parameters, and timestamp, the record cannot be re-run: "we used the daymet tool" is not reproducible, but a pinned container invocation is.
explanation	This block is the receipt for the software step that produced the values: which program ran, which exact version, with what settings, and when. With it, someone else can re-run the same step and get the same numbers.
covered_by	None

Schema Source

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

Mappings

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

LinkML Source

name: tool_run
annotations:
  tier:
    tag: tier
    value: core
  justification:
    tag: justification
    value: 'Without the exact tool name, version, container image, parameters, and
      timestamp, the record cannot be re-run: "we used the daymet tool" is not reproducible,
      but a pinned container invocation is.'
  explanation:
    tag: explanation
    value: 'This block is the receipt for the software step that produced the values:
      which program ran, which exact version, with what settings, and when. With it,
      someone else can re-run the same step and get the same numbers.'
  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_db data_source.created_at/updated_at (load time); spatial_join_log.txt
              (SQL functions)
          note:
            tag: note
            value: 'Gaia carries per-row load times and a join log, but no tool name/version,
              container digest, run args, or hashes. Conservative: partial.'
      degauss:
        tag: degauss
        annotations:
          extent:
            tag: extent
            value: partial
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: output filename tool name + container image tag (e.g. daymet_1.0.0);
              ghcr.io/degauss-org/... reference
          note:
            tag: note
            value: 'DeGAUSS pins tool name and version via the filename/container
              tag, but no digest, run args, timestamp, or hashes. Conservative: partial.'
      amadeus:
        tag: amadeus
        annotations:
          extent:
            tag: extent
            value: partial
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: thredds_response_headers.json HTTP Date header (run timestamp only)
          note:
            tag: note
            value: 'Amadeus records only the HTTP Date header; no tool name/version,
              container, run args, or hashes natively. Conservative: partial.'
      cher:
        tag: cher
        annotations:
          extent:
            tag: extent
            value: partial
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: table_dictionary.metadata_created_at/updated_at + uploaded_by +
              version
          note:
            tag: note
            value: 'C-HER records registration time, uploader, and version, but no
              per-run producing-tool name/version, container digest, args, or hashes.
              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: Tool-run provenance is instance-layer; out of scope for CODATA.
description: The current ToolRun — see envar_toolrun.
title: Tool Run
examples:
- description: abridged — see tests/data/valid/EnvironmentalExposureRecord-tmax_ideal.yaml
    for a full instance
  object:
    tool_name: daymet
    tool_version: 1.0.0
    container_image_repository: ghcr.io/degauss-org/daymet
    run_timestamp_utc: '2026-05-23T14:18:42Z'
from_schema: https://w3id.org/linkml/microschemas/envar
rank: 1000
domain_of:
- EnvironmentalExposureRecord
slot_group: dataset_and_provenance
range: ToolRun
required: true
inlined: true