glam/archive/schemas/01_name_entity_preliminary.yaml
2025-11-21 22:12:33 +01:00

283 lines
9 KiB
YAML

id: https://w3id.org/heritage/ontology/name
name: heritage-custodian-name
title: Heritage Custodian Nominal Reference (Name) Entity
version: 0.1.0
description: |
Core ontology module defining the **Name** (nominal reference) entity as the
central hub in the Heritage Custodian ontology. A Name represents the linguistic/
textual identifier by which a heritage custodian is known, independent of the
specific organizational, spatial, or collection aspects it may reference.
This entity uses SKOS concepts to enable:
- Multi-aspect modeling (place, organization, collection via properties)
- Temporal tracking of name changes
- Multilingual name variants
- Hypernym/broader concept relationships
**Design Rationale**:
Instead of splitting names into "organization name" and "place name" at the entity
level, we keep a SINGLE Name entity and use properties to express what the name
refers to. This aligns with:
- Wikidata's nominal reference pattern (Q82799)
- SKOS's concept-based approach (skos:Concept)
- CIDOC-CRM's E41 Appellation pattern
**Example**:
"Mansion House" (Q1786933) is a single Name that:
- Refers to a Place (historic building in London)
- Refers to an Organization (official residence of Lord Mayor)
- Has hypernym "mansion" (via skos:broader)
- Has alternative names "The Mansion House", "Lord Mayor's Residence"
license: https://creativecommons.org/publicdomain/zero/1.0/
prefixes:
linkml: https://w3id.org/linkml/
schema: http://schema.org/
skos: http://www.w3.org/2004/02/skos/core#
dct: http://purl.org/dc/terms/
crm: http://www.cidoc-crm.org/cidoc-crm/
wd: http://www.wikidata.org/entity/
wdt: http://www.wikidata.org/prop/direct/
cpov: http://data.europa.eu/m8g/
dbo: http://dbpedia.org/ontology/
heritage: https://w3id.org/heritage/ontology/
default_prefix: heritage
default_range: string
imports:
- linkml:types
classes:
Name:
class_uri: skos:Concept
description: |
A nominal reference (textual identifier) by which a heritage custodian is known.
This entity serves as the central HUB in the heritage custodian ontology, connecting:
- Linguistic/textual identifiers (the name itself)
- Semantic concepts (what the name means - its hypernyms)
- Organizational entities (organizations using this name)
- Spatial entities (places referenced by this name)
- Collection entities (heritage collections associated with this name)
**Ontological Alignment**:
- SKOS: skos:Concept (primary) - Names are concepts in a knowledge organization system
- CIDOC-CRM: crm:E41_Appellation - Names are appellations/identifiers
- Wikidata: wd:Q82799 (name) - Nominal reference
- Schema.org: schema:name (property, not class) - but we model as entity
**Multi-Aspect Pattern**:
A single Name can simultaneously reference multiple aspects via properties:
- name.refers_to_place → Place entity (crm:E27_Site)
- name.refers_to_organization → Organization entity (cpov:PublicOrganisation)
- name.refers_to_collection → Collection entity (crm:E78_Curated_Holding)
**Temporal Independence**:
Names have their own temporal lifecycle, independent of the entities they reference:
- A place may exist for 200 years with 3 different names over time
- An organization may use the same name for 50 years, then rename
- Name changes tracked via name.replaces / name.replaced_by relationships
slots:
- id
- prefLabel
- altLabel
- hiddenLabel
- definition
- scopeNote
- broader
- narrower
- related
- exactMatch
- closeMatch
- wikidata_id
- language
- refers_to_place
- refers_to_organization
- refers_to_collection
- hypernym_concept
- valid_from
- valid_to
- replaces
- replaced_by
- source
- created
- modified
slot_usage:
prefLabel:
description: The preferred/canonical form of the name
required: true
multivalued: false
altLabel:
description: Alternative forms of the name (abbreviations, historical names, translations)
multivalued: true
broader:
description: Broader concepts/hypernyms (e.g., "Mansion House" broader "mansion")
multivalued: true
wikidata_id:
description: Wikidata Q-number for this name (if it exists as a Wikidata entity)
pattern: "^Q[0-9]+$"
slots:
id:
identifier: true
range: uriorcurie
description: Unique identifier for this Name entity (URI)
prefLabel:
slot_uri: skos:prefLabel
description: The preferred (canonical) textual form of the name
range: string
required: true
multivalued: false
altLabel:
slot_uri: skos:altLabel
description: Alternative labels (abbreviations, historical names, translations)
range: string
multivalued: true
hiddenLabel:
slot_uri: skos:hiddenLabel
description: Hidden labels for search purposes (misspellings, deprecated forms)
range: string
multivalued: true
definition:
slot_uri: skos:definition
description: Formal definition of what this name refers to
range: string
scopeNote:
slot_uri: skos:scopeNote
description: Usage notes, context, disambiguation
range: string
broader:
slot_uri: skos:broader
description: Broader concepts (hypernyms) - e.g., "mansion" for "Mansion House"
range: Name
multivalued: true
narrower:
slot_uri: skos:narrower
description: Narrower concepts (hyponyms)
range: Name
multivalued: true
related:
slot_uri: skos:related
description: Related concepts (associative relationships)
range: Name
multivalued: true
exactMatch:
slot_uri: skos:exactMatch
description: Exact matches in other vocabularies (e.g., Wikidata, DBpedia)
range: uriorcurie
multivalued: true
closeMatch:
slot_uri: skos:closeMatch
description: Close matches in other vocabularies
range: uriorcurie
multivalued: true
wikidata_id:
description: Wikidata Q-number for this name entity
range: string
pattern: "^Q[0-9]+$"
language:
slot_uri: dct:language
description: Primary language of this name (ISO 639-1)
range: string
pattern: "^[a-z]{2}$"
refers_to_place:
description: Place(s) that this name refers to (forward reference to Place entity)
range: uriorcurie
multivalued: true
comments:
- Maps to Place entity (crm:E27_Site)
- Example - "Mansion House" refers to the building at Walbrook, London
refers_to_organization:
description: Organization(s) that this name refers to (forward reference to Organization entity)
range: uriorcurie
multivalued: true
comments:
- Maps to Organization entity (cpov:PublicOrganisation)
- Example - "Mansion House" refers to the Lord Mayor's official residence organization
refers_to_collection:
description: Collection(s) that this name refers to (forward reference to Collection entity)
range: uriorcurie
multivalued: true
comments:
- Maps to Collection entity (crm:E78_Curated_Holding)
- Example - "Mansion House Collection" refers to the art/artifact collection
hypernym_concept:
description: Direct hypernym from Wikidata hyponyms_curated.yaml (e.g., "building", "organisation")
range: string
multivalued: true
comments:
- Extracted from hyponyms_curated.yaml 'hypernym' field
- Used to connect Name to top-level ontological categories
valid_from:
slot_uri: schema:validFrom
description: Date from which this name is/was valid
range: date
valid_to:
slot_uri: schema:validUntil
description: Date until which this name was valid (null if still valid)
range: date
replaces:
description: Previous name(s) that this name replaces (name change history)
range: Name
multivalued: true
replaced_by:
description: Subsequent name(s) that replaced this name
range: Name
multivalued: true
source:
slot_uri: dct:source
description: Source of this name (Wikidata, institutional website, archival records)
range: string
created:
slot_uri: dct:created
description: Date this Name entity was created in the knowledge graph
range: datetime
modified:
slot_uri: dct:modified
description: Date this Name entity was last modified
range: datetime
enums:
# Placeholder for future enumerations (e.g., name types, languages)
NameTypeEnum:
description: Types of names (institutional, personal, geographic, etc.)
permissible_values:
INSTITUTIONAL:
description: Name of an institution (museum, archive, library)
GEOGRAPHIC:
description: Name of a place or location
COLLECTION:
description: Name of a collection
PERSONAL:
description: Personal name (for private collectors)
CORPORATE:
description: Corporate/company name