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

159 lines
5.8 KiB
YAML

id: https://nde.nl/ontology/hc/class/CustodianName
name: CustodianName
title: Custodian Name Class
imports:
- linkml:types
- Custodian
- CustodianObservation
- ReconstructionActivity
- TimeSpan
classes:
CustodianName:
class_uri: skos:Concept
description: >-
Standardized emic (insider) name DERIVED FROM CustodianObservation(s).
CRITICAL: CustodianName is NOT a subclass of CustodianObservation!
- CustodianObservation = Evidence seen in sources (input)
- CustodianName = Standardized interpretation (output)
- Relationship: CustodianName prov:wasDerivedFrom CustodianObservation
CustodianName represents the CANONICAL LABEL - the standardized form
accepted by the custodian itself for public identification.
IMPORTANT: CustodianName ≠ Legal Name
- CustodianName = How custodian presents itself (emic, operational)
- Legal Name = Formal registered name (in CustodianLegalStatus)
- Example: "Rijksmuseum" (emic) vs "Stichting Rijksmuseum" (legal)
Can be generated by:
1. ReconstructionActivity (formal entity resolution) - was_generated_by link
2. Direct extraction (simple standardization) - no was_generated_by link
exact_mappings:
- skos:prefLabel
- schema:name
- foaf:name
close_mappings:
- rdfs:label
- dcterms:title
- org:legalName
- tooi:officieleNaamInclSoort
- rico:name
related_mappings:
- skos:altLabel
- schema:alternateName
slots:
- emic_name
- name_language
- standardized_name
- endorsement_source
- name_authority
- valid_from
- valid_to
- name_validity_period
- supersedes
- superseded_by
- was_derived_from
- was_generated_by
- refers_to_custodian
slot_usage:
emic_name:
slot_uri: skos:prefLabel
description: >-
The observed name as the custodian refers to itself in source materials,
preserving the custodian's own naming convention. This is descriptive
data, not an identifier - the custodian is identified by its hc_id.
range: string
required: true
name_language:
slot_uri: dcterms:language
description: >-
The language or locale code (ISO 639-1 or BCP 47) of the emic name.
Examples: 'nl', 'en', 'pt-BR'
range: string
pattern: "^[a-z]{2}(-[A-Z]{2})?$"
standardized_name:
slot_uri: skos:prefLabel
description: "The canonical emic name accepted by custodian itself (REQUIRED)"
range: string
required: true
endorsement_source:
slot_uri: prov:hadPrimarySource
description: "Source proving custodian acceptance of this name (REQUIRED)"
range: uriorcurie
required: true
name_authority:
slot_uri: prov:wasAttributedTo
description: "Authority that authorized this name"
range: string
valid_from:
slot_uri: schema:validFrom
description: "Date when this name became official/valid"
range: date
valid_to:
slot_uri: schema:validUntil
description: "Date when this name ceased to be valid (null if current)"
range: date
name_validity_period:
slot_uri: crm:P4_has_time-span
description: >-
Temporal period during which this name was valid (with fuzzy boundaries).
CIDOC-CRM: P4_has_time-span links to E52_Time-Span for uncertain validity periods.
Use this when name validity dates are uncertain:
- "Name adopted sometime in the 1920s"
- "Name changed around 1950"
- "Name used from approximately 1800 to 1850"
For precise dates, use valid_from/valid_to instead.
range: TimeSpan
examples:
- value:
begin_of_the_begin: "1920-01-01"
end_of_the_begin: "1929-12-31"
begin_of_the_end: "1945-01-01"
end_of_the_end: "1955-12-31"
description: "Name adopted sometime in the 1920s, changed around 1950"
supersedes:
slot_uri: dcterms:replaces
description: "Previous CustodianName replaced by this one"
range: CustodianName
superseded_by:
slot_uri: dcterms:isReplacedBy
description: "Subsequent CustodianName that replaced this name"
range: CustodianName
was_derived_from:
slot_uri: prov:wasDerivedFrom
description: >-
CustodianObservation(s) from which this name was derived (REQUIRED).
PROV-O: wasDerivedFrom establishes observation→name derivation.
A name can be derived from multiple observations through consolidation:
- "Rijks" (letterhead) + "Rijksmuseum Amsterdam" (ISIL) → "Rijksmuseum"
This is NOT inheritance (is_a) but transformation (derived_from).
range: CustodianObservation
multivalued: true
required: true
was_generated_by:
slot_uri: prov:wasGeneratedBy
description: >-
ReconstructionActivity that generated this standardized name (optional).
If present: Name created through formal entity resolution process
If null: Name extracted directly without reconstruction activity
PROV-O: wasGeneratedBy links Entity (CustodianName) to generating Activity.
range: ReconstructionActivity
required: false
refers_to_custodian:
slot_uri: dcterms:references
description: >-
The Custodian hub that this name identifies (REQUIRED).
Links the standardized name back to the hub it represents.
The hub may also link back via skos:prefLabel if this is the preferred name.
range: Custodian
required: true