Slot: Spatial Aggregation Preserved Quantity (spatial_aggregation_preserves)
What quantity the spatial-aggregation operator is meant to preserve when a value on a source spatial support is re-expressed on the target support — not the mechanics of the operator (that is extraction_method), but the invariant it holds fixed (mean intensity, total mass, occurrence density, or areal coverage).
Tier: recommended
Why this slot matters
Recording what quantity the operator preserves — not just the operator name — is what makes two datasets' spatial values comparable and poolable: an area-weighted mean and a mass-conserving allocation applied to the same input give different numbers, and only the preserved-quantity tag tells a downstream analyst which one a value is, so two supports can be reconciled rather than silently mixed.
In plain terms
Turning map data measured on one set of shapes into values on another set of shapes can aim to keep different things unchanged — the average level of something, the total amount of it, how densely it occurs, or how much of an area it covers. This records which of those the conversion was designed to keep true, because the same input handled two different ways produces two different numbers.
URI: envar:slot/spatial_aggregation_preserves
Applicable Classes
| Name |
Description |
Modifies Slot |
| SpatialReference |
Spatial provenance of an environmental exposure value: the native grid / foot... |
no |
Properties
Type and Range
Cardinality and Requirements
Examples
| Value |
| mean_intensity |
| total_mass_conservation |
Annotations
| property |
value |
| tier |
recommended |
| justification |
Recording what quantity the operator preserves — not just the operator name — is what makes two datasets' spatial values comparable and poolable: an area-weighted mean and a mass-conserving allocation applied to the same input give different numbers, and only the preserved-quantity tag tells a downstream analyst which one a value is, so two supports can be reconciled rather than silently mixed. |
| explanation |
Turning map data measured on one set of shapes into values on another set of shapes can aim to keep different things unchanged — the average level of something, the total amount of it, how densely it occurs, or how much of an area it covers. This records which of those the conversion was designed to keep true, because the same input handled two different ways produces two different numbers. |
| covered_by |
None |
Schema Source
Mappings
| Mapping Type |
Mapped Value |
| self |
envar:spatial_aggregation_preserves |
| native |
envar:spatial_aggregation_preserves |
LinkML Source
name: spatial_aggregation_preserves
annotations:
tier:
tag: tier
value: recommended
justification:
tag: justification
value: 'Recording *what quantity the operator preserves* — not just the operator
name — is what makes two datasets'' spatial values comparable and poolable:
an area-weighted mean and a mass-conserving allocation applied to the same input
give different numbers, and only the preserved-quantity tag tells a downstream
analyst which one a value is, so two supports can be reconciled rather than
silently mixed.'
explanation:
tag: explanation
value: Turning map data measured on one set of shapes into values on another set
of shapes can aim to keep different things unchanged — the average level of
something, the total amount of it, how densely it occurs, or how much of an
area it covers. This records which of those the conversion was designed to keep
true, because the same input handled two different ways produces two different
numbers.
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: No preserved-quantity slot in gaiaCatalog or gaia-db; the invariant
an aggregation holds fixed 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 does point extraction only and records no aggregation-preservation
semantics.
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 no preserved-quantity of any spatial aggregation.
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 captures resolution and data-level but not which quantity
a re-gridding operator preserves.
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 preserved quantity of an aggregation is instance-layer methodological
detail outside the conceptual EV/DDI-CDI layer.
description: What quantity the spatial-aggregation operator is meant to *preserve*
when a value on a source spatial support is re-expressed on the target support —
not the mechanics of the operator (that is `extraction_method`), but the invariant
it holds fixed (mean intensity, total mass, occurrence density, or areal coverage).
title: Spatial Aggregation Preserved Quantity
examples:
- value: mean_intensity
description: area-weighted interpolation of a modeled concentration preserves the
area-mean intensity (tract-to-hex concentration case)
- value: total_mass_conservation
description: population-weighted / area-proportional allocation of a count preserves
the total (population-count case)
from_schema: https://w3id.org/linkml/microschemas/envar
rank: 1000
domain_of:
- SpatialReference
range: SpatialAggregationPreservationEnum