Slot: Extraction Window Start (extraction_window_start)

Actual start date the run extracted.

Tier: recommended

Why this slot matters

Records the dates this run actually pulled, as opposed to what the product offers; without it a reproducer cannot re-request the same slice, and a lag analysis cannot verify that the pre-event days (e.g. the day before the index date) were actually in the extract.

In plain terms

Of everything the dataset covers, this is the first date this particular job actually downloaded — like noting which pages of a big book you photocopied.

URI: envar:slot/extraction_window_start

Applicable Classes

Name	Description	Modifies Slot
TemporalReference	Temporal provenance of an environmental exposure value: native temporal grain...	no

Properties

Type and Range

Property	Value
Range	Date
Domain Of	TemporalReference

Cardinality and Requirements

Property	Value

Examples

Value
2022-07-18

Identifier and Mapping Information

Annotations

property	value
tier	recommended
justification	Records the dates this run actually pulled, as opposed to what the product offers; without it a reproducer cannot re-request the same slice, and a lag analysis cannot verify that the pre-event days (e.g. the day before the index date) were actually in the extract.
explanation	Of everything the dataset covers, this is the first date this particular job actually downloaded — like noting which pages of a big book you photocopied.
covered_by	None

Schema Source

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

Mappings

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

LinkML Source

name: extraction_window_start
annotations:
  tier:
    tag: tier
    value: recommended
  justification:
    tag: justification
    value: Records the dates this run actually pulled, as opposed to what the product
      offers; without it a reproducer cannot re-request the same slice, and a lag
      analysis cannot verify that the pre-event days (e.g. the day before the index
      date) were actually in the extract.
  explanation:
    tag: explanation
    value: Of everything the dataset covers, this is the first date this particular
      job actually downloaded — like noting which pages of a big book you photocopied.
  covered_by:
    tag: covered_by
    annotations:
      omop_gaia:
        tag: omop_gaia
        annotations:
          extent:
            tag: extent
            value: absent
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: no column
          note:
            tag: note
            value: gaia-native output collapses per-day to the variable's window-wide
              validity range; the run's actual extraction window start is not recorded.
      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 writes per-day rows but records no explicit run extraction-window-start
              field.
      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 records the product TimeSpan but not the start date this
              particular run pulled.
      cher:
        tag: cher
        annotations:
          extent:
            tag: extent
            value: absent
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: no column
          note:
            tag: note
            value: C-HER's temporal_extent is the dataset's coverage span, not the
              window an individual extraction job pulled.
      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: The window a specific run pulled is instance-layer provenance outside
              the conceptual EV/DDI-CDI layer.
description: Actual start date the run extracted.
title: Extraction Window Start
examples:
- value: '2022-07-18'
  description: Day before the Phoenix index date, for lag analysis.
from_schema: https://w3id.org/linkml/microschemas/envar
rank: 1000
domain_of:
- TemporalReference
range: date