# CollectionEvent class # Structured representation of specimen collection events. # # MIGRATION NOTE (2026-01-19): # Created as part of collection_location migration per slot_fixes.yaml (Rule 53). # # Darwin Core alignment: Captures dwc:Event for specimen collection activities. 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 # Added 2026-01-22 for collector migration (Rule 53) - ./Place - ./CustodianPlace - ./TimeSpan - ./Agent # Added 2026-01-22 for collector migration (Rule 53) default_prefix: hc classes: CollectionEvent: class_uri: dwc:Event description: >- A specimen collection event capturing where, when, and by whom a specimen was collected. **Purpose**: Consolidates collection metadata into a structured event following Darwin Core and CIDOC-CRM event modeling patterns. **Darwin Core Alignment**: - `has_or_had_place` → dwc:locality (structured location) - `temporal_extent` → dwc:eventDate (collection date/period) - `is_or_was_acquired_by` → dwc:recordedBy (was: collector, migrated 2026-01-22) - `field_number` → dwc:fieldNumber **CIDOC-CRM Alignment**: - Maps to crm:E7_Activity (collection activity) - `has_or_had_place` → crm:P7_took_place_at - `temporal_extent` → crm:P4_has_time-span **REPLACES**: - Individual slots: collection_location, collection_date, field_number - collector → is_or_was_acquired_by + Agent (migrated 2026-01-22) - Consolidates into structured event with provenance **Example**: ```yaml CollectionEvent: has_or_had_place: place_name: "Mauritius" country: "MU" latitude: -20.2 longitude: 57.5 temporal_extent: begin_of_the_begin: "1662-01-01" end_of_the_end: "1662-12-31" is_or_was_acquired_by: # was: collector - migrated 2026-01-22 - agent_name: "Unknown Dutch sailor" agent_type: person agent_role: collector field_number: "VOC-1662-001" ``` 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 # Added 2026-01-22: was collector (Rule 53) attributes: event_id: description: >- Unique identifier for this collection event. range: uriorcurie identifier: true slot_uri: dcterms:identifier # collector: REMOVED - migrated to is_or_was_acquired_by per Rule 53 (2026-01-22) # Now uses imported slot is_or_was_acquired_by with Agent class 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 → 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.80" general_heritage: "0.55" examples: - value: event_id: "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)" # collector → is_or_was_acquired_by (migrated 2026-01-22) is_or_was_acquired_by: - agent_name: "Unknown Dutch sailor" agent_type: person agent_role: collector description: Historical Dodo collection event - value: event_id: "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" # collector → is_or_was_acquired_by (migrated 2026-01-22) 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