glam/schemas/20251121/linkml/modules/classes/EnvironmentalZone.yaml
kempersc fc405445c6 Refactor and update schema definitions
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`.
- Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples.
- Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`.
- Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files.
- Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
2026-02-01 19:55:38 +01:00

226 lines
8.8 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
- ../enums/MeasureUnitEnum
- ../enums/SetpointTypeEnum
- ../slots/allows_or_allowed
- ../slots/contains_or_contained_contains_unit
- ../slots/has_or_had_description
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_requirement
- ../slots/has_or_had_score
- ../slots/has_or_had_setpoint
- ../slots/has_or_had_tolerance
- ../slots/has_or_had_type
- ../slots/max_annual_light_exposure
- ../slots/max_light_lux
- ../slots/monitoring_platform
- ../slots/monitoring_platform_url
- ../slots/observation
- ../slots/part_of_facility
- ../slots/temporal_extent
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
- has_or_had_tolerance
- allows_or_allowed
- max_annual_light_exposure
- max_light_lux
- monitoring_platform
- monitoring_platform_url
- observation
- part_of_facility
- has_or_had_setpoint
- has_or_had_score
- temporal_extent
- 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
examples:
- value: https://nde.nl/ontology/hc/zone/na-depot-a-standard
has_or_had_label:
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: uriorcurie
required: true
examples:
- value: ARCHIVE_STANDARD
- value: COLD_STORAGE
- value: PHOTOGRAPHIC
has_or_had_description:
range: string
has_or_had_setpoint:
range: Setpoint
multivalued: true
inlined: true
inlined_as_list: true
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
allows_or_allowed:
range: string
multivalued: true
inlined: true
inlined_as_list: true
examples:
- value:
- deviation_value: 2.0
has_or_had_measurement_unit:
has_or_had_type: DEGREE_CELSIUS
has_or_had_symbol: "\xB0C"
iso_standard_reference: ISO 11799:2015
- value:
- deviation_value: 3.0
iso_standard_reference: ISO 18911:2010
has_or_had_tolerance:
range: float
examples:
- value: 5.0
max_light_lux:
range: float
examples:
- value: 50.0
- value: 0.0
max_annual_light_exposure:
range: float
examples:
- value: 15000.0
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:
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:
- 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
- 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.\nMaintained at -5\xB0C, 30% RH per ISO 18911.\n"
has_or_had_setpoint:
- 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
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"