glam/schemas/20251121/linkml/modules/classes/Collection.yaml
kempersc f7bf1cc5ae Refactor schema slots and classes
- Deleted obsolete slot definitions: statement_summary, statement_text, statement_type, status_name, supersede_articles, supersede_condition, supersede_name, temporal_dynamics, total_amount, typical_contents, use_cases, was_acquired_through, was_fetched_at, was_retrieved_at.
- Updated existing slot definitions for states_or_stated to enhance clarity and structure.
- Introduced new classes: Article, ConditionofAccess, FinancialStatementType, MaximumQuantity, Series, Summary, Type, and their respective slots to improve schema organization and usability.
- Added new slots: changes_or_changed_through, has_or_had_condition_of_access, has_or_had_heritage_type, is_or_was_part_of_series, is_or_was_retrieved_at, maximum_of_maximum to capture additional metadata and relationships.
2026-01-30 00:29:31 +01:00

421 lines
18 KiB
YAML

id: https://nde.nl/ontology/hc/class/Collection
name: collection_class
title: Collection Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
rico: https://www.ica.org/standards/RiC/ontology#
bf: http://id.loc.gov/ontologies/bibframe/
dcterms: http://purl.org/dc/terms/
premis: http://www.loc.gov/premis/rdf/v3/
prov: http://www.w3.org/ns/prov#
schema: http://schema.org/
skos: http://www.w3.org/2004/02/skos/core#
wd: http://www.wikidata.org/entity/
edm: http://www.europeana.eu/schemas/edm/
default_prefix: hc
imports:
- linkml:types
- ./CustodianCollection
- ./CollectionType
- ./AccessPolicy
- ./TimeSpan
- ./FindingAid
- ./ExhibitedObject
- ./CurationActivity
- ../slots/has_or_had_policy_reference
- ../slots/is_or_was_acquired_through
- ./AcquisitionEvent
- ./AcquisitionMethod
- ../slots/has_arrangement
- ../slots/has_or_had_description
- ../slots/has_or_had_identifier
- ./Identifier
- ../slots/has_or_had_label
- ./Label
- ../slots/has_or_had_curation_activity
- ../slots/custodial_history
- ../slots/is_or_was_instantiated_by
- ./DigitalInstantiation
- ../slots/extent
- ../slots/has_or_had_quantity
- ../slots/has_or_had_finding_aid
- ../slots/item
- ../slots/is_or_was_sub_collection_of
- ../slots/part_of_custodian_collection
- ../slots/has_or_had_provenance
- ./Provenance
- ./Description
- ../slots/record_set_type
- ../slots/has_or_had_sub_collection
- ../slots/is_or_was_categorized_as
- ../slots/has_or_had_content
- ./Content
- ../slots/temporal_extent
- ../slots/has_or_had_type
- ../slots/specificity_annotation
- ../slots/has_or_had_score
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
classes:
Collection:
class_uri: rico:RecordSet
description: "Specific, inventoried heritage holdings with fine-grained cataloguing detail.\n\n**CRITICAL DISTINCTION**:\n\n| CustodianCollection | Collection (THIS CLASS) |\n|---------------------|------------------------|\n| Abstract/nominal reference | Specific, catalogued holdings |\n| Entire collection of a Custodian | Individual fonds, series, or named collections |\n| Vague (\"the museum's collection\") | Precise (\"the Van Gogh correspondence collection\") |\n| Top-level container | Nested within CustodianCollection |\n| crm:E78_Curated_Holding | rico:RecordSet |\n\n1. **RiC-O (Records in Contexts)**:\n - `rico:RecordSet` - \"A record set is a group of record(s), made and/or assembled\n by one or more agent(s), characterized by a common provenance and/or by being\n received/maintained by the same custodian.\"\n - Enables: series, fonds, sub-fonds, sub-series hierarchies\n - Properties: rico:hasRecordSetType, rico:hasExtent, rico:hasTemporalCoverage\n\n2. **CIDOC-CRM**:\n\
\ - Close mapping to crm:E78_Curated_Holding (at specific level)\n - crm:E24_Physical_Human-Made_Thing for physical collections\n\n3. **BIBFRAME**:\n - bf:Collection for library special collections\n - bf:Item for individual physical items within\n\n4. **Europeana Data Model**:\n - edm:ProvidedCHO for cultural heritage objects\n - edm:hasView for digital representations\n\n**HIERARCHICAL STRUCTURE**:\n\n```\nCustodian (hub)\n \u2502\n \u2514\u2500\u2500 CustodianCollection (aspect - abstract/nominal)\n \u2502\n \u2514\u2500\u2500 Collection (THIS CLASS - specific holdings)\n \u251C\u2500\u2500 CollectionType (classification)\n \u251C\u2500\u2500 AccessPolicy (access restrictions)\n \u251C\u2500\u2500 has_or_had_sub_collection \u2192 Collection[] (nested hierarchy)\n \u2502 \u2514\u2500\u2500 Collection (sub-fonds, series, etc.)\n \u2514\u2500\u2500 items \u2192 ExhibitedObject[] (individual\
\ objects)\n```\n\n**USE CASES**:\n\n1. **Archival Fonds**:\n ```yaml\n Collection:\n collection_name: \"Records of the Dutch East India Company (VOC)\"\n collection_type: FONDS\n record_set_type: rico:Fonds\n extent: \"1,250 linear meters\"\n temporal_coverage: \"1602-1799\"\n provenance: \"Dutch East India Company (VOC)\"\n ```\n\n2. **Museum Named Collection**:\n ```yaml\n Collection:\n collection_name: \"Drucker-Fraser Collection\"\n collection_type: NAMED_COLLECTION\n extent: \"125 artworks\"\n acquisition_method: \"Bequest (1937)\"\n access_policy: OPEN_ACCESS\n ```\n\n3. **Library Special Collection**:\n ```yaml\n Collection:\n collection_name: \"Medieval Manuscripts Collection\"\n collection_type: SPECIAL_COLLECTION\n bf_collection_type: bf:Collection\n extent: \"342 manuscripts, 12th-15th century\"\n temporal_coverage: \"1100-1500\"\n ```\n\n**PROVENANCE TRACKING**:\n\nCollection provenance is\
\ tracked through:\n- `provenance_statement` - Narrative provenance description\n- `custodial_history` - Chain of custody\n- `acquisition_method` - How acquired (purchase, donation, transfer, bequest)\n- `acquisition_date` - When acquired\n- `acquisition_source` - From whom acquired\n\n**ACCESS CONTROL**:\n\nCollections link to AccessPolicy for:\n- Open access (publicly available)\n- Restricted access (researchers only)\n- Closed access (temporary closure, embargo)\n- Partial access (portions available)\n"
exact_mappings:
- rico:RecordSet
- wikidata:Q2668072
close_mappings:
- crm:E78_Curated_Holding
- bf:Collection
- edm:ProvidedCHO
related_mappings:
slots:
- has_or_had_policy_reference
- is_or_was_acquired_through
- has_arrangement
- has_or_had_description
- has_or_had_identifier
- has_or_had_label
- is_or_was_categorized_as
- has_or_had_curation_activity
- custodial_history
- has_or_had_type
- is_or_was_instantiated_by
- extent
- has_or_had_quantity
- has_or_had_finding_aid
- item
- is_or_was_sub_collection_of
- part_of_custodian_collection
- has_or_had_provenance
- record_set_type
- specificity_annotation
- has_or_had_sub_collection
- is_or_was_categorized_as
- has_or_had_score
- has_or_had_content
- temporal_extent
slot_usage:
has_or_had_identifier:
description: 'MIGRATED from collection_id per slot_fixes.yaml (Rule 53, 2026-01-18).
Unique identifier for this collection using Identifier class.
Use identifier_scheme: COLLECTION_URI for collection URI identifiers.
'
range: Identifier
inlined: true
required: true
identifier: true
is_or_was_instantiated_by:
range: DigitalInstantiation
multivalued: true
inlined: true
description: 'Digital surrogates (URL) or digitization status.
MIGRATED from digital_surrogate_url and digitization_status (2026-01-25).
'
examples:
- value:
has_or_had_status:
has_or_had_label: PARTIAL
has_or_had_url:
url_value: https://www.nationaalarchief.nl/onderzoeken/archief/1.04.02/download
description: Partial digitization with download link
has_or_had_label:
description: 'MIGRATED from collection_name per slot_fixes.yaml (Rule 53/56, 2026-01-18).
The name of this specific collection (e.g., "Records of the Dutch East India Company (VOC)").
Uses Label class for structured labeling.
'
range: Label
inlined: true
required: true
examples:
- value:
has_or_had_label: Records of the Dutch East India Company (VOC)
description: Archival fonds name
has_or_had_description:
description: 'MIGRATED from collection_description per slot_fixes.yaml (Rule 53/56, 2026-01-18).
Narrative description of the collection''s contents, 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 VOC archives comprise the administrative records of the Dutch East India Company from its founding in 1602 until its dissolution in 1799. The fonds includes correspondence, resolutions, journals, accounts, ship's logs, and maps documenting trade relations across Asia.
description_type: collection_description
description: VOC archival fonds description
record_set_type:
range: uriorcurie
examples:
- value: rico:Fonds
description: Archival fonds
extent:
range: string
examples:
- value: 1,250 linear meters
description: Archival extent
has_or_had_quantity:
range: integer
examples:
- value: 125
description: 125 artworks
has_or_had_content:
range: Content
multivalued: true
inlined_as_list: true
description: 'Content scope of the collection including temporal, spatial, and topical coverage.
MIGRATED from temporal_coverage per slot_fixes.yaml (Rule 53/56, 2026-01-16).
Uses Content class which includes temporal_extent for time periods.
'
examples:
- value:
has_or_had_label: VOC Trade Records
temporal_extent:
begin_of_the_begin: '1602-01-01'
end_of_the_end: '1799-12-31'
description: VOC records content with temporal coverage
is_or_was_categorized_as:
description: 'MIGRATED from subject_area (2026-01-17) and collection_type_ref (2026-01-18) per slot_fixes.yaml (Rule 53/56).
Unified categorization slot for:
1. Collection type classification (CollectionType instances) - REQUIRED
2. Subject area categorization (string values) - OPTIONAL
Uses polymorphic range (uriorcurie) allowing both CollectionType references and subject strings.
The first value SHOULD be a CollectionType for RiC-O RecordSetType alignment.
'
range: uriorcurie
multivalued: true
required: true
examples:
- value: https://nde.nl/ontology/hc/collection-type/fonds
description: Archival fonds (CollectionType)
has_or_had_provenance:
description: 'Narrative provenance description for this collection.
MIGRATED from provenance_statement 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_statement" to indicate RiC-O history format.
'
required: false
range: Provenance
inlined: true
examples:
- value:
has_or_had_description:
- description_text: The VOC archives were transferred to the Dutch state upon the company's dissolution in 1799. They were initially held by the Ministry of Colonies, then transferred to the Algemeen Rijksarchief (now Nationaal Archief) in 1856.
description_type: provenance_statement
description: VOC archives provenance narrative
custodial_history:
range: string
multivalued: true
examples:
- value:
- Dutch East India Company (1602-1799)
- Ministry of Colonies (1799-1856)
- Algemeen Rijksarchief (1856-2002)
- Nationaal Archief (2002-present)
description: VOC records custodial history
is_or_was_acquired_through:
description: 'Acquisition event for this collection.
MIGRATED from has_acquisition_source, has_acquisition_method, has_acquisition_date per Rule 53.
Uses AcquisitionEvent class.
'
range: AcquisitionEvent
multivalued: true
inlined: true
examples:
- value:
has_or_had_origin:
has_or_had_label: Ministry of Colonies
has_or_had_method:
has_or_had_label: TRANSFER
temporal_extent:
begin_of_the_begin: '1856-01-01'
description: Source of VOC archives transfer
has_or_had_policy:
range: AccessPolicy
examples:
- value: https://nde.nl/ontology/hc/access-policy/open-access
description: Publicly accessible
has_arrangement:
range: string
examples:
- value: Organized by provenance, then chronologically within each creating office
description: Archival has_arrangement
has_or_had_finding_aid:
range: FindingAid
multivalued: true
inlined_as_list: true
examples:
- value:
- finding_aid_id: https://nde.nl/finding-aid/voc-inventory
title: VOC Inventory
finding_aid_type_ref: ArchivalInventory
url: https://www.nationaalarchief.nl/onderzoeken/archief/1.04.02
description: VOC finding aid
digitization_status:
range: string
examples:
- value: PARTIAL
description: 30% digitized
digital_surrogate_url:
range: uri
multivalued: true
examples:
- value: https://www.nationaalarchief.nl/onderzoeken/archief/1.04.02/download
description: Digital scans of VOC records
is_or_was_sub_collection_of:
range: Collection
description: 'Parent collection in hierarchical arrangement.
MIGRATED from parent_collection slot per slot_fixes.yaml (Rule 53, 2025-01-15).
'
examples:
- value: https://nde.nl/ontology/hc/collection/nationaal-archief-voc-fonds
description: Series within VOC fonds
has_or_had_sub_collection:
range: Collection
multivalued: true
inlined_as_list: true
examples:
- value:
- has_or_had_label:
has_or_had_label: Hoge Regering Batavia
collection_type_ref: series
description: Series within VOC fonds
item:
range: ExhibitedObject
multivalued: true
inlined: false
examples:
- value:
- https://nde.nl/ontology/hc/object/mauritshuis-girl-pearl-earring
description: Paintings in Mauritshuis collection
has_or_had_curation_activity:
range: CurationActivity
multivalued: true
inlined: false
examples:
- value:
- https://nde.nl/ontology/hc/activity/nationaal-archief-voc-digitization-2024
description: Curation activities for VOC fonds
part_of_custodian_collection:
range: CustodianCollection
required: true
examples:
- value: https://nde.nl/ontology/hc/custodian-collection/nationaal-archief
description: Part of Nationaal Archief's overall collection
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
examples:
- value:
begin_of_the_begin: '1856-01-01'
description: Collection acquired in 1856 (no end date)
has_or_had_type:
equals_expression: '["hc:GalleryType", "hc:LibraryType", "hc:ArchiveOrganizationType", "hc:MuseumType", "hc:BioCustodianType", "hc:HolySacredSiteType"]'
comments:
- Collection represents SPECIFIC, CATALOGUED holdings (not abstract nominal references)
- Distinct from CustodianCollection which is abstract/nominal
- Enables fine-grained description using RiC-O, CIDOC-CRM, BIBFRAME ontologies
- "Supports hierarchical nesting (fonds \u2192 series \u2192 sub-series)"
- Links to CollectionType for classification and AccessPolicy for access control
- Provenance tracking includes custodial_history, acquisition_method, has_acquisition_source
- finding_aids replaces the simple finding_aid_url slot (2025-12-09)
- items slot links to ExhibitedObject[] for individual collection objects (2026-01)
- curation_activities slot links to CurationActivity[] for ongoing management (2026-01)
see_also:
- https://www.ica.org/standards/RiC/ontology#RecordSet
- http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E78
examples:
- value:
has_or_had_identifier:
identifier_scheme: COLLECTION_URI
identifier_value: https://nde.nl/ontology/hc/collection/nationaal-archief-voc-fonds
has_or_had_label:
has_or_had_label: Records of the Dutch East India Company (VOC)
has_or_had_description:
- description_text: The VOC archives comprise the administrative records of the Dutch East India Company from its founding in 1602 until its dissolution in 1799.
description_type: collection_description
record_set_type: rico:Fonds
extent: 1,250 linear meters
has_or_had_content:
is_or_was_categorized_as:
- https://nde.nl/ontology/hc/collection-type/fonds
- Colonial trade
- Maritime history
- Dutch East Indies
has_or_had_provenance:
has_or_had_description:
- description_text: Transferred to the Dutch state upon the company's dissolution in 1799.
description_type: provenance_statement
is_or_was_acquired_through:
- has_or_had_origin:
has_or_had_label: Ministry of Colonies
has_or_had_method:
has_or_had_label: TRANSFER
temporal_extent:
begin_of_the_begin: '1856-01-01'
has_or_had_policy: https://nde.nl/ontology/hc/access-policy/open-access
arrangement: Organized by provenance, then chronologically
has_or_had_finding_aid:
- finding_aid_id: https://nde.nl/finding-aid/nationaal-archief-voc-inventory
title: Inventory of the Records of the Dutch East India Company (VOC)
finding_aid_type_ref: ArchivalInventory
url: https://www.nationaalarchief.nl/onderzoeken/archief/1.04.02
format:
- EAD
- HTML
language:
- nl
- en
part_of_custodian_collection: https://nde.nl/ontology/hc/custodian-collection/nationaal-archief
description: VOC archival fonds at Nationaal Archief
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"
custodian_types_rationale: Universal utility concept