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

96 lines
3.9 KiB
YAML

id: https://nde.nl/ontology/hc/class/IdentificationEvent
name: identification_event
title: Identification Event
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
dwc: http://rs.tdwg.org/dwc/terms/
prov: http://www.w3.org/ns/prov#
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
crm: http://www.cidoc-crm.org/cidoc-crm/
skos: http://www.w3.org/2004/02/skos/core#
rdfs: http://www.w3.org/2000/01/rdf-schema#
org: http://www.w3.org/ns/org#
xsd: http://www.w3.org/2001/XMLSchema#
default_prefix: hc
imports:
- linkml:types
- ./TimeSpan
- ./Agent
- ../slots/temporal_extent
- ../slots/has_or_had_description
- ../slots/has_or_had_score
- ./ConfidenceScore
classes:
IdentificationEvent:
class_uri: hc:IdentificationEvent
description: "Event representing the taxonomic or specimen identification.\n\n**DEFINITION**:\nIdentificationEvent models when and by whom a biological specimen,\nobject, or artifact was identified or classified.\n\n**ONTOLOGY ALIGNMENT**:\n- **Primary** (`class_uri`): `hc:IdentificationEvent` - Heritage Custodian class\n- **Close**: `dwc:Identification` - Darwin Core identification\n- **Close**: `prov:Activity` - PROV-O activity\n\n**USAGE**:\nReplaces simple `date_identified` dates with structured event data:\n- When the identification was made (temporal_extent)\n- Who made the identification (identified_by)\n- Methodology used\n- Confidence level\n- References consulted\n\n**Example**:\n```yaml\nis_or_was_identified_through:\n temporal_extent:\n begin_of_the_begin: \"2023-05-15\"\n identified_by:\n - agent_name: \"Dr. Jane Smith\"\n agent_role: \"taxonomist\"\n identification_method: \"Morphological analysis\"\n identification_confidence: \"high\"\n```\n"
close_mappings:
- dwc:Identification
- prov:Activity
slots:
- temporal_extent
- has_or_had_description
- identified_by
- identification_method
- has_or_had_score # was: identification_confidence - migrated per Rule 53 (2026-01-28)
- identification_references
slot_usage:
temporal_extent:
range: TimeSpan
inlined: true
description: When the identification was made.
examples:
- value:
begin_of_the_begin: '2023-05-15'
description: Date of identification
identified_by:
range: Agent
multivalued: true
inlined_as_list: true
description: Person(s) who performed the identification.
examples:
- value:
- agent_name: Dr. J. Smith
description: Taxonomist
identification_method:
range: string
description: Method used for identification.
examples:
- value: Morphological analysis
- value: DNA barcoding
- value: Comparison with type specimen
has_or_had_score: # was: identification_confidence - migrated per Rule 53 (2026-01-28)
range: ConfidenceScore
description: |
Confidence score/level of the identification.
MIGRATED from identification_confidence per Rule 53.
Uses ConfidenceScore class.
inlined: true
examples:
- value:
has_or_had_score: 0.9
has_or_had_description: "High confidence"
description: High confidence identification
- value:
has_or_had_score: 0.5
has_or_had_description: "Tentative"
description: Tentative identification
identification_references:
range: string
multivalued: true
description: References consulted for identification.
examples:
- value: Flora of North America, Vol. 3
attributes: {}
annotations:
custodian_types: '["M", "R", "B"]'
custodian_types_rationale: Identification events primarily for natural history museums, research centers, botanical gardens.
specificity_score: 0.75
specificity_rationale: Specific to biological/natural history collection contexts.