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:
      identified_by:
        range: Agent
        multivalued: true
        inlined_as_list: true
        description: Person(s) who performed the identification.
      identification_method:
        range: string
        description: Method used for identification.
      identification_references:
        range: string
        multivalued: true
        description: References consulted.

    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.