id: https://nde.nl/ontology/hc/class/CollectionEvent
name: CollectionEvent
title: Collection Event 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/
  prov: http://www.w3.org/ns/prov#
imports:
  - linkml:types
  - ../metadata
  - ../slots/identified_by
  - ../slots/has_note
  - ../slots/in_place
  - ../slots/has_provenance
  - ../slots/acquired_by
  - ../slots/temporal_extent
  - ../slots/has_protocol
  - ../slots/has_habitat
default_prefix: hc
classes:
  CollectionEvent:
    class_uri: dwc:Event
    description: "A specimen collection event capturing where, when, and by whom a specimen was collected.\n**Purpose**: Consolidates collection metadata into a structured event following Darwin Core and CIDOC-CRM event modeling patterns.\n**Darwin Core Alignment**: - `has_place` \u2192 dwc:locality (structured location) - `temporal_extent` \u2192 dwc:eventDate (collection date/period) - `acquired_by` \u2192 dwc:recordedBy (was: collector, migrated 2026-01-22) - `field_number` \u2192 dwc:fieldNumber\n**CIDOC-CRM Alignment**: - Maps to crm:E7_Activity (collection activity) - `has_place` \u2192 crm:P7_took_place_at - `temporal_extent` \u2192 crm:P4_has_time-span\n**REPLACES**: - Individual slots: collection_location, collection_date, field_number - collector \u2192 acquired_by + Agent (migrated 2026-01-22) - Consolidates into structured event with provenance\n**Example**: ```yaml CollectionEvent:\n  has_place:\n    place_name: \"Mauritius\"\n    country:\
      \ \"MU\"\n    latitude: -20.2\n    longitude: 57.5\n  temporal_extent:\n    begin_of_the_begin: \"1662-01-01\"\n    end_of_the_end: \"1662-12-31\"\n  acquired_by:  # was: collector - migrated 2026-01-22\n    - agent_name: \"Unknown Dutch sailor\"\n      agent_type: person\n      agent_role: collector\n  field_number: \"VOC-1662-001\"\n```"
    exact_mappings:
    - dwc:Event
    close_mappings:
    - crm:E7_Activity
    - prov:Activity
    related_mappings:
    - schema:Action
    mixins:
    - HasProvenance
    slots:
    - in_place
    - has_provenance
    - has_note
    - temporal_extent
    - acquired_by
    - identified_by
    - identified_by
    - has_protocol
    - has_habitat
    slot_usage:
      identified_by:
        identifier: true
        description: Unique identifier for this collection event. MIGRATED from event_id (Rule 53, 2026-01-26).
      in_place:
        range: CustodianPlace
        inlined: true
        examples:
        - value:
            place_name: Mauritius
            country: MU
            latitude: -20.2
            longitude: 57.5
      temporal_extent:
        range: TimeSpan
        inlined: true
        examples:
        - value:
            begin_of_the_begin: '2020-06-15'
            end_of_the_end: '2020-06-15'
        - value:
            begin_of_the_begin: '1870-01-01'
            end_of_the_end: '1879-12-31'
      has_provenance:
        range: ProvenanceBlock
        inlined: true
      acquired_by:
        range: Agent
        multivalued: true
        inlined: true
        inlined_as_list: true
        examples:
        - value:
        - value:
    comments:
    - Created 2026-01-19 from collection_location migration (Rule 53)
    - "2026-01-22: collector attribute \u2192 acquired_by slot + Agent class (Rule 53)"
    - Aligns with Darwin Core dwc:Event
    - Consolidates collection metadata into structured event
    - Supports provenance tracking for historical specimens
    see_also:
    - https://dwc.tdwg.org/terms/#dwc:Event
    - https://cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E7
    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.70'
      specificity_rationale: Fairly specific - primarily for natural history specimen collecting events.
      template_specificity: '{"museum_search": 0.75, "collection_discovery": 0.8, "general_heritage": 0.55}'
    examples:
    - value:
        identified_by: https://nde.nl/ontology/hc/event/dodo-collection-1662
        has_place:
          place_name: Mauritius
          country: MU
          latitude: -20.2
          longitude: 57.5
        temporal_extent:
          begin_of_the_begin: '1600-01-01'
          end_of_the_end: '1662-12-31'
        acquired_by:
        - agent_name: Unknown Dutch sailor
    - value:
        identified_by: https://nde.nl/ontology/hc/event/wallace-java-1234
        has_place:
          place_name: Mt. Gede
          region: West Java
          country: ID
          latitude: -6.78
          longitude: 106.98
        temporal_extent:
          begin_of_the_begin: '1854-06-01'
          end_of_the_end: '1854-06-30'
        acquired_by:
        - agent_name: Alfred Russel Wallace