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

724 lines
27 KiB
YAML

# ClosedSpace Class - Restricted access spaces within heritage custodians
#
# This class represents physically restricted spaces that may house
# collections, storage, or operational areas with controlled access.
# Linked to CustodianPlace as a specialized place subtype.
#
# Ontology Alignment:
# - CIDOC-CRM: E27_Site (physical things with stable position)
# - RiC-O: PhysicalLocation (physical location of archival materials)
# - PREMIS: StorageLocation (information for physical retrieval)
# - W3C Org: Site (office or premise at which organization is located)
# - Schema.org: Place (a physical location)
#
# Wikidata references:
# - Q3508014 (closed space - restricted area)
# - Q17008256 (restricted area)
#
# Key CIDOC-CRM Properties Used:
# - P54 has current permanent location (reserved location for object)
# - P55 has current location (current location of object)
# - P59 has section (spatial subdivision)
# - P89 falls within (spatial containment)
# - P87 is identified by (appellation)
#
# Key RiC-O Properties Used:
# - hasOrHadPhysicalLocation (connects to PhysicalLocation)
# - containsOrContained (spatial containment)
#
# Generation date: 2025-12-09
# Updated with comprehensive ontology mappings
#
id: https://nde.nl/ontology/hc/class/ClosedSpace
name: closed_space_class
title: Closed Space Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
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#
premis: http://www.loc.gov/premis/rdf/v3/
skos: http://www.w3.org/2004/02/skos/core#
locn: http://www.w3.org/ns/locn#
default_prefix: hc
imports:
- linkml:types
- ./CustodianPlace
- ./AuxiliaryPlace
- ./Storage
- ./Collection
- ./AccessPolicy
- ../slots/security_level
classes:
ClosedSpace:
class_uri: crm:E27_Site
description: |
Physically restricted or controlled-access space within a heritage custodian facility.
**DEFINITION**:
ClosedSpace represents areas within heritage institutions that have restricted
access due to:
- Security requirements (vaults, treasure rooms)
- Preservation needs (climate-controlled spaces)
- Operational requirements (conservation labs, digitization studios)
- Safety concerns (hazmat storage, fragile materials)
- Privacy/confidentiality (records with access restrictions)
**ONTOLOGY ALIGNMENT**:
This class integrates concepts from multiple heritage ontologies:
**CIDOC-CRM** (crm:E27_Site):
"Comprises physical things that have a relatively stable position and extent
with respect to the surface of the Earth. Instances of E27 Site are composed
of relatively immobile material items and features in a particular configuration
at a particular location."
ClosedSpace is a specialized Site with access restrictions. Key properties:
- `crm:P54_has_current_permanent_location` - Reserved storage location
- `crm:P55_has_current_location` - Current location of items
- `crm:P59_has_section` - Spatial subdivision within building
- `crm:P89_falls_within` - Spatial containment hierarchy
- `crm:P87_is_identified_by` - Name/appellation
**RiC-O** (rico:PhysicalLocation):
"A place considered from the point of view of where some archival material is
or was located." ClosedSpace models the physical location where records with
access restrictions are stored.
Key properties:
- `rico:hasOrHadPhysicalLocation` - Links records to physical location
- `rico:containsOrContained` - Spatial containment of materials
- `rico:isOrWasPhysicalLocationOf` - Inverse of above
**PREMIS** (premis:StorageLocation):
"Information needed to retrieve a physical item from its physical storage
location or a file from the storage system."
ClosedSpace provides the physical context for PREMIS storage locations.
**W3C Org** (org:Site):
"An office or other premise at which the organization is located."
ClosedSpace is a specialized Site with restricted access characteristics.
Key properties:
- `org:hasSite` / `org:siteOf` - Links organization to site
- `org:siteAddress` - Physical address
**Schema.org** (schema:Place):
"Entities that have a somewhat fixed, physical extension."
Key properties:
- `schema:containedInPlace` - Spatial containment
- `schema:containsPlace` - Inverse containment
- `schema:amenityFeature` - Environmental controls
**Wikidata Alignment**:
- Q3508014 (closed space - restricted/enclosed area)
- Q17008256 (restricted area)
**RELATIONSHIP TO CustodianPlace**:
CustodianPlace represents the NOMINAL place designation of a custodian.
ClosedSpace represents PHYSICAL restricted areas within that place.
The relationship uses `crm:P59_has_section` (spatial subdivision):
```
CustodianPlace (nominal designation)
└── P59_has_section → ClosedSpace[] (THIS CLASS)
├── restriction_type (security, preservation, operational)
├── access_policy → AccessPolicy
├── P46_is_composed_of → Storage[]
└── P46_is_composed_of → Collection[]
```
**RELATIONSHIP TO AuxiliaryPlace**:
ClosedSpace can exist within any AuxiliaryPlace (branch, depot, etc.):
```
AuxiliaryPlace (physical location)
└── P59_has_section → ClosedSpace[]
```
**RiC-O INTEGRATION**:
For archival contexts, ClosedSpace aligns with rico:PhysicalLocation:
```
rico:RecordSet
└── rico:hasOrHadPhysicalLocation → ClosedSpace (as rico:PhysicalLocation)
```
**ARCHIVE CONTEXT - DIM ARCHIVE**:
The ArchiveTypeEnum value "DIM_ARCHIVE" (Q124749604) refers to archives
with access restrictions. ClosedSpace provides the physical manifestation
of these restrictions:
- DimArchive (custodian type) → operates in ClosedSpace (physical)
- ClosedSpace → has access_policy → AccessPolicy (rules)
- AccessPolicy → applies_to → Collection (what's restricted)
**USE CASES**:
1. **Security Vault**:
- restriction_type: SECURITY
- space_name: "Rare Book Vault"
- access_policy: "Staff-only, appointment required"
- contains_collections: [Rare Manuscripts, Incunabula]
2. **Conservation Lab**:
- restriction_type: OPERATIONAL
- space_name: "Paper Conservation Laboratory"
- access_policy: "Conservation staff only"
- hazards: "Chemical treatments in use"
3. **Cold Storage**:
- restriction_type: PRESERVATION
- space_name: "Film Cold Vault"
- access_policy: "Scheduled access only"
- contains_storage: [Film Storage Vault A]
4. **Restricted Reading Room**:
- restriction_type: CONFIDENTIALITY
- space_name: "Classified Records Reading Room"
- access_policy: "Security clearance required"
- contains_collections: [Government Classified Records]
exact_mappings:
- crm:E27_Site
- wikidata:Q3508014
close_mappings:
- rico:PhysicalLocation
- org:Site
- schema:Place
- wikidata:Q17008256
related_mappings:
- premis:StorageLocation
- rico:Place
- locn:Location
slots:
- closed_space_id
- space_name
- space_description
- restriction_type
- restriction_reason
- access_policy
- security_level
- environmental_controls
- contains_storage
- contains_collections
- hazards
- within_place
- within_auxiliary_place
- capacity
- valid_from
- valid_to
slot_usage:
closed_space_id:
slot_uri: dcterms:identifier
description: |
Unique identifier for this closed space.
Format: URI following NDE Heritage Custodian ontology conventions.
**Ontology Alignment**:
- Dublin Core: `dcterms:identifier` - unambiguous reference
- CIDOC-CRM: Aligns with `crm:P1_is_identified_by`
range: uriorcurie
required: true
identifier: true
examples:
- value: "https://nde.nl/ontology/hc/closed-space/na-rare-book-vault"
description: "National Archives rare book vault"
space_name:
slot_uri: crm:P1_is_identified_by
description: |
Human-readable name for this closed space.
**Ontology Alignment**:
- CIDOC-CRM: `crm:P1_is_identified_by` - "identifies an instance of E1 CRM Entity
by means of an E41 Appellation"
- Schema.org: `schema:name` - name of the place
- RiC-O: `rico:name` - name of entity
Note: Changed from P87 (which links Place to Appellation) to P1 which is
more general and applies to all CRM entities including Sites.
range: string
required: true
examples:
- value: "Rare Book Vault"
- value: "Paper Conservation Laboratory"
- value: "Film Cold Storage Vault A"
- value: "Classified Records Reading Room"
space_description:
slot_uri: crm:P3_has_note
description: |
Description of the closed space and its purpose.
**Ontology Alignment**:
- CIDOC-CRM: `crm:P3_has_note` - "describes an instance of E1 CRM Entity by
means of a text"
- Dublin Core: `dcterms:description` - account of the resource
- Schema.org: `schema:description` - description of the item
Include:
- Physical characteristics
- Purpose and function
- Special equipment or features
- Historical context
range: string
examples:
- value: >-
Climate-controlled vault housing the institution's most valuable
rare books and manuscripts. Features fire suppression, biometric
access, and 24/7 monitoring.
restriction_type:
slot_uri: crm:P2_has_type
description: |
Primary type of restriction for this space.
**Ontology Alignment**:
- CIDOC-CRM: `crm:P2_has_type` - "identifies the type of an E1 CRM Entity"
- Dublin Core: `dcterms:type` - nature or genre of the resource
- SKOS: Aligns with concept classification
Values:
- SECURITY: High-value items requiring protection
- PRESERVATION: Climate/environmental control needs
- OPERATIONAL: Staff operational areas
- CONFIDENTIALITY: Privacy/access restricted materials
- SAFETY: Hazardous materials or conditions
- QUARANTINE: Isolation for treatment/inspection
range: string
required: true
examples:
- value: "SECURITY"
description: "Rare book vault"
- value: "PRESERVATION"
description: "Cold storage"
- value: "OPERATIONAL"
description: "Conservation lab"
- value: "CONFIDENTIALITY"
description: "Classified records room"
restriction_reason:
slot_uri: crm:P3_has_note
description: |
Detailed explanation of why access is restricted.
**Ontology Alignment**:
- CIDOC-CRM: `crm:P3_has_note` - textual description
- SKOS: `skos:note` - general documentation property
- RiC-O: `rico:scopeAndContent` - describes content and restrictions
Useful for:
- Justifying restrictions to researchers
- Documenting historical reasons
- Explaining regulatory requirements
range: string
examples:
- value: >-
Access restricted due to extreme fragility of medieval manuscripts.
Temperature and humidity fluctuations from frequent access would
accelerate deterioration.
- value: >-
Contains government records with 75-year closure period per
Public Records Act. Access requires special permission from
originating agency.
access_policy:
slot_uri: premis:policy
description: |
Access policy governing this closed space.
**Ontology Alignment**:
- PREMIS: `premis:policy` - links objects to preservation/access policies
- PREMIS: `premis:PreservationPolicy` class for policy details
- RiC-O: Aligns with `rico:Rule` for access regulations
- ODRL: Could align with `odrl:Policy` for machine-readable policies
Links to AccessPolicy class which defines:
- Who can access
- Under what conditions
- Required approvals
- Time restrictions
range: AccessPolicy
examples:
- value: "https://nde.nl/ontology/hc/policy/staff-only-appointment"
description: "Staff access with appointment"
security_level:
slot_uri: schema:securityClearanceRequirement
description: |
Security classification of the space.
**Ontology Alignment**:
- Schema.org: Aligns with security-related properties
- PREMIS: Relates to `premis:inhibitors` for access restrictions
- RiC-O: Aligns with access classification concepts
Values: STANDARD, ENHANCED, HIGH, MAXIMUM
range: string
examples:
- value: "HIGH"
description: "Rare book vault"
- value: "MAXIMUM"
description: "Treasure room"
- value: "ENHANCED"
description: "Conservation lab"
environmental_controls:
slot_uri: schema:amenityFeature
description: |
Environmental control features in this space.
**Ontology Alignment**:
- Schema.org: `schema:amenityFeature` - facility features
- PREMIS: Aligns with `premis:environmentCharacteristic`
- CIDOC-CRM: Could use `crm:P44_has_condition` for state
Include:
- Climate control (temperature, humidity)
- Lighting (UV filtering, lux levels)
- Air quality (filtration, pressure)
- Fire suppression type
range: string
examples:
- value: "18°C ±1°C, 50% RH ±5%, HEPA filtration, inert gas fire suppression"
description: "Archive vault environmental controls"
- value: "-18°C, 30% RH, dark storage"
description: "Film cold vault"
contains_storage:
slot_uri: crm:P46_is_composed_of
description: |
Storage facilities located within this closed space.
**Ontology Alignment**:
- CIDOC-CRM: `crm:P46_is_composed_of` - "describes the decomposition of
an instance of E18 Physical Thing into discrete, component parts"
- CIDOC-CRM: `crm:P59_has_section` - spatial subdivision alternative
- RiC-O: `rico:containsOrContained` - spatial containment
- Schema.org: `schema:containsPlace` - place containment
Links to Storage instances that exist within this restricted area.
range: Storage
multivalued: true
inlined_as_list: true
examples:
- value:
- "https://nde.nl/ontology/hc/storage/na-rare-book-shelving"
- "https://nde.nl/ontology/hc/storage/na-manuscript-cabinets"
contains_collections:
slot_uri: rico:containsOrContained
description: |
Collections or collection portions housed in this closed space.
**Ontology Alignment**:
- RiC-O: `rico:containsOrContained` - "connects a Record Resource to
one or more Record Resources that are or were contained in it"
- CIDOC-CRM: `crm:P46_is_composed_of` for part-whole relationships
- Schema.org: `schema:hasPart` - indicates item has part
Note: May overlap with Storage.stores_collections for collections
that are both in storage AND in a closed space.
range: Collection
multivalued: true
inlined_as_list: true
examples:
- value:
- "https://nde.nl/ontology/hc/collection/na-medieval-manuscripts"
- "https://nde.nl/ontology/hc/collection/na-incunabula"
hazards:
slot_uri: schema:warning
description: |
Hazards or safety concerns in this space.
**Ontology Alignment**:
- Schema.org: `schema:warning` - safety information
- CIDOC-CRM: `crm:P44_has_condition` - current state (hazard condition)
- PREMIS: Relates to `premis:inhibitors` for access restrictions
Important for:
- Staff safety training
- Access protocols
- Emergency procedures
range: string
multivalued: true
examples:
- value:
- "Chemical treatments in use"
- "Nitrate film storage - fire risk"
- "Low oxygen environment"
description: "Conservation lab hazards"
within_place:
slot_uri: crm:P89_falls_within
description: |
The CustodianPlace that contains this closed space.
**Ontology Alignment**:
- CIDOC-CRM: `crm:P89_falls_within` - "asserts that an instance of E53 Place
falls within another instance of E53 Place"
- CIDOC-CRM: `crm:P59i_is_located_on_or_within` - inverse of has_section
- RiC-O: `rico:isOrWasPartOf` - part of relationship
- Schema.org: `schema:containedInPlace` - place containment
- W3C Org: `org:siteOf` - organization has site
Links the closed space to the main custodian place.
range: CustodianPlace
examples:
- value: "https://nde.nl/ontology/hc/place/nationaal-archief-den-haag"
description: "Closed space within National Archives building"
within_auxiliary_place:
slot_uri: crm:P89_falls_within
description: |
The AuxiliaryPlace that contains this closed space (if at branch/depot).
**Ontology Alignment**:
- CIDOC-CRM: `crm:P89_falls_within` - spatial containment
- RiC-O: `rico:hasOrHadPhysicalLocation` - physical location relationship
- Schema.org: `schema:containedInPlace` - place containment
Use this instead of within_place when closed space is at a
secondary location (depot, branch, off-site facility).
range: AuxiliaryPlace
examples:
- value: "https://nde.nl/ontology/hc/aux-place/rijksmuseum-depot-amersfoort"
description: "Closed space at off-site depot"
capacity:
slot_uri: crm:P43_has_dimension
description: |
Capacity or size of the closed space.
**Ontology Alignment**:
- CIDOC-CRM: `crm:P43_has_dimension` - "describes a dimension that an
instance of E70 Thing has"
- RiC-O: `rico:hasExtent` - size or duration
- Schema.org: `schema:floorSize` - for floor area
May be expressed as:
- Square meters
- Linear meters of shelving
- Number of items
- Number of persons (for reading rooms)
range: string
examples:
- value: "250 m², 3,000 linear meters shelving"
description: "Vault capacity"
- value: "12 researcher seats"
description: "Reading room capacity"
valid_from:
slot_uri: schema:validFrom
description: |
Date when this closed space became operational with current restrictions.
**Ontology Alignment**:
- Schema.org: `schema:validFrom` - beginning of validity period
- CIDOC-CRM: Aligns with `crm:P82a_begin_of_the_begin` for fuzzy dates
- RiC-O: `rico:beginningDate` - start date
range: date
valid_to:
slot_uri: schema:validThrough
description: |
Date when this closed space was decommissioned or restrictions changed.
NULL if still active with current restrictions.
**Ontology Alignment**:
- Schema.org: `schema:validThrough` - end of validity period
- CIDOC-CRM: Aligns with `crm:P82b_end_of_the_end` for fuzzy dates
- RiC-O: `rico:endDate` - end date
range: date
comments:
- "ClosedSpace represents physically restricted areas within heritage institutions"
- "Primary alignment: CIDOC-CRM E27_Site with access restriction semantics"
- "Close alignment: RiC-O PhysicalLocation for archival contexts"
- "Close alignment: W3C Org Site for organizational premises"
- "Links to CustodianPlace (main building) or AuxiliaryPlace (branches/depots)"
- "Access restrictions defined via AccessPolicy relationship (PREMIS policy)"
- "Supports DimArchive concept (archives with access restrictions)"
- "Contains Storage and/or Collection instances via CIDOC-CRM P46/RiC-O containment"
- "Environmental controls align with PREMIS environment characteristics"
- "Temporal validity uses Schema.org validFrom/validThrough pattern"
see_also:
- "https://www.wikidata.org/wiki/Q3508014"
- "https://www.wikidata.org/wiki/Q17008256"
- "http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E27"
- "https://www.ica.org/standards/RiC/ontology#PhysicalLocation"
- "http://www.loc.gov/premis/rdf/v3/StorageLocation"
- "http://www.w3.org/ns/org#Site"
examples:
- value:
closed_space_id: "https://nde.nl/ontology/hc/closed-space/na-rare-book-vault"
space_name: "Rare Book Vault"
space_description: |
Climate-controlled vault housing the National Archives' most valuable
rare books and manuscripts from the 12th-18th centuries.
restriction_type: "SECURITY"
restriction_reason: |
Contains irreplaceable items of national cultural significance.
Access restricted to prevent theft and minimize handling damage.
security_level: "HIGH"
environmental_controls: "18°C ±1°C, 50% RH ±5%, HEPA filtration, inert gas fire suppression"
contains_collections:
- "https://nde.nl/ontology/hc/collection/na-medieval-manuscripts"
- "https://nde.nl/ontology/hc/collection/na-incunabula"
capacity: "150 m², 800 linear meters shelving"
within_place: "https://nde.nl/ontology/hc/place/nationaal-archief-den-haag"
description: "National Archives rare book vault"
- value:
closed_space_id: "https://nde.nl/ontology/hc/closed-space/eye-film-cold-vault"
space_name: "Film Cold Vault A"
space_description: |
Refrigerated vault for nitrate and acetate film preservation.
Maintained at sub-zero temperatures to prevent vinegar syndrome.
restriction_type: "PRESERVATION"
restriction_reason: |
Extreme cold temperatures required for film preservation.
Temperature fluctuations from access damage film.
security_level: "ENHANCED"
environmental_controls: "-18°C, 30% RH, dark, nitrogen-enriched atmosphere"
hazards:
- "Extreme cold - protective equipment required"
- "Nitrate film - fire hazard"
- "Low oxygen environment"
contains_storage:
- "https://nde.nl/ontology/hc/storage/eye-nitrate-storage"
capacity: "50,000 film cans"
within_auxiliary_place: "https://nde.nl/ontology/hc/aux-place/eye-depot-amsterdam"
description: "EYE Filmmuseum cold storage vault"
- value:
closed_space_id: "https://nde.nl/ontology/hc/closed-space/na-classified-reading"
space_name: "Classified Records Reading Room"
space_description: |
Secure reading room for accessing government records with
restricted access classifications.
restriction_type: "CONFIDENTIALITY"
restriction_reason: |
Contains records closed under Public Records Act provisions.
Access requires security clearance and originating agency approval.
access_policy: "https://nde.nl/ontology/hc/policy/security-clearance-required"
security_level: "HIGH"
capacity: "8 researcher seats, supervised"
within_place: "https://nde.nl/ontology/hc/place/nationaal-archief-den-haag"
description: "Classified records reading room"
# Slot definitions with ontology alignment
slots:
closed_space_id:
description: |
Unique identifier for closed space.
Aligned with dcterms:identifier.
slot_uri: dcterms:identifier
range: uriorcurie
space_name:
description: |
Name of the closed space.
Aligned with crm:P1_is_identified_by (appellation).
slot_uri: crm:P1_is_identified_by
range: string
space_description:
description: |
Description of the space.
Aligned with crm:P3_has_note (textual description).
slot_uri: crm:P3_has_note
range: string
restriction_type:
description: |
Type of restriction (SECURITY, PRESERVATION, OPERATIONAL, etc.).
Aligned with crm:P2_has_type.
slot_uri: crm:P2_has_type
range: string
restriction_reason:
description: |
Reason for restriction.
Aligned with crm:P3_has_note / skos:note.
slot_uri: skos:note
range: string
environmental_controls:
description: |
Environmental control features (climate, lighting, air quality).
Aligned with schema:amenityFeature.
slot_uri: schema:amenityFeature
range: string
contains_storage:
description: |
Storage facilities within this closed space.
Aligned with crm:P46_is_composed_of.
slot_uri: crm:P46_is_composed_of
range: Storage
multivalued: true
contains_collections:
description: |
Collections housed within this closed space.
Aligned with rico:containsOrContained.
slot_uri: rico:containsOrContained
range: Collection
multivalued: true
hazards:
description: |
Hazards or safety concerns in the space.
Aligned with schema:warning.
slot_uri: schema:warning
range: string
multivalued: true
within_place:
description: |
CustodianPlace containing this closed space.
Aligned with crm:P89_falls_within.
slot_uri: crm:P89_falls_within
range: CustodianPlace
within_auxiliary_place:
description: |
AuxiliaryPlace containing this closed space (for branches/depots).
Aligned with crm:P89_falls_within.
slot_uri: crm:P89_falls_within
range: AuxiliaryPlace
capacity:
description: |
Capacity or size of the closed space.
Aligned with crm:P43_has_dimension.
slot_uri: crm:P43_has_dimension
range: string