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

285 lines
9.6 KiB
YAML

id: https://nde.nl/ontology/hc/class/CustodianCollection
name: custodian_collection_class
title: CustodianCollection Class
imports:
- linkml:types
- ./Custodian
- ./CustodianObservation
- ./ReconstructionActivity
- ./TimeSpan
- ./OrganizationalStructure
- ./CollectionManagementSystem
- ./ReconstructedEntity
- ../slots/preservation_level
- ../slots/is_or_was_instantiated_by
- ./DigitalInstantiation
- ../slots/has_or_had_label
- ./Label
- ../slots/has_or_had_description
- ./CollectionContent
- ./CollectionContentType
- ./CollectionContentTypes
- ../slots/has_or_had_scope
- ./CollectionScope
- ../slots/has_or_had_content
- ./Content
- ../slots/extent
- ../slots/managing_unit
- ../slots/temporal_extent
- ../slots/refers_to_custodian
- ../slots/is_or_was_derived_from
- ../slots/has_or_had_arrangement
- ../classes/ArrangementType
- ../classes/ArrangementTypes
- ../slots/is_or_was_generated_by
- ../slots/has_or_had_type
- ../slots/custody_history
- ../slots/id
- ../slots/has_or_had_managed_by_cm
- ../slots/has_or_had_provenance
- ./Provenance
- ./Description
- ../slots/specificity_annotation
- ../slots/has_or_had_score
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ../slots/has_or_had_access_right
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
dcterms: http://purl.org/dc/terms/
rico: https://www.ica.org/standards/RiC/ontology#
prov: http://www.w3.org/ns/prov#
time: http://www.w3.org/2006/time#
org: http://www.w3.org/ns/org#
premis: http://www.loc.gov/premis/rdf/v3/
bf: http://id.loc.gov/ontologies/bibframe/
classes:
CustodianCollection:
is_a: ReconstructedEntity
class_uri: crm:E78_Curated_Holding
description: 'Represents a heritage collection as a multi-aspect entity with independent temporal lifecycle.
Collections are curatedHoldings (CIDOC-CRM E78) with provenance tracking, custody history,
and organizational management relationships.
Phase 4 (2025-11-22): Added managing_unit bidirectional relationship with OrganizationalStructure.
Phase 8 (2025-11-22): Added validation constraints via slot_usage.
Phase 9 (2025-11-26): Added PREMIS mappings for digital preservation (digital_surrogates,
digitization_status, preservation_level).
'
close_mappings:
- premis:IntellectualEntity
- rico:RecordSet
- bf:Collection
related_mappings:
- premis:relationship
- dcterms:hasPart
slots:
- has_or_had_access_right
- has_or_had_arrangement_system
- has_or_had_description
- has_or_had_label
- has_or_had_scope
- has_or_had_type
- custody_history
- is_or_was_instantiated_by
- extent
- id
- has_or_had_managed_by_cm
- managing_unit
- preservation_level
- has_or_had_provenance
- refers_to_custodian
- specificity_annotation
- has_or_had_score
- has_or_had_content
- temporal_extent
- is_or_was_derived_from
- is_or_was_generated_by
slot_usage:
has_or_had_label:
description: 'MIGRATED from collection_name per slot_fixes.yaml (Rule 53/56, 2026-01-18).
The name of this custodian collection.
Uses Label class for structured labeling.
'
range: Label
inlined: true
required: true
pattern: ^.{1,500}$
managing_unit:
range: OrganizationalStructure
required: false
temporal_extent:
description: 'Collection validity period using CIDOC-CRM TimeSpan.
MIGRATED from valid_from + valid_to per slot_fixes.yaml (Rule 53).
'
range: TimeSpan
inlined: true
required: false
id:
identifier: true
required: true
refers_to_custodian:
range: Custodian
required: true
has_or_had_description:
description: 'MIGRATED from collection_description per slot_fixes.yaml (Rule 53/56, 2026-01-18).
Narrative description of the custodian collection''s scope and significance.
Uses Description class with description_type for type discrimination.
Use description_type: "collection_description" to indicate collection narrative format.
'
range: Description
inlined: true
required: false
multivalued: true
inlined_as_list: true
examples:
- value:
description_text: The Nationaal Archief holdings comprise over 137 km of archival records documenting Dutch government and society from the medieval period to the present.
description_type: collection_description
description: National archive custodian collection description
has_or_had_scope:
description: 'MIGRATED from collection_scope per slot_fixes.yaml (Rule 53/56, 2026-01-18).
Subject scope or thematic focus of the collection.
Uses CollectionScope class for structured scope representation.
Use scope_type: "collection_scope" to indicate collection scope format.
'
range: CollectionScope
inlined: true
required: false
examples:
- value:
scope_description: 17th-century Dutch painting
scope_type: collection_scope
description: Art collection scope example
- value:
scope_description: Municipal government records, 1578-present
scope_type: archival_scope
description: Archival collection scope example
has_or_had_content:
range: CollectionContent
multivalued: true
inlined: true
inlined_as_list: true
required: false
description: "Content held by this collection with typed categorization.\nMIGRATED from:\n- temporal_coverage per slot_fixes.yaml (Rule 53/56, 2026-01-16)\n- collection_type per slot_fixes.yaml (Rule 53, 2026-01-22)\n\nCollectionContent unifies content description with type classification:\n- content_description: Free-text description of the content\n- content_date_range: Temporal coverage (e.g., \"1602-1799\")\n- content_extent: Size/extent of content\n- has_or_had_type \u2192 CollectionContentType: Type classification (Archival, Library, Art, etc.)\n"
examples:
- value:
content_description: Colonial period administrative records
content_date_range: 1602-1800
has_or_had_type:
- type_label: Archival
description: Colonial archives content with type
- value:
content_description: Religious art and liturgical objects
content_extent: 450 objects
has_or_had_type:
- type_label: Art
- type_label: Liturgical
description: Religious heritage content with multiple types
extent:
range: string
required: false
has_or_had_access_right:
range: string
required: false
is_or_was_instantiated_by:
range: DigitalInstantiation
multivalued: true
inlined: true
description: 'Digital surrogates or digitization status.
MIGRATED from digital_surrogate and digitization_status (2026-01-25).
'
preservation_level:
range: string
required: false
examples:
- value: FULL
description: Long-term preservation with format migration
- value: BIT_LEVEL
description: Bit-level preservation in institutional repository
has_or_had_managed_by_cm:
range: CollectionManagementSystem
multivalued: true
required: false
examples:
- value: https://nde.nl/ontology/hc/cms/rijksmuseum-adlib
description: Collection managed by Rijksmuseum Adlib CMS
has_or_had_arrangement:
range: ArrangementType
required: false
description: 'Arrangement system used for this collection (e.g. ProvenanceBased, SubjectBased).
MIGRATED from has_or_had_arrangement_system per Rule 53.
Uses ArrangementType class hierarchy.
'
examples:
- value:
has_or_had_type: ProvenanceBasedArrangement
has_or_had_description: Arranged by creator/provenance (respect des fonds)
description: Provenance-based arrangement
- value:
has_or_had_type: NumericalArrangement
has_or_had_description: Arranged by accession number
description: Numerical arrangement
has_or_had_provenance:
description: 'Custody transfer notes for this collection.
MIGRATED from provenance_note per slot_fixes.yaml (Rule 53/56, 2026-01-18).
Uses Provenance class with has_or_had_description for text content.
Use description_type: "provenance_note" to indicate custody transfer format.
'
required: false
range: Provenance
inlined: true
examples:
- value:
has_or_had_description:
- description_text: Transferred from private donor 2015; previously held by estate since 1923.
description_type: provenance_note
description: Custody transfer note example
is_or_was_generated_by:
range: ReconstructionActivity
required: false
is_or_was_derived_from:
range: CustodianObservation
multivalued: true
required: true
has_or_had_type:
equals_expression: '["*"]'
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"
custodian_types_rationale: Universal utility concept