glam/schemas/20251121/linkml/modules/classes/Storage.yaml
2025-12-23 13:27:35 +01:00

498 lines
16 KiB
YAML

# Storage Class - Physical storage facilities for heritage collections
#
# Represents storage facilities (depots, vaults, warehouses) where
# heritage custodians preserve their collections.
#
# Wikidata references:
# - Q1191732 (depot/storage facility)
# - Q1454974 (archive storage)
#
# Generation date: 2025-11-29
#
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
- ../enums/StorageTypeEnum
- ../enums/StorageStandardEnum
- ../slots/storage_location
- ../slots/managed_by
classes:
Storage:
class_uri: premis:StorageLocation
description: |
Physical storage facility where heritage collections are preserved.
**DEFINITION**:
A Storage represents a dedicated facility or area for preserving
heritage materials. This includes archive depots, museum storage
vaults, library stacks, and specialized storage for different
material types.
**Wikidata Alignment**:
- Q1191732 (depot/storage facility)
- Q1454974 (archive storage)
- Q1280667 (art storage)
**PREMIS Alignment**:
`premis:StorageLocation` - "Information needed to retrieve a physical
item from its physical storage location or a file from the storage
system, or to access a bitstream within a file."
PREMIS also provides:
- `premis:StorageMedium` - Physical medium (tape, disk, etc.)
- `premis:storedAt` - Links objects to storage location
**RELATIONSHIP TO OTHER CLASSES**:
```
Custodian (hub)
├── storage_facilities → Storage[] (THIS CLASS)
│ ├── storage_type (StorageTypeEnum)
│ ├── storage_location → AuxiliaryPlace (physical site)
│ ├── stores_collections → CustodianCollection[]
│ ├── storage_conditions → StorageCondition[]
│ └── condition_policy → StorageConditionPolicy
└── place_designation → CustodianPlace
└── auxiliary_places → AuxiliaryPlace[]
└── hosts_storage → Storage (inverse)
```
**KEY DISTINCTION**:
- **Storage**: The FUNCTIONAL role of preserving collections
- **AuxiliaryPlace**: The PHYSICAL location/building
- **StorageCondition**: The ACTUAL observed state
- **StorageConditionPolicy**: The INTENDED/designed conditions
A single AuxiliaryPlace may host multiple Storage facilities
(e.g., climate-controlled art storage + general depot in same building).
**USE CASES**:
1. **Archive Depot**:
- storage_type: ARCHIVE_DEPOT
- standards_applied: [ISO_TR_19815_2018, EN_16893_2018]
- climate control: 18°C, 50% RH
2. **Cold Storage for Film**:
- storage_type: COLD_STORAGE
- standards_applied: [IMAGE_PERMANENCE_INSTITUTE]
- climate control: -18°C, 30% RH
3. **Open Study Storage**:
- storage_type: OPEN_STORAGE
- accessible to researchers
- combined storage/study function
exact_mappings:
- premis:StorageLocation
- wikidata:Q1191732
close_mappings:
- crm:E27_Site
- rico:Place
- schema:Place
related_mappings:
- premis:StorageMedium
- org:Site
slots:
- storage_id
- storage_name
- storage_type
- storage_description
- storage_location
- capacity_description
- capacity_linear_meters
- capacity_cubic_meters
- capacity_items
- current_utilization_percent
- stores_collections
- standards_applied
- condition_policy
- storage_conditions
- managed_by
- valid_from
- valid_to
- temporal_extent
- refers_to_custodian
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"
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
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"
# Slot definitions (basic - detailed in class slot_usage)
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
# NOTE: storage_location imported from global slot ../slots/storage_location.yaml
# Use slot_usage in class to customize range
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
capacity_items:
description: Capacity as number of items
range: integer
current_utilization_percent:
description: Current utilization percentage
range: float
stores_collections:
description: Collections stored in this facility
range: CustodianCollection
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
# NOTE: managed_by imported from global slot ../slots/managed_by.yaml