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

86 lines
3.3 KiB
YAML

id: https://nde.nl/ontology/hc/class/Locality
name: Locality
title: Locality Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
crm: http://www.cidoc-crm.org/cidoc-crm/
dcterms: http://purl.org/dc/terms/
dwc: http://rs.tdwg.org/dwc/terms/
skos: http://www.w3.org/2004/02/skos/core#
imports:
- linkml:types
- ../metadata
- ../slots/has_label
- ../slots/has_note
- ../slots/has_provenance
- ../slots/in_language
default_prefix: hc
classes:
Locality:
class_uri: dcterms:Location
description: "Structured locality description for specimens and collection events.\n\
**Purpose**: Captures verbatim locality text as recorded on specimen labels\
\ or in field notes, preserving the original description for historical accuracy\
\ while allowing structured interpretation.\n**Darwin Core Alignment**: - `verbatim_text`\
\ → dwc:verbatimLocality - Preserves original text exactly as recorded - Supports\
\ historical specimens with non-standard descriptions\n**TEMPORAL SEMANTICS**:\
\ Locality descriptions may vary over time: - Original label text (historical)\
\ - Interpreted/standardized descriptions (current) - Multiple descriptions\
\ from different sources\n**Example**: ```yaml Locality:\n verbatim_text: \"\
Mauritius, near Port Louis, in forest\"\n original_language: \"en\"\n has_provenance:\n\
\ data_source: \"specimen_label\"\n extraction_date: \"2025-01-19\"\n\
```\n**REPLACES**: - Simple `collection_locality_text` string slot - Adds structured\
\ provenance and language tracking"
exact_mappings:
- dcterms:Location
close_mappings:
- dwc:Location
- schema:Place
related_mappings:
- crm:E53_Place
mixins:
- HasProvenance
slots:
- has_label
- has_note
- has_provenance
- in_language
slot_usage:
has_label:
# range: string
examples:
- value: Port Louis, Mauritius
has_note:
# range: string
has_provenance:
range: ProvenanceBlock
inlined: true
comments:
- Created 2026-01-19 from collection_locality_text migration (Rule 53)
- Aligns with Darwin Core dwc:verbatimLocality
- Preserves original text while allowing structured interpretation
- Supports historical specimens with non-standard locality descriptions
see_also:
- https://dwc.tdwg.org/terms/#dwc:verbatimLocality
- https://dwc.tdwg.org/terms/#dwc:Location
annotations:
custodian_types: '["B", "M", "R"]'
custodian_types_rationale: Primarily used for Botanical/Zoo (B), Museum (M),
and Research (R) custodians with biological specimen collections.
custodian_types_primary: B
specificity_score: '0.65'
specificity_rationale: Moderately specific - primarily for natural history specimens.
template_specificity: '{"museum_search": 0.7, "collection_discovery": 0.75,
"general_heritage": 0.5}'
examples:
- value:
has_label: Port Louis, Mauritius
has_provenance: null
- value:
verbatim_text: 'Indonesia: Java: Mt. Gede, 1500m'
has_label: Gunung Gede, West Java, Indonesia
- value:
interpretation_notes: 'Latin: ''Near Cape Town, on rocks by the sea'''
has_label: Cape Town coastline, South Africa