Skip to content

Slot: Source Dataset Temporal Coverage (source_dataset_temporal_coverage)

Source product temporal coverage as an ISO 8601 interval string <start>/<end>.

Tier: recommended

Why this slot matters

Knowing the product's full time span distinguishes "date outside the product's coverage" from "value genuinely missing", preventing coverage gaps from being misread as data errors.

In plain terms

Simply the first and last dates the dataset covers. If you ask for a day outside that window, there was never any data to find — which is different from data that should exist but is missing.

URI: envar:slot/source_dataset_temporal_coverage

Applicable Classes

Name Description Modifies Slot
SourceDataset The upstream gridded / station product the exposure values originate from no

Properties

Type and Range

Property Value
Range String
Domain Of SourceDataset

Cardinality and Requirements

Property Value

Examples

Value
1980-01-01/2024-12-31

See Also

Identifier and Mapping Information

Annotations

property value
tier recommended
justification Knowing the product's full time span distinguishes "date outside the product's coverage" from "value genuinely missing", preventing coverage gaps from being misread as data errors.
explanation Simply the first and last dates the dataset covers. If you ask for a day outside that window, there was never any data to find — which is different from data that should exist but is missing.
covered_by None

Schema Source

Mappings

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

LinkML Source

name: source_dataset_temporal_coverage
annotations:
  tier:
    tag: tier
    value: recommended
  justification:
    tag: justification
    value: Knowing the product's full time span distinguishes "date outside the product's
      coverage" from "value genuinely missing", preventing coverage gaps from being
      misread as data errors.
  explanation:
    tag: explanation
    value: Simply the first and last dates the dataset covers. If you ask for a day
      outside that window, there was never any data to find — which is different from
      data that should exist but is missing.
  covered_by:
    tag: covered_by
    annotations:
      omop_gaia:
        tag: omop_gaia
        annotations:
          extent:
            tag: extent
            value: full
          status:
            tag: status
            value: verified
          where:
            tag: where
            value: meta_dcat_*.json dct:temporal; gaia_db variable_source.start_date/end_date
          evidence:
            tag: evidence
            value: EnVar/examples/heat/COMPARISON.md §H (Dataset time-span — ✅ OMOP/GAIA)
          note:
            tag: note
            value: GAIA carries the product time span in DCAT dct:temporal and the
              variable_source start/end dates.
      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 carries no dataset time-span.
      amadeus:
        tag: amadeus
        annotations:
          extent:
            tag: extent
            value: full
          status:
            tag: status
            value: verified
          where:
            tag: where
            value: thredds_dataset.xml TimeSpan
          evidence:
            tag: evidence
            value: EnVar/examples/heat/COMPARISON.md §H (Dataset time-span — ✅ Amadeus,
              TimeSpan 1979→present)
          note:
            tag: note
            value: Amadeus records the full dataset time span in the THREDDS dataset.xml
              TimeSpan element.
      cher:
        tag: cher
        annotations:
          extent:
            tag: extent
            value: full
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: table_dictionary temporal_extent (YYYYMMDDYYYYMMDD in table_name)
          note:
            tag: note
            value: C-HER carries temporal extent as a start+end date pair in the reproducible
              table_name (§2.4).
      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: Product temporal coverage is a discovery-layer concern above the
              DDI-CDI InstanceVariable layer CODATA scores.
description: Source product temporal coverage as an ISO 8601 interval string `<start>/<end>`.
title: Source Dataset Temporal Coverage
examples:
- value: 1980-01-01/2024-12-31
from_schema: https://w3id.org/linkml/microschemas/envar
see_also:
- https://en.wikipedia.org/wiki/ISO_8601
rank: 1000
domain_of:
- SourceDataset
range: string