glam/schemas/20251121/linkml/modules/classes/Country.yaml
kempersc 4319f38c05 Add archived slots for audience size, audience type, and capacity metrics
- Created new YAML files for audience size and audience type slots, defining their properties and annotations.
- Added archived capacity slots including cubic meters, linear meters, item count, and descriptions, with appropriate URIs and ranges.
- Introduced a template specificity slot for context-aware RAG filtering.
- Consolidated capacity-related slots into a unified structure, including has_or_had_capacity, capacity_type, and capacity_value, with detailed descriptions and examples.
2026-01-17 18:53:23 +01:00

108 lines
4 KiB
YAML

# Country - Geographic country entity
#
# MIGRATION: 2026-01-16 per slot_fixes.yaml alpha_2/alpha_3 feedback (Rule 56)
# OLD: has_iso_3166_1_alpha_2_code, has_iso_3166_1_alpha_3_code (string slots)
# NEW: has_or_had_code with Alpha2Code, Alpha3Code class instances
id: https://nde.nl/ontology/hc/class/country
name: country
title: Country Class
prefixes:
gn: http://www.geonames.org/ontology#
hc: https://nde.nl/ontology/hc/
lcc_cr: https://www.omg.org/spec/LCC/Countries/CountryRepresentation/
linkml: https://w3id.org/linkml/
schema: http://schema.org/
wikidata: http://www.wikidata.org/entity/
imports:
- linkml:types
- ../slots/has_or_had_code
- ./Alpha2Code
- ./Alpha3Code
- ../slots/specificity_annotation
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
classes:
Country:
class_uri: schema:Country
exact_mappings:
- lcc_cr:Country
- gn:A.PCLI
close_mappings:
- wikidata:Q6256
description: |
Country identified by ISO 3166-1 alpha-2 and alpha-3 codes.
This is a **minimal design** class containing ONLY ISO standardized country codes.
No other metadata (names, languages, capitals, regions) is included.
Purpose:
- Link legal forms to their jurisdiction (legal forms are country-specific)
- Link custodian places to their country location
- Enable conditional enum values in FeatureTypeEnum (e.g., "cultural heritage of Peru")
Design rationale:
- ISO 3166 codes are authoritative, stable, and language-neutral
- Country names, languages, and other metadata should be resolved via external services
- Keeps the ontology focused on heritage custodian relationships, not geopolitical data
External resolution services:
- GeoNames API: https://www.geonames.org/
- UN M49 Standard: https://unstats.un.org/unsd/methodology/m49/
- ISO 3166 Maintenance Agency: https://www.iso.org/iso-3166-country-codes.html
MIGRATION (2026-01-16): Now uses has_or_had_code with Alpha2Code and Alpha3Code
class instances per Rule 56 (semantic consistency over simplicity).
slots:
- has_or_had_code # was: has_iso_3166_1_alpha_2_code, has_iso_3166_1_alpha_3_code - migrated per Rule 56 (2026-01-16)
- specificity_annotation
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
slot_usage:
has_or_had_code:
multivalued: true
inlined: true
inlined_as_list: true
description: |
ISO country codes for this country. Includes:
- One Alpha2Code instance (2-letter code, e.g., "NL")
- One Alpha3Code instance (3-letter code, e.g., "NLD")
annotations:
specificity_score: "0.20"
specificity_rationale: "Low specificity - countries are universal geographic entities."
examples:
- value:
has_or_had_code:
- _type: Alpha2Code
has_or_had_code: "NL"
- _type: Alpha3Code
has_or_had_code: "NLD"
description: Netherlands - using structured code classes
- value:
has_or_had_code:
- _type: Alpha2Code
has_or_had_code: "PE"
- _type: Alpha3Code
has_or_had_code: "PER"
description: Peru - using structured code classes
- value:
has_or_had_code:
- _type: Alpha2Code
has_or_had_code: "US"
- _type: Alpha3Code
has_or_had_code: "USA"
description: United States - using structured code classes
- value:
has_or_had_code:
- _type: Alpha2Code
has_or_had_code: "JP"
- _type: Alpha3Code
has_or_had_code: "JPN"
description: Japan - using structured code classes