1516d509cf
- Added `id`, `name`, `title`, and `description` fields to multiple LinkML class YAML files. - Standardized prefixes across all class definitions. - Introduced a new script `fix_linkml_metadata.py` to automate the addition of metadata to class files. - Updated existing class files to ensure compliance with the new metadata structure.
163 lines
5.1 KiB
YAML
163 lines
5.1 KiB
YAML
id: https://nde.nl/ontology/hc/class/Name
|
|
name: Name
|
|
title: Name
|
|
description: LinkML class definition for Name
|
|
prefixes:
|
|
linkml: https://w3id.org/linkml/
|
|
schema: http://schema.org/
|
|
skos: http://www.w3.org/2004/02/skos/core#
|
|
rico: https://www.ica.org/standards/RiC/ontology#
|
|
wd: http://www.wikidata.org/entity/
|
|
# Name class
|
|
# Created per slot_fixes.yaml revision for: common_name
|
|
#
|
|
# MIGRATION NOTE (2026-01-22): Created as part of common_name migration per Rule 53.
|
|
# Provides structured representation of names with type classification.
|
|
|
|
id: https://nde.nl/ontology/hc/class/Name
|
|
name: name_class
|
|
title: Name Class
|
|
|
|
prefixes:
|
|
linkml: https://w3id.org/linkml/
|
|
hc: https://nde.nl/ontology/hc/
|
|
schema: http://schema.org/
|
|
skos: http://www.w3.org/2004/02/skos/core#
|
|
rdfs: http://www.w3.org/2000/01/rdf-schema#
|
|
dwc: http://rs.tdwg.org/dwc/terms/
|
|
|
|
imports:
|
|
- linkml:types
|
|
- ../metadata
|
|
- ../slots/has_or_had_type
|
|
- ../slots/has_or_had_language
|
|
- ../slots/has_or_had_label
|
|
|
|
default_prefix: hc
|
|
|
|
classes:
|
|
Name:
|
|
class_uri: schema:name
|
|
description: |
|
|
Structured representation of a name associated with an entity.
|
|
|
|
**MIGRATION NOTE** (2026-01-22):
|
|
Created per slot_fixes.yaml migration from `common_name` string
|
|
to structured Name class per Rule 53.
|
|
|
|
**Purpose**:
|
|
Provides structured representation for names including:
|
|
- The name value itself (via has_or_had_label)
|
|
- Name type classification (e.g., common name, scientific name, trade name)
|
|
- Language information
|
|
|
|
**Ontological Alignment**:
|
|
- **Primary** (`class_uri`): `schema:name` - Schema.org name
|
|
- **Close**: `skos:prefLabel`, `rdfs:label` - Label predicates
|
|
- **Related**: `dwc:vernacularName` - Darwin Core vernacular name
|
|
|
|
**Use Cases**:
|
|
- Biological specimens with common/vernacular names in multiple languages
|
|
- Organizations with official names and trading names
|
|
- Places with indigenous and colonial names
|
|
- Products with brand names and generic names
|
|
|
|
**Pattern**:
|
|
```yaml
|
|
has_or_had_name:
|
|
- has_or_had_label: "Dodo"
|
|
has_or_had_type: CommonName
|
|
has_or_had_language: "en"
|
|
- has_or_had_label: "Dronte"
|
|
has_or_had_type: CommonName
|
|
has_or_had_language: "nl"
|
|
```
|
|
|
|
slots:
|
|
- has_or_had_label
|
|
- has_or_had_type
|
|
- has_or_had_language
|
|
|
|
slot_usage:
|
|
has_or_had_label:
|
|
description: The name value itself.
|
|
range: string
|
|
required: true
|
|
examples:
|
|
- value: "Dodo"
|
|
description: English common name
|
|
- value: "Dronte"
|
|
description: Dutch common name
|
|
has_or_had_type:
|
|
description: |
|
|
The type classification of this name.
|
|
Range narrowed to NameType class hierarchy.
|
|
range: NameType
|
|
required: false
|
|
examples:
|
|
- value: CommonName
|
|
description: Vernacular/common name
|
|
- value: ScientificName
|
|
description: Binomial nomenclature
|
|
has_or_had_language:
|
|
description: |
|
|
The language of this name (ISO 639-1 code).
|
|
range: string
|
|
required: false
|
|
examples:
|
|
- value: "en"
|
|
description: English
|
|
- value: "nl"
|
|
description: Dutch
|
|
- value: "la"
|
|
description: Latin (for scientific names)
|
|
|
|
exact_mappings:
|
|
- schema:name
|
|
close_mappings:
|
|
- skos:prefLabel
|
|
- rdfs:label
|
|
related_mappings:
|
|
- dwc:vernacularName
|
|
- schema:alternateName
|
|
|
|
annotations:
|
|
custodian_types: '["*"]'
|
|
custodian_types_rationale: Name structures applicable to all heritage custodian types.
|
|
custodian_types_primary: M
|
|
specificity_score: 0.25
|
|
specificity_rationale: >-
|
|
Broadly applicable - names are fundamental to all heritage entities
|
|
including biological specimens, organizations, places, and objects.
|
|
template_specificity:
|
|
collection_discovery: 0.30
|
|
person_research: 0.35
|
|
general_heritage: 0.25
|
|
migration_info:
|
|
source_slot: common_name
|
|
migration_date: "2026-01-22"
|
|
rule: "Rule 53"
|
|
|
|
comments:
|
|
- "Structured name representation with type and language"
|
|
- "Replaces simple string-valued common_name slot"
|
|
- "Supports multilingual names through has_or_had_language"
|
|
- "Type classification via NameType hierarchy"
|
|
- "Created 2026-01-22 from common_name migration (Rule 53)"
|
|
|
|
examples:
|
|
- value:
|
|
has_or_had_label: "Dodo"
|
|
has_or_had_type: CommonName
|
|
has_or_had_language: "en"
|
|
description: English common name for extinct bird
|
|
- value:
|
|
has_or_had_label: "Dronte"
|
|
has_or_had_type: CommonName
|
|
has_or_had_language: "nl"
|
|
description: Dutch common name for same species
|
|
- value:
|
|
has_or_had_label: "Coast Redwood"
|
|
has_or_had_type: CommonName
|
|
has_or_had_language: "en"
|
|
description: English common name for tree species
|