glam/schemas/20251121/linkml/modules/classes/EnvironmentalZone.yaml
kempersc 4319f38c05 Add archived slots for audience size, audience type, and capacity metrics
- Created new YAML files for audience size and audience type slots, defining their properties and annotations.
- Added archived capacity slots including cubic meters, linear meters, item count, and descriptions, with appropriate URIs and ranges.
- Introduced a template specificity slot for context-aware RAG filtering.
- Consolidated capacity-related slots into a unified structure, including has_or_had_capacity, capacity_type, and capacity_value, with detailed descriptions and examples.
2026-01-17 18:53:23 +01:00

330 lines
13 KiB
YAML

id: https://nde.nl/ontology/hc/class/EnvironmentalZone
name: environmental_zone_class
title: Environmental Zone Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
sosa: http://www.w3.org/ns/sosa/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
wd: http://www.wikidata.org/entity/
aat: http://vocab.getty.edu/aat/
default_prefix: hc
imports:
- linkml:types
- ./Storage
- ./StorageConditionPolicy
- ./StorageCondition
- ./EnvironmentalZoneType
- ./EnvironmentalZoneTypes
# REMOVED 2026-01-16: temperature_tolerance - migrated to allows_or_allowed with TemperatureDeviation class (Rule 53/56)
- ../slots/allows_or_allowed
- ./TemperatureDeviation
- ../slots/humidity_tolerance
- ../slots/contains_or_contained_contains_unit
- ../slots/environmental_requirement
- ../slots/max_annual_light_exposure
- ../slots/max_light_lux
- ../slots/monitoring_platform
- ../slots/monitoring_platform_url
- ../slots/observation
- ../slots/part_of_facility
- ../slots/specificity_annotation
# REMOVED 2026-01-15: target_relative_humidity, target_temperature_celsius - migrated to has_or_had_setpoint with Setpoint class (Rule 53)
- ../slots/has_or_had_setpoint
- ./Setpoint
- ../enums/SetpointTypeEnum
- ../enums/MeasureUnitEnum
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- ../slots/temporal_extent # was: valid_from + valid_to - migrated per Rule 53
- ./TimeSpan
# REMOVED 2026-01-14: valid_from + valid_to - migrated to temporal_extent (Rule 53)
- ../slots/has_or_had_label
- ../slots/has_or_had_identifier
- ../slots/has_or_had_description
- ../slots/has_or_had_type
- ./SpecificityAnnotation
- ./StorageUnit
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
classes:
EnvironmentalZone:
class_uri: hc:EnvironmentalZone
description: >-
A climate-controlled area within a storage facility with specific
environmental parameters (temperature, relative humidity, light levels,
air quality).
DEFINITION:
An EnvironmentalZone represents a physically distinct area within a
storage facility that maintains specific environmental conditions.
Different collection types require different zones based on their
material composition and preservation requirements.
Examples include climate-controlled archive rooms (18C, 50% RH),
cold storage vaults for film (-5C to +4C), photographic materials
storage (15C, 35% RH), textile storage (stable RH, low light),
and general collection storage (ambient controlled).
Wikidata Alignment: Q1759899 (climate control).
HC Ontology Extension (hc-storage.ttl):
Primary class hc:EnvironmentalZone (subclass of crm:E27_Site).
Provides environmental preset instances including
hc:StandardArchiveEnvironment (18C, 50% RH, 50 lux),
hc:PhotographicMaterialsEnvironment (15C, 35% RH),
hc:ColdStorageEnvironment (-5C, 30% RH),
hc:TextileStorageEnvironment (18C, 50% RH, 15000 lux-hours/year).
Key HC properties: hc:hasStorageSection (links zone to storage units),
hc:hasEnvironmentalRequirement (links to climate specs),
hc:meetsRequirement (indicates compliance),
hc:hasEnvironmentalObservation (links to sensor readings),
hc:monitoredByPlatform (links to sensor systems).
SOSA/SSN Integration: Environmental zones can be monitored using
sensor networks where Zone is a sosa:FeatureOfInterest,
Observations are hc:StorageEnvironmentObservation, and
Sensors are hosted on hc:EnvironmentalSensorPlatform.
CIDOC-CRM Alignment (v7.1.3): Base class crm:E27_Site - Zones are
physical locations. StorageFacility has_section EnvironmentalZone
which has_section StorageUnit.
exact_mappings:
- hc:EnvironmentalZone
- crm:E27_Site
close_mappings:
- aat:300265612
- wikidata:Q1759899
related_mappings:
- hc:StorageFacility
- hc:StorageUnit
- hc:EnvironmentalRequirement
- sosa:FeatureOfInterest
slots:
- contains_or_contained_contains_unit
- environmental_requirement
# REMOVED 2026-01-16: humidity_tolerance - pending migration to allows_or_allowed with HumidityDeviation
- humidity_tolerance
- allows_or_allowed # was: temperature_tolerance - migrated per Rule 53/56 (2026-01-16)
- max_annual_light_exposure
- max_light_lux
- monitoring_platform
- monitoring_platform_url
- observation
- part_of_facility
- specificity_annotation
# REMOVED 2026-01-15: target_relative_humidity, target_temperature_celsius - migrated to has_or_had_setpoint
- has_or_had_setpoint
# REMOVED 2026-01-16: temperature_tolerance - migrated to allows_or_allowed with TemperatureDeviation
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- temporal_extent # was: valid_from + valid_to - migrated per Rule 53
- has_or_had_description
- has_or_had_identifier
- has_or_had_label
- has_or_had_type
slot_usage:
has_or_had_identifier:
range: uriorcurie
required: true
identifier: true
description: |
Unique identifier for this environmental zone.
Replaces zone_id per slot_fixes.yaml migration.
examples:
- value: https://nde.nl/ontology/hc/zone/na-depot-a-standard
description: National Archives Depot A - Standard environment zone
has_or_had_label:
range: string
required: true
description: |
Human-readable name for this environmental zone.
Replaces zone_name per slot_fixes.yaml migration.
examples:
- value: Standard Archive Storage Zone A
- value: Cold Storage Vault - Film Negatives
- value: Photographic Materials Room
has_or_had_type:
range: EnvironmentalZoneType
required: true
description: |
The type classification of this environmental zone.
Uses EnvironmentalZoneType class hierarchy (from EnvironmentalZoneTypes.yaml).
examples:
- value: ARCHIVE_STANDARD
description: Standard archive storage zone
- value: COLD_STORAGE
description: Cold storage vault for film materials
- value: PHOTOGRAPHIC
description: Photographic materials zone
has_or_had_description:
range: string
description: |
Free-text description of this environmental zone.
Replaces zone_description per slot_fixes.yaml migration.
# REMOVED 2026-01-15: target_temperature_celsius, target_relative_humidity
# Migrated to has_or_had_setpoint with Setpoint class per Rule 53
has_or_had_setpoint:
range: Setpoint
multivalued: true
inlined: true
inlined_as_list: true
description: |
Environmental control setpoints for this zone.
MIGRATED 2026-01-15: Replaces target_temperature_celsius, target_relative_humidity.
Uses Setpoint class for structured setpoint data.
examples:
- value:
- setpoint_type: TEMPERATURE
setpoint_value: 18.0
setpoint_min: 16.0
setpoint_max: 20.0
setpoint_tolerance: 2.0
setpoint_unit: DEGREE_CELSIUS
- setpoint_type: RELATIVE_HUMIDITY
setpoint_value: 50.0
setpoint_min: 45.0
setpoint_max: 55.0
setpoint_tolerance: 5.0
setpoint_unit: PERCENT
description: Standard archive zone setpoints
# REMOVED 2026-01-16: temperature_tolerance - migrated to allows_or_allowed with TemperatureDeviation
allows_or_allowed:
range: TemperatureDeviation
multivalued: true
inlined: true
inlined_as_list: true
description: |
Allowed temperature deviation/tolerance for this zone.
MIGRATED 2026-01-16: Replaces temperature_tolerance (float).
Uses TemperatureDeviation class for structured tolerance data with unit and ISO standard reference.
examples:
- value:
- deviation_value: 2.0
deviation_direction: PLUS_MINUS
has_or_had_measurement_unit:
has_or_had_type: DEGREE_CELSIUS
has_or_had_symbol: "°C"
iso_standard_reference: "ISO 11799:2015"
description: Standard archive tolerance (±2°C)
- value:
- deviation_value: 3.0
deviation_direction: PLUS_MINUS
iso_standard_reference: "ISO 18911:2010"
description: Cold storage tolerance (±3°C)
# REMOVED 2026-01-15: target_relative_humidity - migrated to has_or_had_setpoint above
humidity_tolerance:
range: float
examples:
- value: 5.0
max_light_lux:
range: float
examples:
- value: 50.0
description: Standard for light-sensitive materials
- value: 0.0
description: Dark storage for film
max_annual_light_exposure:
range: float
examples:
- value: 15000.0
description: Textile storage limit
environmental_requirement:
range: StorageConditionPolicy
examples:
- value: https://nde.nl/ontology/hc/StandardArchiveEnvironment
observation:
range: StorageCondition
multivalued: true
inlined_as_list: true
monitoring_platform:
range: string
examples:
- value: Hanwell RadioLog environmental monitoring system
- value: Meaco Climate Manager
monitoring_platform_url:
range: uri
part_of_facility:
range: Storage
required: true
contains_or_contained_contains_unit:
range: StorageUnit
multivalued: true
inlined_as_list: true
temporal_extent: # was: valid_from + valid_to - migrated per Rule 53
description: |
Validity period using CIDOC-CRM TimeSpan.
MIGRATED from valid_from + valid_to per slot_fixes.yaml (Rule 53).
range: TimeSpan
inlined: true
required: false
comments:
- EnvironmentalZone sits between Storage (facility) and StorageUnit (compartment)
- Environmental parameters should align with material preservation standards
- SOSA integration enables IoT sensor data ingestion
- HC ontology provides preset environmental requirements for common scenarios
see_also:
- https://nde.nl/ontology/hc/EnvironmentalZone
- http://vocab.getty.edu/aat/300265612
- http://www.w3.org/ns/sosa/
examples:
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/zone/na-depot-a-standard
has_or_had_label: Standard Archive Storage Zone A
has_or_had_type: ARCHIVE_STANDARD
has_or_had_description: 'Climate-controlled archive storage meeting ISO 11799 requirements.
Paper-based collections from 1800-1950.
'
has_or_had_setpoint: # MIGRATED 2026-01-15: was target_temperature_celsius, target_relative_humidity
- setpoint_type: TEMPERATURE
setpoint_value: 18.0
setpoint_min: 16.0
setpoint_max: 20.0
setpoint_tolerance: 2.0
setpoint_unit: DEGREE_CELSIUS
iso_standard_reference: "ISO 11799"
- setpoint_type: RELATIVE_HUMIDITY
setpoint_value: 50.0
setpoint_min: 45.0
setpoint_max: 55.0
setpoint_tolerance: 5.0
setpoint_unit: PERCENT
max_light_lux: 50.0
environmental_requirement: https://nde.nl/ontology/hc/StandardArchiveEnvironment
monitoring_platform: Hanwell RadioLog monitoring system
part_of_facility: https://nde.nl/ontology/hc/storage/na-depot-a
valid_from: '2010-01-15'
description: Standard archive storage zone with ISO 11799 conditions
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/zone/ef-cold-vault
has_or_had_label: Cold Storage Vault - Film Archive
has_or_had_type: COLD_STORAGE
has_or_had_description: 'Refrigerated vault for nitrate and acetate film negatives.
Maintained at -5°C, 30% RH per ISO 18911.
'
has_or_had_setpoint: # MIGRATED 2026-01-15: was target_temperature_celsius, target_relative_humidity
- setpoint_type: TEMPERATURE
setpoint_value: -5.0
setpoint_min: -8.0
setpoint_max: -2.0
setpoint_tolerance: 3.0
setpoint_unit: DEGREE_CELSIUS
iso_standard_reference: "ISO 18911"
- setpoint_type: RELATIVE_HUMIDITY
setpoint_value: 30.0
setpoint_min: 25.0
setpoint_max: 35.0
setpoint_tolerance: 5.0
setpoint_unit: PERCENT
max_light_lux: 0.0
environmental_requirement: https://nde.nl/ontology/hc/ColdStorageEnvironment
part_of_facility: https://nde.nl/ontology/hc/storage/ef-main-depot
description: Cold storage vault for film materials