glam/schemas/20251121/linkml/modules/classes/ClosedSpace.yaml
kempersc 626bd3a095 refactor(schemas): apply naming conventions to 261 class files
- Apply Rule 39: RiC-O style hasOrHad*/isOrWas* for temporal slots
- Apply Rule 43: Singular noun convention (keywords → keyword)
- Update slot references to match renamed slot files
- Maintain schema integrity across all class definitions
2026-01-10 15:36:33 +01:00

566 lines
26 KiB
YAML

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
- ../slots/has_or_had_access_policy
- ../slots/capacity
- ../slots/closed_space_id
- ../slots/contains_or_contained_collection
- ../slots/contains_storage
- ../slots/environmental_control
- ../slots/hazard
- ../slots/restriction_reason
- ../slots/restriction_type
- ../slots/space_description
- ../slots/space_name
- ../slots/specificity_annotation
- ../slots/template_specificity
- ../slots/valid_from
- ../slots/valid_to
- ../slots/within_auxiliary_place
- ../slots/within_place
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
classes:
ClosedSpace:
class_uri: crm:E27_Site
description: "Physically restricted or controlled-access space within a heritage\
\ custodian facility.\n\n**DEFINITION**:\n\nClosedSpace represents areas within\
\ heritage institutions that have restricted\naccess due to:\n- Security requirements\
\ (vaults, treasure rooms)\n- Preservation needs (climate-controlled spaces)\n\
- Operational requirements (conservation labs, digitization studios)\n- Safety\
\ concerns (hazmat storage, fragile materials)\n- Privacy/confidentiality (records\
\ with access restrictions)\n\n**ONTOLOGY ALIGNMENT**:\n\nThis class integrates\
\ concepts from multiple heritage ontologies:\n\n**CIDOC-CRM** (crm:E27_Site):\n\
\"Comprises physical things that have a relatively stable position and extent\
\ \nwith respect to the surface of the Earth. Instances of E27 Site are composed\
\ \nof relatively immobile material items and features in a particular configuration\
\ \nat a particular location.\"\n\nClosedSpace is a specialized Site with access\
\ restrictions. Key properties:\n- `crm:P54_has_current_permanent_location`\
\ - Reserved storage location\n- `crm:P55_has_current_location` - Current location\
\ of items\n- `crm:P59_has_section` - Spatial subdivision within building\n\
- `crm:P89_falls_within` - Spatial containment hierarchy\n- `crm:P87_is_identified_by`\
\ - Name/appellation\n\n**RiC-O** (rico:PhysicalLocation):\n\"A place considered\
\ from the point of view of where some archival material is \nor was located.\"\
\ ClosedSpace models the physical location where records with\naccess restrictions\
\ are stored.\n\nKey properties:\n- `rico:hasOrHadPhysicalLocation` - Links\
\ records to physical location\n- `rico:containsOrContained` - Spatial containment\
\ of materials\n- `rico:isOrWasPhysicalLocationOf` - Inverse of above\n\n**PREMIS**\
\ (premis:StorageLocation):\n\"Information needed to retrieve a physical item\
\ from its physical storage \nlocation or a file from the storage system.\"\n\
\nClosedSpace provides the physical context for PREMIS storage locations.\n\n\
**W3C Org** (org:Site):\n\"An office or other premise at which the organization\
\ is located.\"\n\nClosedSpace is a specialized Site with restricted access\
\ characteristics.\nKey properties:\n- `org:hasSite` / `org:siteOf` - Links\
\ organization to site\n- `org:siteAddress` - Physical address\n\n**Schema.org**\
\ (schema:Place):\n\"Entities that have a somewhat fixed, physical extension.\"\
\n\nKey properties:\n- `schema:containedInPlace` - Spatial containment\n- `schema:containsPlace`\
\ - Inverse containment\n- `schema:amenityFeature` - Environmental controls\n\
\n**Wikidata Alignment**:\n- Q3508014 (closed space - restricted/enclosed area)\n\
- Q17008256 (restricted area)\n\n**RELATIONSHIP TO CustodianPlace**:\n\nCustodianPlace\
\ represents the NOMINAL place designation of a custodian.\nClosedSpace represents\
\ PHYSICAL restricted areas within that place.\n\nThe relationship uses `crm:P59_has_section`\
\ (spatial subdivision):\n```\nCustodianPlace (nominal designation)\n │\n \
\ └── P59_has_section → ClosedSpace[] (THIS CLASS)\n ├── restriction_type\
\ (security, preservation, operational)\n ├── has_or_had_access_policy → AccessPolicy\n\
\ ├── P46_is_composed_of → Storage[]\n └── P46_is_composed_of\
\ → Collection[]\n```\n\n**RELATIONSHIP TO AuxiliaryPlace**:\n\nClosedSpace\
\ can exist within any AuxiliaryPlace (branch, depot, etc.):\n\n```\nAuxiliaryPlace\
\ (physical location)\n │\n └── P59_has_section → ClosedSpace[]\n```\n\n**RiC-O\
\ INTEGRATION**:\n\nFor archival contexts, ClosedSpace aligns with rico:PhysicalLocation:\n\
```\nrico:RecordSet\n │\n └── rico:hasOrHadPhysicalLocation → ClosedSpace\
\ (as rico:PhysicalLocation)\n```\n\n**ARCHIVE CONTEXT - DIM ARCHIVE**:\n\n\
The ArchiveTypeEnum value \"DIM_ARCHIVE\" (Q124749604) refers to archives\n\
with access restrictions. ClosedSpace provides the physical manifestation\n\
of these restrictions:\n\n- DimArchive (custodian type) → operates in ClosedSpace\
\ (physical)\n- ClosedSpace → has has_or_had_access_policy → AccessPolicy (rules)\n- AccessPolicy\
\ → applies_to → Collection (what's restricted)\n\n**USE CASES**:\n\n1. **Security\
\ Vault**:\n - restriction_type: SECURITY\n - space_name: \"Rare Book Vault\"\
\n - access_policy: \"Staff-only, appointment required\"\n - contains_collections:\
\ [Rare Manuscripts, Incunabula]\n \n2. **Conservation Lab**:\n - restriction_type:\
\ OPERATIONAL\n - space_name: \"Paper Conservation Laboratory\"\n - access_policy:\
\ \"Conservation staff only\"\n - hazards: \"Chemical treatments in use\"\n\
\ \n3. **Cold Storage**:\n - restriction_type: PRESERVATION\n - space_name:\
\ \"Film Cold Vault\"\n - access_policy: \"Scheduled access only\"\n - contains_storage:\
\ [Film Storage Vault A]\n \n4. **Restricted Reading Room**:\n - restriction_type:\
\ CONFIDENTIALITY\n - space_name: \"Classified Records Reading Room\"\n \
\ - access_policy: \"Security clearance required\"\n - contains_collections:\
\ [Government Classified Records]\n"
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:
- has_or_had_access_policy
- capacity
- closed_space_id
- contains_or_contained_collection
- contains_storage
- environmental_control
- hazard
- restriction_reason
- restriction_type
- security_level
- space_description
- space_name
- specificity_annotation
- template_specificity
- valid_from
- valid_to
- within_auxiliary_place
- within_place
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.\n\n**Ontology Alignment**:\n\
- CIDOC-CRM: `crm:P1_is_identified_by` - \"identifies an instance of E1\
\ CRM Entity\n by means of an E41 Appellation\"\n- Schema.org: `schema:name`\
\ - name of the place\n- RiC-O: `rico:name` - name of entity\n\nNote: Changed\
\ from P87 (which links Place to Appellation) to P1 which is \nmore general\
\ and applies to all CRM entities including Sites.\n"
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.\n\n**Ontology\
\ Alignment**:\n- CIDOC-CRM: `crm:P3_has_note` - \"describes an instance\
\ of E1 CRM Entity by \n means of a text\"\n- Dublin Core: `dcterms:description`\
\ - account of the resource\n- Schema.org: `schema:description` - description\
\ of the item\n\nInclude:\n- Physical characteristics\n- Purpose and function\n\
- Special equipment or features\n- Historical context\n"
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.
has_or_had_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_control:
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.\n\n**Ontology\
\ Alignment**:\n- CIDOC-CRM: `crm:P46_is_composed_of` - \"describes the\
\ decomposition of \n an instance of E18 Physical Thing into discrete,\
\ component parts\"\n- CIDOC-CRM: `crm:P59_has_section` - spatial subdivision\
\ alternative\n- RiC-O: `rico:containsOrContained` - spatial containment\n\
- Schema.org: `schema:containsPlace` - place containment\n\nLinks to Storage\
\ instances that exist within this restricted area.\n"
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_or_contained_collection:
slot_uri: rico:containsOrContained
description: "Collections or collection portions housed in this closed space.\n\
\n**Ontology Alignment**:\n- RiC-O: `rico:containsOrContained` - \"connects\
\ a Record Resource to \n one or more Record Resources that are or were\
\ contained in it\"\n- CIDOC-CRM: `crm:P46_is_composed_of` for part-whole\
\ relationships\n- Schema.org: `schema:hasPart` - indicates item has part\n\
\nNote: May overlap with Storage.stores_collections for collections\nthat\
\ are both in storage AND in a closed space.\n"
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
hazard:
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.\n\n**Ontology\
\ Alignment**:\n- CIDOC-CRM: `crm:P89_falls_within` - \"asserts that an\
\ instance of E53 Place \n falls within another instance of E53 Place\"\
\n- CIDOC-CRM: `crm:P59i_is_located_on_or_within` - inverse of has_section\n\
- RiC-O: `rico:isOrWasPartOf` - part of relationship\n- Schema.org: `schema:containedInPlace`\
\ - place containment\n- W3C Org: `org:siteOf` - organization has site\n\
\nLinks the closed space to the main custodian place.\n"
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.\n\n**Ontology Alignment**:\n\
- CIDOC-CRM: `crm:P43_has_dimension` - \"describes a dimension that an \n\
\ instance of E70 Thing has\"\n- RiC-O: `rico:hasExtent` - size or duration\n\
- Schema.org: `schema:floorSize` - for floor area\n\nMay be expressed as:\n\
- Square meters\n- Linear meters of shelving\n- Number of items\n- Number\
\ of persons (for reading rooms)\n"
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
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
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_or_contained_collection:
- 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
hazard:
- 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\
\ \nrestricted access classifications.\n"
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
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_control:
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_or_contained_collection:
description: |
Collections housed within this closed space.
Aligned with rico:containsOrContained.
slot_uri: rico:containsOrContained
range: Collection
multivalued: true
hazard:
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