Slot: Spatial Reference (spatial_reference)

Spatial reference object describing the native grid and extraction. Bound to SpatialReference (see envar_spatial). Readable rename of the profile's location anatomy slot.

Tier: core

Why this slot matters

A value without its grid, coordinate system, and extraction method cannot be located or compared: a 1 km neighbourhood average and a ~31 km regional average look identical as numbers but describe very different exposures, and the extraction cannot be re-run without the method.

In plain terms

This block says where the number applies and how it was pulled out of a map. Environmental data usually comes as a grid of cells covering a region; this records how big those cells are and how the value for a specific place was picked from them.

URI: envar:slot/spatial_reference

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	SpatialReference
Domain Of	EnvironmentalExposureRecord
Slot Group	exposure_description

Cardinality and Requirements

Property	Value
Required	Yes

Aliases

location

Examples

Value
None

Identifier and Mapping Information

Annotations

property	value
tier	core
justification	A value without its grid, coordinate system, and extraction method cannot be located or compared: a 1 km neighbourhood average and a ~31 km regional average look identical as numbers but describe very different exposures, and the extraction cannot be re-run without the method.
explanation	This block says where the number applies and how it was pulled out of a map. Environmental data usually comes as a grid of cells covering a region; this records how big those cells are and how the value for a specific place was picked from them.
covered_by	None

Schema Source

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

Mappings

Mapping Type	Mapped Value
self	envar:spatial_reference
native	envar:spatial_reference
exact	msprofile:location

LinkML Source

name: spatial_reference
implements:
- msprofile:location
annotations:
  tier:
    tag: tier
    value: core
  justification:
    tag: justification
    value: 'A value without its grid, coordinate system, and extraction method cannot
      be located or compared: a 1 km neighbourhood average and a ~31 km regional average
      look identical as numbers but describe very different exposures, and the extraction
      cannot be re-run without the method.'
  explanation:
    tag: explanation
    value: This block says where the number applies and how it was pulled out of a
      map. Environmental data usually comes as a grid of cells covering a region;
      this records how big those cells are and how the value for a specific place
      was picked from them.
  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 location.geom EPSG:4326 / data_source.srid; meta_etl_*.json
              epsg / extent; data_source.spatial_coverage
          note:
            tag: note
            value: 'Gaia carries CRS/SRID and dataset spatial coverage, but has no
              first-class native-resolution or extraction-method slot. Conservative:
              partial.'
      degauss:
        tag: degauss
        annotations:
          extent:
            tag: extent
            value: partial
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: lat / lon columns on the geocoded CSV (implicit WGS84)
          note:
            tag: note
            value: DeGAUSS carries coordinates but no explicit CRS, native resolution,
              or extraction method.
      amadeus:
        tag: amadeus
        annotations:
          extent:
            tag: extent
            value: partial
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: thredds_dataset.xml coordinate_system=WGS84,EPSG:4326 + axis lat/lon
              increment + projectionBox/LatLonBox
          note:
            tag: note
            value: 'Amadeus declares source-raster CRS and bbox and grid increment,
              but no extraction-method slot and resolution is only derivable. Conservative:
              partial.'
      cher:
        tag: cher
        annotations:
          extent:
            tag: extent
            value: partial
          status:
            tag: status
            value: asserted
          where:
            tag: where
            value: table_name spatial extent + spatial resolution codes (e.g. h08
              / k05 / m30); column_tag Spatial-Primary
          note:
            tag: note
            value: 'C-HER encodes spatial extent and organisation resolution in the
              table_name and tags spatial columns, but carries no per-value extraction
              method or CRS field. 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: Extraction geometry is instance-layer; out of scope for CODATA's
              conceptual framework.
description: Spatial reference object describing the native grid and extraction. Bound
  to SpatialReference (see envar_spatial). Readable rename of the profile's `location`
  anatomy slot.
title: Spatial Reference
examples:
- description: abridged — see tests/data/valid/EnvironmentalExposureRecord-tmax_ideal.yaml
    for a full instance
  object:
    native_spatial_resolution_m: 1000
    crs: EPSG:4326
    extraction_method: inverse_distance_weighted_4_nearest_cells
    target_geography_type: point_residence
from_schema: https://w3id.org/linkml/microschemas/envar
see_also:
- https://epsg.io/
aliases:
- location
exact_mappings:
- msprofile:location
rank: 1000
domain_of:
- EnvironmentalExposureRecord
slot_group: exposure_description
range: SpatialReference
required: true
inlined: true