Skip to content

Slot: Target Concept Identifier (target_concept_id)

Concept identifier for the variable in the vocabulary named by target_concept_vocabulary (e.g. an OHDSI concept_id). Nullable with reason for environmental variables that lack coverage today.

Tier: recommended

Why this slot matters

This is the hook that lets the environmental value land in a health database as a recognised concept. Recording it — or its documented absence — shows whether the vocabulary binding was attempted and against what, instead of leaving the linkage silent and unreproducible.

In plain terms

Health databases store everything under numeric codes from a shared catalogue. This is that code for the environmental measurement, when one exists, so the exposure value can sit alongside clinical data under an identifier the database already knows.

URI: envar:slot/target_concept_id

Applicable Classes

Name Description Modifies Slot
VariableIdentity The identity and semantics of an environmental exposure variable — what physi... no

Properties

Type and Range

Property Value
Range String
Domain Of VariableIdentity

Cardinality and Requirements

Property Value

Examples

Value
2005200123

See Also

Identifier and Mapping Information

Annotations

property value
tier recommended
justification This is the hook that lets the environmental value land in a health database as a recognised concept. Recording it — or its documented absence — shows whether the vocabulary binding was attempted and against what, instead of leaving the linkage silent and unreproducible.
explanation Health databases store everything under numeric codes from a shared catalogue. This is that code for the environmental measurement, when one exists, so the exposure value can sit alongside clinical data under an identifier the database already knows.
covered_by None

Schema Source

Mappings

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

LinkML Source

name: target_concept_id
annotations:
  tier:
    tag: tier
    value: recommended
  justification:
    tag: justification
    value: This is the hook that lets the environmental value land in a health database
      as a recognised concept. Recording it — or its documented absence — shows whether
      the vocabulary binding was attempted and against what, instead of leaving the
      linkage silent and unreproducible.
  explanation:
    tag: explanation
    value: Health databases store everything under numeric codes from a shared catalogue.
      This is that code for the environmental measurement, when one exists, so the
      exposure value can sit alongside clinical data under an identifier the database
      already knows.
  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: external_exposure.exposure_concept_id (placeholder concept present)
              + exposure_type_concept_id 32885
          evidence:
            tag: evidence
            value: EnVar/examples/heat/COMPARISON.md §D (Exposure concept / variable
              identity — ✅ for GAIA)
          note:
            tag: note
            value: GAIA fills the concept-id slot even though no real OMOP concept
              is yet minted for daily-max-air-temperature; the binding exists.
      degauss:
        tag: degauss
        annotations:
          extent:
            tag: extent
            value: absent
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: no column
          note:
            tag: note
            value: No concept-id column in DeGAUSS output.
      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 concept-id column in Amadeus output.
      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 binds no downstream concept id for the variable; only planned
              ontology tags on columns (§8).
      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: A concrete concept id in a target vocabulary is instance-layer;
              CODATA names the concept, not this run's downstream id.
description: Concept identifier for the variable in the vocabulary named by `target_concept_vocabulary`
  (e.g. an OHDSI concept_id). Nullable with reason for environmental variables that
  lack coverage today.
title: Target Concept Identifier
examples:
- value: '2005200123'
  description: illustrative OHDSI concept_id; in the canonical Tmax and PM2.5 scenarios
    this slot is null with a missing reason
from_schema: https://w3id.org/linkml/microschemas/envar
see_also:
- https://athena.ohdsi.org/
rank: 1000
domain_of:
- VariableIdentity
range: string