glam/schemas/20251121/linkml/modules/classes/EnvironmentalZone.yaml
2026-01-14 09:05:54 +01:00

253 lines
11 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
- ../slots/temperature_tolerance
- ../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
- ../slots/target_relative_humidity
- ../slots/target_temperature_celsius
- ../slots/template_specificity
- ../slots/valid_from
- ../slots/valid_to
- ../slots/zone_description
- ../slots/zone_id
- ../slots/zone_name
- ../slots/has_or_had_type
- ./SpecificityAnnotation
- ./StorageUnit
- ./TemplateSpecificityScores
classes:
EnvironmentalZone:
class_uri: hc:EnvironmentalZone
description: "A climate-controlled area within a storage facility with specific\nenvironmental parameters (temperature,\
\ relative humidity, light levels,\nair quality).\n\n**DEFINITION**:\n\nAn EnvironmentalZone represents a physically\
\ distinct area within a\nstorage facility that maintains specific environmental conditions.\nDifferent collection types\
\ require different zones based on their\nmaterial composition and preservation requirements.\n\nExamples include:\n\
- Climate-controlled archive rooms (18°C, 50% RH)\n- Cold storage vaults for film (-5°C to +4°C)\n- Photographic materials\
\ storage (15°C, 35% RH)\n- Textile storage (stable RH, low light)\n- General collection storage (ambient controlled)\n\
\n**Wikidata Alignment**:\n- Q1759899 (climate control)\n\n**HC Ontology Extension (hc-storage.ttl)**:\n\nPrimary class:\
\ `hc:EnvironmentalZone` (subclass of `crm:E27_Site`)\n\nThe HC ontology provides environmental preset instances:\n\
- `hc:StandardArchiveEnvironment` - 18°C, 50% RH, 50 lux\n- `hc:PhotographicMaterialsEnvironment` - 15°C, 35% RH\n-\
\ `hc:ColdStorageEnvironment` - -5°C, 30% RH\n- `hc:TextileStorageEnvironment` - 18°C, 50% RH, 15000 lux-hours/year\n\
\nKey HC properties for zones:\n- `hc:hasStorageSection` - Links zone to storage units\n- `hc:hasEnvironmentalRequirement`\
\ - Links to climate specs\n- `hc:meetsRequirement` - Indicates compliance\n- `hc:hasEnvironmentalObservation` - Links\
\ to sensor readings\n- `hc:monitoredByPlatform` - Links to sensor systems\n\n**SOSA/SSN Integration**:\n\nEnvironmental\
\ zones can be monitored using sensor networks:\n- Zone is a `sosa:FeatureOfInterest`\n- Observations are `hc:StorageEnvironmentObservation`\n\
- Sensors are hosted on `hc:EnvironmentalSensorPlatform`\n\nSee: `frontend/public/ontology/hc-storage.ttl`\n\n**CIDOC-CRM\
\ Alignment (v7.1.3)**:\n\nBase class: `crm:E27_Site` - Zones are physical locations.\n\nHierarchy:\n```\nStorageFacility\
\ (hc:StorageFacility)\n └── P59 has_section → EnvironmentalZone (hc:EnvironmentalZone)\n ├── hc:hasEnvironmentalRequirement\
\ → EnvironmentalRequirement\n ├── hc:hasEnvironmentalObservation → StorageEnvironmentObservation[]\n \
\ └── P59 has_section → StorageUnit[]\n```\n\n**RELATIONSHIP TO OTHER CLASSES**:\n\n```\nStorage (facility)\n │\n \
\ └── has_section → EnvironmentalZone[] (THIS CLASS)\n │\n ├── has_or_had_type (EnvironmentalZoneType - class\
\ hierarchy)\n ├── environmental_requirement → StorageConditionPolicy\n ├── observations → StorageCondition[]\n\
\ ├── monitoring_platform (sensor system info)\n │\n └── has_section → StorageUnit[]\n \
\ └── stores_objects → HeritageObject[]\n```\n\n**ENVIRONMENTAL STANDARDS REFERENCE**:\n\n| Material Type | Temperature\
\ | RH | Light | Standard |\n|---------------|------------|-----|-------|----------|\n| Paper/archives | 16-20°C | 45-55%\
\ | <50 lux | ISO 11799 |\n| Photographs | 10-18°C | 30-40% | <50 lux | ISO 18934 |\n| Film (B&W) | -5°C | 30% | dark\
\ | ISO 18911 |\n| Film (color) | -20°C | 30% | dark | ISO 18911 |\n| Textiles | 15-20°C | 45-55% | <50 lux | varies\
\ |\n| Metals | 15-25°C | <35% | varies | varies |\n\n**USE CASES**:\n\n1. **Standard Archive Zone**:\n - zone_type:\
\ ARCHIVE_STANDARD\n - target_temperature: 18°C\n - target_humidity: 50%\n - max_light: 50 lux\n - environmental_requirement:\
\ hc:StandardArchiveEnvironment\n \n2. **Cold Storage Vault**:\n - zone_type: COLD_STORAGE\n - target_temperature:\
\ -5°C\n - target_humidity: 30%\n - environmental_requirement: hc:ColdStorageEnvironment\n \n3. **Photographic\
\ Materials Zone**:\n - zone_type: PHOTOGRAPHIC\n - target_temperature: 15°C\n - target_humidity: 35%\n - max_light:\
\ 50 lux\n"
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
- humidity_tolerance
- max_annual_light_exposure
- max_light_lux
- monitoring_platform
- monitoring_platform_url
- observation
- part_of_facility
- specificity_annotation
- target_relative_humidity
- target_temperature_celsius
- temperature_tolerance
- template_specificity
- valid_from
- valid_to
- zone_description
- zone_id
- zone_name
- has_or_had_type
slot_usage:
zone_id:
range: uriorcurie
required: true
identifier: true
examples:
- value: https://nde.nl/ontology/hc/zone/na-depot-a-standard
description: National Archives Depot A - Standard environment zone
zone_name:
range: string
required: true
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
zone_description:
range: string
target_temperature_celsius:
range: float
examples:
- value: 18.0
description: Standard archive temperature
- value: -5.0
description: Cold storage for film
- value: 15.0
description: Photographic materials
temperature_tolerance:
range: float
examples:
- value: 2.0
- value: 3.0
target_relative_humidity:
range: float
minimum_value: 0.0
maximum_value: 100.0
examples:
- value: 50.0
description: Standard archive humidity
- value: 35.0
description: Photographic materials
- value: 30.0
description: Cold storage
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
valid_from:
range: date
valid_to:
range: date
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:
zone_id: https://nde.nl/ontology/hc/zone/na-depot-a-standard
zone_name: Standard Archive Storage Zone A
has_or_had_type: ARCHIVE_STANDARD
zone_description: 'Climate-controlled archive storage meeting ISO 11799 requirements.
Paper-based collections from 1800-1950.
'
target_temperature_celsius: 18.0
temperature_tolerance: 2.0
target_relative_humidity: 50.0
humidity_tolerance: 5.0
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:
zone_id: https://nde.nl/ontology/hc/zone/ef-cold-vault
zone_name: Cold Storage Vault - Film Archive
has_or_had_type: COLD_STORAGE
zone_description: 'Refrigerated vault for nitrate and acetate film negatives.
Maintained at -5°C, 30% RH per ISO 18911.
'
target_temperature_celsius: -5.0
temperature_tolerance: 3.0
target_relative_humidity: 30.0
humidity_tolerance: 5.0
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