glam/schemas/20251121/linkml/modules/classes/Storage.yaml

id: https://nde.nl/ontology/hc/class/Storage
name: storage_class
title: Storage Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  crm: http://www.cidoc-crm.org/cidoc-crm/
  premis: http://www.loc.gov/premis/rdf/v3/
  prov: http://www.w3.org/ns/prov#
  schema: http://schema.org/
  org: http://www.w3.org/ns/org#
  dcterms: http://purl.org/dc/terms/
  wd: http://www.wikidata.org/entity/
  rico: https://www.ica.org/standards/RiC/ontology#
default_prefix: hc
imports:
- linkml:types
- ./Custodian
- ./AuxiliaryPlace
- ./CustodianCollection
- ./TimeSpan
- ./StorageCondition
- ./StorageConditionPolicy
- ./StorageUnit
- ./EnvironmentalZone
- ./Event
- ../enums/StorageTypeEnum
- ../enums/StorageStandardEnum
- ../enums/StorageUnitTypeEnum
- ../enums/EnvironmentalZoneTypeEnum
- ../slots/storage_location
- ../slots/managed_by
- ../slots/capacity_items
- ../slots/class_metadata_slots
classes:
  Storage:
    class_uri: hc:StorageFacility
    description: "Physical storage facility where heritage collections are preserved.\n\
      \n**DEFINITION**:\n\nA Storage represents a dedicated facility or area for preserving\n\
      heritage materials. This includes archive depots, museum storage\nvaults, library\
      \ stacks, and specialized storage for different\nmaterial types.\n\n**Wikidata\
      \ Alignment**:\n- Q1191732 (depot/storage facility)\n- Q1454974 (archive storage)\n\
      - Q1280667 (art storage)\n\n**HC Ontology Extension (hc-storage.ttl)**:\n\n\
      Primary class: `hc:StorageFacility` (subclass of `crm:E27_Site`)\n\nThe Heritage\
      \ Custodian storage ontology extension provides specialized\nclasses and properties\
      \ for heritage storage management:\n\n- `hc:StorageFacility` - Top-level storage\
      \ facility (THIS CLASS)\n- `hc:StorageUnit` - Individual compartments, shelves,\
      \ cabinets\n- `hc:EnvironmentalZone` - Climate-controlled areas\n- `hc:StorageAssignment`\
      \ - Assignment of objects to locations\n- `hc:StorageConditionAssessment` -\
      \ Environmental assessments\n- `hc:EnvironmentalRequirement` - Climate specifications\n\
      - `hc:StorageCapacitySpecification` - Capacity measurements\n\nKey HC properties\
      \ used:\n- `hc:hasStorageSection` - Links facility to zones/units (extends P59)\n\
      - `hc:currentlyStores` - Links location to objects (extends P55)\n- `hc:hasEnvironmentalRequirement`\
      \ - Links to climate specs\n- `hc:hasStorageCapacity` - Links to capacity measurements\n\
      \nSee: `frontend/public/ontology/hc-storage.ttl`\n\n**CIDOC-CRM Alignment (v7.1.3)**:\n\
      \nBase class: `crm:E27_Site` - \"This class comprises pieces of land\nor sea\
      \ floor. In contrast to the purely geometric notion of E53 Place,\nthis class\
      \ describes constellations of matter on the surface of the\nEarth or other celestial\
      \ body, which can be represented by photographs,\npaintings and maps.\"\n\n\
      **Location Predicate Hierarchy**:\n\n| Predicate | Meaning | Use Case |\n|-----------|---------|----------|\n\
      | P53 has former or current location | Any location in history | General location\
      \ tracking |\n| P54 has current permanent location | Reserved/designated location\
      \ | Permanent storage assignment |\n| P55 has current location | Actual current\
      \ location | Where object is NOW |\n\nNote: P55 is a specialization of P53.\
      \ An object may have a permanent\nlocation (P54) but currently be elsewhere\
      \ (P55), e.g., on loan.\n\n**PREMIS Alignment**:\n\n`premis:StorageLocation`\
      \ - \"Information needed to retrieve a physical\nitem from its physical storage\
      \ location or a file from the storage\nsystem, or to access a bitstream within\
      \ a file.\"\n\nPREMIS also provides:\n- `premis:StorageMedium` - Physical medium\
      \ (tape, disk, etc.)\n- `premis:storedAt` - Links objects to storage location\n\
      \n**RELATIONSHIP TO OTHER CLASSES**:\n\n```\nCustodian (hub)\n  │\n  ├── storage_facilities\
      \ → Storage[] (THIS CLASS)\n  │     ├── storage_type (StorageTypeEnum)\n  │\
      \     ├── storage_location → AuxiliaryPlace (physical site)\n  │     ├── stores_collections\
      \ → CustodianCollection[]\n  │     ├── storage_conditions → StorageCondition[]\n\
      \  │     ├── condition_policy → StorageConditionPolicy\n  │     ├── has_section\
      \ → Storage[] (subdivisions via P59)\n  │     ├── move_events → MoveEvent[]\
      \ (objects moved to/from)\n  │     └── custody_transfers → CustodyTransferEvent[]\n\
      \  │\n  └── place_designation → CustodianPlace\n        └── auxiliary_places\
      \ → AuxiliaryPlace[]\n              └── hosts_storage → Storage (inverse)\n\
      ```\n\n**KEY DISTINCTION**:\n\n- **Storage**: The FUNCTIONAL role of preserving\
      \ collections\n- **AuxiliaryPlace**: The PHYSICAL location/building\n- **StorageCondition**:\
      \ The ACTUAL observed state\n- **StorageConditionPolicy**: The INTENDED/designed\
      \ conditions\n\nA single AuxiliaryPlace may host multiple Storage facilities\n\
      (e.g., climate-controlled art storage + general depot in same building).\n\n\
      **USE CASES**:\n\n1. **Archive Depot**:\n   - storage_type: ARCHIVE_DEPOT\n\
      \   - standards_applied: [ISO_TR_19815_2018, EN_16893_2018]\n   - climate control:\
      \ 18°C, 50% RH\n   \n2. **Cold Storage for Film**:\n   - storage_type: COLD_STORAGE\n\
      \   - standards_applied: [IMAGE_PERMANENCE_INSTITUTE]\n   - climate control:\
      \ -18°C, 30% RH\n   \n3. **Open Study Storage**:\n   - storage_type: OPEN_STORAGE\n\
      \   - accessible to researchers\n   - combined storage/study function\n"
    exact_mappings:
    - hc:StorageFacility
    - crm:E27_Site
    - wikidata:Q1191732
    close_mappings:
    - premis:StorageLocation
    - rico:Place
    - schema:Place
    related_mappings:
    - hc:StorageUnit
    - hc:EnvironmentalZone
    - premis:StorageMedium
    - org:Site
    - crm:E53_Place
    slots:
    - capacity_cubic_meters
    - capacity_description
    - capacity_items
    - capacity_linear_meters
    - condition_policy
    - current_utilization_percent
    - environmental_zones
    - managed_by
    - refers_to_custodian
    - specificity_annotation
    - standards_applied
    - storage_conditions
    - storage_description
    - storage_id
    - storage_location
    - storage_name
    - storage_type
    - storage_units
    - stores_collections
    - template_specificity
    - temporal_extent
    - valid_from
    - valid_to
    slot_usage:
      storage_id:
        slot_uri: dcterms:identifier
        description: |
          Unique identifier for this storage facility.
          Format: URI following NDE Heritage Custodian ontology conventions.          
        range: uriorcurie
        required: true
        identifier: true
        examples:
        - value: https://nde.nl/ontology/hc/storage/rijksmuseum-depot-amersfoort
          description: Rijksmuseum off-site depot
      storage_name:
        slot_uri: crm:P87_is_identified_by
        description: |
          Human-readable name for this storage facility.

          CIDOC-CRM: P87_is_identified_by links place to appellation.          
        range: string
        required: true
        examples:
        - value: Depot Amersfoort
        - value: Cold Storage Vault A
        - value: Manuscript Storage Room 3
      storage_type:
        slot_uri: dcterms:type
        description: |
          Type of storage facility from StorageTypeEnum.

          Classifies the storage by its primary function and the type
          of materials it is designed to hold.          
        range: StorageTypeEnum
        required: true
        examples:
        - value: ARCHIVE_DEPOT
        - value: COLD_STORAGE
        - value: ART_STORAGE
      storage_description:
        slot_uri: dcterms:description
        description: |
          Free-text description of the storage facility.

          Include:
          - Purpose and function
          - Types of materials stored
          - Special features or equipment
          - Access restrictions
          - Historical context          
        range: string
        examples:
        - value: 'Climate-controlled archive depot housing overflow document collections.
            Equipped with mobile shelving system (Compactus). Staff access only. Fire
            suppression: inert gas system.'
      storage_location:
        slot_uri: premis:storedAt
        description: |
          Physical location where this storage facility is situated.

          Links to AuxiliaryPlace representing the building or site.
          Multiple Storage instances may share the same AuxiliaryPlace
          (e.g., different climate zones in one building).

          PREMIS: storedAt links objects to storage location.          
        range: AuxiliaryPlace
        required: false
        examples:
        - value: https://nde.nl/ontology/hc/aux-place/rijksmuseum-depot-amersfoort
      capacity_description:
        slot_uri: dcterms:extent
        description: |
          Free-text description of storage capacity.

          Use when precise measurements not available or when capacity
          is better described qualitatively.          
        range: string
        examples:
        - value: Approximately 5,000 linear meters of shelving across 3 floors
        - value: Large-scale art storage for paintings up to 4m x 6m
      capacity_linear_meters:
        slot_uri: schema:value
        description: |
          Total storage capacity in linear meters of shelving.

          Standard measurement for document and book storage.          
        range: float
        examples:
        - value: 5000.0
          description: 5,000 linear meters
      capacity_cubic_meters:
        slot_uri: schema:value
        description: |
          Total storage capacity in cubic meters.

          Used for three-dimensional object storage.          
        range: float
        examples:
        - value: 2500.0
          description: 2,500 cubic meters
      capacity_items:
        slot_uri: schema:value
        description: |
          Total storage capacity as number of items or containers.

          Used when shelving metrics not applicable (e.g., boxes, crates).          
        range: integer
        examples:
        - value: 50000
          description: Capacity for 50,000 archive boxes
      current_utilization_percent:
        slot_uri: schema:value
        description: |
          Current storage utilization as percentage of total capacity.

          Helps identify when new storage is needed.
          Update date should be tracked in last assessment.          
        range: float
        minimum_value: 0.0
        maximum_value: 100.0
        examples:
        - value: 85.5
          description: 85.5% of capacity currently used
      stores_collections:
        slot_uri: crm:P46_is_composed_of
        description: |
          Collections or portions of collections stored in this facility.

          Links to CustodianCollection instances representing what is
          physically kept in this storage.

          CIDOC-CRM: P46_is_composed_of links aggregations to components.          
        range: CustodianCollection
        multivalued: true
        inlined_as_list: true
        examples:
        - value:
          - https://nde.nl/ontology/hc/collection/rijksmuseum-prints
          - https://nde.nl/ontology/hc/collection/rijksmuseum-drawings
      environmental_zones:
        slot_uri: hc:hasStorageSection
        description: |
          Climate-controlled zones within this storage facility.

          HC Ontology: `hc:hasStorageSection` (extends crm:P59_has_section)

          Links to EnvironmentalZone instances representing distinct
          climate-controlled areas with specific environmental parameters.

          A facility may have multiple zones for different material types:
          - Standard archive zone (18°C, 50% RH)
          - Cold storage vault (-5°C, 30% RH)
          - Photographic materials zone (15°C, 35% RH)          
        range: EnvironmentalZone
        multivalued: true
        inlined_as_list: true
        examples:
        - value:
          - https://nde.nl/ontology/hc/zone/na-depot-a-standard
          - https://nde.nl/ontology/hc/zone/na-depot-a-cold
      storage_units:
        slot_uri: hc:hasStorageSection
        description: |
          Individual storage units directly within this facility.

          HC Ontology: `hc:hasStorageSection` (extends crm:P59_has_section)

          Links to StorageUnit instances representing discrete storage
          compartments (shelves, cabinets, boxes) not contained within
          a specific environmental zone.

          Note: Units may also be contained within EnvironmentalZone
          instances via the zone's contains_units slot.          
        range: StorageUnit
        multivalued: true
        inlined_as_list: true
        examples:
        - value:
          - https://nde.nl/ontology/hc/unit/na-depot-general-r1-b1
      standards_applied:
        slot_uri: dcterms:conformsTo
        description: |
          Storage standards that this facility is designed to meet.

          References StorageStandardEnum values for ISO, EN, or other
          recognized standards governing storage conditions.

          Dublin Core: conformsTo for standards compliance.          
        range: StorageStandardEnum
        multivalued: true
        examples:
        - value:
          - ISO_TR_19815_2018
          - EN_16893_2018
          - EN_15757_2010
      condition_policy:
        slot_uri: premis:policy
        description: |
          Storage condition policy defining intended environmental parameters.

          Links to StorageConditionPolicy which specifies target temperature,
          humidity, and other conditions designed by the custodian.

          PREMIS: policy links objects to preservation policies.          
        range: StorageConditionPolicy
        examples:
        - value: https://nde.nl/ontology/hc/policy/rijksmuseum-depot-climate
      storage_conditions:
        slot_uri: prov:wasInfluencedBy
        description: |
          Observed storage conditions - actual reports of facility state.

          Links to StorageCondition instances representing assessments
          of the facility's actual conditions at specific points in time.

          **CRITICAL**: These are OBSERVATIONS of actual conditions,
          which may differ from the condition_policy (designed conditions).

          Observations can come from internal staff, external inspectors,
          journalists, or any observer.

          PROV-O: wasInfluencedBy links entities to influencing activities.          
        range: StorageCondition
        multivalued: true
        inlined_as_list: true
      managed_by:
        slot_uri: org:hasUnit
        description: |
          Organizational unit responsible for managing this storage.

          Links to OrganizationalStructure or staff role responsible
          for storage operations and maintenance.

          W3C ORG: hasUnit for organizational relationships.          
        range: string
        examples:
        - value: Collections Management Department
        - value: Facilities and Security Team
      valid_from:
        slot_uri: schema:validFrom
        description: |
          Date when this storage facility became operational.          
        range: date
        examples:
        - value: '1995-06-01'
      valid_to:
        slot_uri: schema:validThrough
        description: |
          Date when this storage facility was decommissioned.
          NULL if still active.          
        range: date
      temporal_extent:
        slot_uri: crm:P4_has_time-span
        description: |
          Fuzzy temporal period for storage facility operation.

          CIDOC-CRM: P4_has_time-span for uncertain dates.          
        range: TimeSpan
      refers_to_custodian:
        slot_uri: org:siteOf
        description: |
          The Custodian hub that operates this storage facility.

          W3C ORG: siteOf links site to organization.          
        range: Custodian
        required: true
      specificity_annotation:
        range: SpecificityAnnotation
        inlined: true
      template_specificity:
        range: TemplateSpecificityScores
        inlined: true
    comments:
    - Storage models the FUNCTIONAL role of preservation, not just physical location
    - Links to AuxiliaryPlace for physical building/site information
    - Condition observations (StorageCondition) may come from internal or external
      sources
    - Condition policy (StorageConditionPolicy) represents designed/intended state
    - Actual conditions may differ significantly from policy - this is critical for
      transparency
    - Multiple Storage instances can exist at same AuxiliaryPlace (different zones)
    see_also:
    - http://www.loc.gov/premis/rdf/v3/StorageLocation
    - https://www.wikidata.org/wiki/Q1191732
    - http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E27
    examples:
    - value:
        storage_id: https://nde.nl/ontology/hc/storage/rijksmuseum-depot-amersfoort
        storage_name: Depot Amersfoort
        storage_type: ART_STORAGE
        storage_description: |
          Off-site storage depot for Rijksmuseum overflow collections.
          Climate-controlled facility housing paintings, sculptures,
          and decorative arts not currently on display.          
        storage_location: https://nde.nl/ontology/hc/aux-place/rijksmuseum-depot-amersfoort
        capacity_linear_meters: 8000.0
        current_utilization_percent: 78.5
        standards_applied:
        - EN_16893_2018
        - EN_15757_2010
        refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
      description: Rijksmuseum off-site art storage depot
    - value:
        storage_id: https://nde.nl/ontology/hc/storage/nationaal-archief-depot-b
        storage_name: Depot B - Cold Storage
        storage_type: COLD_STORAGE
        storage_description: |
          Refrigerated vault for film negatives, photographic materials,
          and temperature-sensitive documents. Maintained at 4°C, 35% RH.          
        capacity_description: 1,200 linear meters of cold storage shelving
        standards_applied:
        - IMAGE_PERMANENCE_INSTITUTE
        - ISO_TR_19815_2018
        refers_to_custodian: https://nde.nl/ontology/hc/nl-na
      description: National Archives cold storage for photographic materials
slots:
  storage_id:
    description: Unique identifier for storage facility
    range: uriorcurie
  storage_name:
    description: Name of storage facility
    range: string
  storage_type:
    description: Type of storage from StorageTypeEnum
    range: StorageTypeEnum
  storage_description:
    description: Description of storage facility
    range: string
  capacity_description:
    description: Qualitative capacity description
    range: string
  capacity_linear_meters:
    description: Capacity in linear meters
    range: float
  capacity_cubic_meters:
    description: Capacity in cubic meters
    range: float
  current_utilization_percent:
    description: Current utilization percentage
    range: float
  stores_collections:
    description: Collections stored in this facility
    range: CustodianCollection
    multivalued: true
  environmental_zones:
    description: Climate-controlled zones within this facility
    range: EnvironmentalZone
    multivalued: true
  storage_units:
    description: Individual storage units in this facility
    range: StorageUnit
    multivalued: true
  standards_applied:
    description: Standards this storage conforms to
    range: StorageStandardEnum
    multivalued: true
  condition_policy:
    description: Designed condition policy
    range: StorageConditionPolicy
  storage_conditions:
    description: Observed condition reports
    range: StorageCondition
    multivalued: true