glam/schemas/20251121/linkml/modules/classes/EnvironmentalZone.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
- ../enums/EnvironmentalZoneTypeEnum
- ../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/zone_type
- ./SpecificityAnnotation
- ./StorageUnit
- ./TemplateSpecificityScores
classes:
  EnvironmentalZone:
    class_uri: hc:EnvironmentalZone
    description: "A climate-controlled area within a storage facility with specific\n\
      environmental 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\n\
      material 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        ├──\
      \ zone_type (EnvironmentalZoneTypeEnum)\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
    - zone_type
    slot_usage:
      zone_id:
        slot_uri: dcterms:identifier
        description: |
          Unique identifier for this environmental zone.
          Format: URI following NDE Heritage Custodian ontology conventions.          
        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:
        slot_uri: crm:P87_is_identified_by
        description: |
          Human-readable name for this environmental zone.          
        range: string
        required: true
        examples:
        - value: Standard Archive Storage Zone A
        - value: Cold Storage Vault - Film Negatives
        - value: Photographic Materials Room
      zone_type:
        slot_uri: dcterms:type
        description: |
          Type of environmental zone from EnvironmentalZoneTypeEnum.

          Classifies the zone by its environmental characteristics
          and the type of materials it is designed to hold.          
        range: EnvironmentalZoneTypeEnum
        required: true
      zone_description:
        slot_uri: dcterms:description
        description: |
          Free-text description of this environmental zone.

          Include:
          - Purpose and materials stored
          - Special features or equipment
          - Access protocols          
        range: string
      target_temperature_celsius:
        slot_uri: hc:targetTemperature
        description: |
          Target temperature setpoint in degrees Celsius.

          HC Ontology: `hc:targetTemperature`          
        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:
        slot_uri: hc:temperatureTolerance
        description: |
          Acceptable deviation from target temperature in degrees Celsius.

          HC Ontology: `hc:temperatureTolerance`

          Example: tolerance of 2.0 means acceptable range is target ± 2°C.          
        range: float
        examples:
        - value: 2.0
        - value: 3.0
      target_relative_humidity:
        slot_uri: hc:targetRelativeHumidity
        description: |
          Target relative humidity setpoint as percentage (0-100).

          HC Ontology: `hc:targetRelativeHumidity`          
        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:
        slot_uri: hc:relativeHumidityTolerance
        description: |
          Acceptable deviation from target humidity in percentage points.

          HC Ontology: `hc:relativeHumidityTolerance`          
        range: float
        examples:
        - value: 5.0
      max_light_lux:
        slot_uri: hc:maxLightLevel
        description: |
          Maximum acceptable light level in lux.

          HC Ontology: `hc:maxLightLevel`

          Light-sensitive materials typically require < 50 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:
        slot_uri: hc:maxAnnualLightExposure
        description: |
          Maximum acceptable cumulative light exposure per year in lux-hours.

          HC Ontology: `hc:maxAnnualLightExposure`

          Important for textiles and other materials with annual exposure limits.          
        range: float
        examples:
        - value: 15000.0
          description: Textile storage limit
      environmental_requirement:
        slot_uri: hc:hasEnvironmentalRequirement
        description: |
          Environmental requirement specification this zone implements.

          HC Ontology: `hc:hasEnvironmentalRequirement`

          Can reference HC preset individuals:
          - hc:StandardArchiveEnvironment
          - hc:PhotographicMaterialsEnvironment
          - hc:ColdStorageEnvironment
          - hc:TextileStorageEnvironment          
        range: StorageConditionPolicy
        examples:
        - value: https://nde.nl/ontology/hc/StandardArchiveEnvironment
      observation:
        slot_uri: hc:hasEnvironmentalObservation
        description: |
          Environmental observations recorded for this zone.

          HC Ontology: `hc:hasEnvironmentalObservation`

          Links to StorageCondition instances representing actual
          measured conditions at specific points in time.          
        range: StorageCondition
        multivalued: true
        inlined_as_list: true
      monitoring_platform:
        slot_uri: hc:monitoredByPlatform
        description: |
          Name/description of the sensor platform monitoring this zone.

          HC Ontology: `hc:monitoredByPlatform` (subproperty of sosa:isFeatureOfInterestOf)

          Examples: Hanwell, Meaco, EBI dataloggers          
        range: string
        examples:
        - value: Hanwell RadioLog environmental monitoring system
        - value: Meaco Climate Manager
      monitoring_platform_url:
        slot_uri: schema:url
        description: |
          URL for accessing monitoring dashboard or API.          
        range: uri
      part_of_facility:
        slot_uri: hc:isStorageSectionOf
        description: |
          The parent storage facility containing this zone.

          HC Ontology: `hc:isStorageSectionOf`          
        range: Storage
        required: true
      contains_or_contained_contains_unit:
        slot_uri: hc:hasStorageSection
        description: |
          Storage units contained within this zone.

          HC Ontology: `hc:hasStorageSection`          
        range: StorageUnit
        multivalued: true
        inlined_as_list: true
      valid_from:
        slot_uri: schema:validFrom
        description: |
          Date when this environmental zone became operational.          
        range: date
      valid_to:
        slot_uri: schema:validThrough
        description: |
          Date when this zone was decommissioned.
          NULL if still active.          
        range: date
      specificity_annotation:
        range: SpecificityAnnotation
        inlined: true
      template_specificity:
        range: TemplateSpecificityScores
        inlined: true
    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
        zone_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
        zone_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
slots:
  zone_id:
    description: Unique identifier for environmental zone
    range: uriorcurie
  zone_name:
    description: Human-readable zone name
    range: string
  zone_type:
    description: Type of environmental zone
    range: EnvironmentalZoneTypeEnum
  zone_description:
    description: Description of environmental zone
    range: string
  target_temperature_celsius:
    description: Target temperature in Celsius
    range: float
  target_relative_humidity:
    description: Target relative humidity percentage
    range: float
  max_light_lux:
    description: Maximum light level in lux
    range: float
  max_annual_light_exposure:
    description: Maximum annual light exposure in lux-hours
    range: float
  environmental_requirement:
    description: Environmental specification this zone implements
    range: StorageConditionPolicy
  observation:
    description: Environmental observations for this zone
    range: StorageCondition
    multivalued: true
  monitoring_platform:
    description: Sensor platform monitoring this zone
    range: string
  monitoring_platform_url:
    description: URL for monitoring dashboard
    range: uri
  part_of_facility:
    description: Parent storage facility
    range: Storage
  contains_or_contained_contains_unit:
    description: Storage units within this zone
    range: StorageUnit
    multivalued: true