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/has_or_had_place - ../slots/has_or_had_provenance - ../slots/has_or_had_note - ../slots/temporal_extent - ../slots/is_or_was_acquired_by - ./Place - ./CustodianPlace - ./TimeSpan - ./Agent 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_or_had_place` \u2192 dwc:locality (structured location) - `temporal_extent` \u2192 dwc:eventDate (collection date/period) - `is_or_was_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_or_had_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 is_or_was_acquired_by + Agent (migrated 2026-01-22) - Consolidates into structured event with provenance\n**Example**: ```yaml CollectionEvent:\n has_or_had_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 is_or_was_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: - has_or_had_place - has_or_had_provenance - has_or_had_note - temporal_extent - is_or_was_acquired_by - has_or_had_identifier annotations: specificity_score: 0.1 specificity_rationale: Generic utility class/slot created during migration custodian_types: "['*']" custodian_types_rationale: Universal utility concept attributes: has_or_had_identifier: description: Unique identifier for this collection event. MIGRATED from event_id (Rule 53, 2026-01-26). range: uriorcurie identifier: true slot_uri: dcterms:identifier field_number: description: Collector's field number or identifier. Maps to dwc:fieldNumber. range: string slot_uri: dwc:fieldNumber examples: - value: ARW-1234 - value: CD-HMS Beagle-567 sampling_protocol: description: Method used to collect the specimen. Maps to dwc:samplingProtocol. range: string slot_uri: dwc:samplingProtocol examples: - value: UV light trap - value: Mist net - value: Hand collection habitat_description: description: Description of habitat where specimen was collected. Maps to dwc:habitat. range: string slot_uri: dwc:habitat examples: - value: Tropical rainforest, understory - value: Coral reef, depth 15m slot_usage: has_or_had_place: description: 'Structured location where specimen was collected. MIGRATED from collection_location per slot_fixes.yaml (Rule 53, 2026-01-19). Uses CustodianPlace for detailed location including coordinates.' range: CustodianPlace inlined: true examples: - value: place_name: Mauritius country: MU latitude: -20.2 longitude: 57.5 temporal_extent: description: Time period when collection occurred. Supports exact dates, ranges, and approximate periods. range: TimeSpan inlined: true examples: - value: begin_of_the_begin: '2020-06-15' end_of_the_end: '2020-06-15' description: Exact date - value: begin_of_the_begin: '1870-01-01' end_of_the_end: '1879-12-31' notes: 1870s description: Approximate decade has_or_had_provenance: description: Provenance of this collection event record. range: ProvenanceBlock inlined: true is_or_was_acquired_by: description: 'Person(s) who collected the specimen. MIGRATED from collector attribute per slot_fixes.yaml (Rule 53, 2026-01-22). Uses Agent class for structured representation with name, type, and role. Maps to dwc:recordedBy via Agent.' range: Agent multivalued: true inlined: true inlined_as_list: true examples: - value: agent_name: Alfred Russel Wallace agent_type: person agent_role: collector description: Victorian naturalist collector - value: agent_name: Charles Darwin agent_type: person agent_role: collector description: HMS Beagle expedition collector comments: - Created 2026-01-19 from collection_location migration (Rule 53) - "2026-01-22: collector attribute \u2192 is_or_was_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: has_or_had_identifier: https://nde.nl/ontology/hc/event/dodo-collection-1662 has_or_had_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' notes: Pre-1662 (before extinction) is_or_was_acquired_by: - agent_name: Unknown Dutch sailor agent_type: person agent_role: collector description: Historical Dodo collection event - value: has_or_had_identifier: https://nde.nl/ontology/hc/event/wallace-java-1234 has_or_had_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' is_or_was_acquired_by: - agent_name: Alfred Russel Wallace agent_type: person agent_role: collector field_number: ARW-1234 sampling_protocol: Hand collection habitat_description: Montane forest, 1500m elevation description: Wallace collection in Java