glam/schemas/20251121/linkml/modules/classes/CollectionEvent.yaml
kempersc f7bf1cc5ae Refactor schema slots and classes
- Deleted obsolete slot definitions: statement_summary, statement_text, statement_type, status_name, supersede_articles, supersede_condition, supersede_name, temporal_dynamics, total_amount, typical_contents, use_cases, was_acquired_through, was_fetched_at, was_retrieved_at.
- Updated existing slot definitions for states_or_stated to enhance clarity and structure.
- Introduced new classes: Article, ConditionofAccess, FinancialStatementType, MaximumQuantity, Series, Summary, Type, and their respective slots to improve schema organization and usability.
- Added new slots: changes_or_changed_through, has_or_had_condition_of_access, has_or_had_heritage_type, is_or_was_part_of_series, is_or_was_retrieved_at, maximum_of_maximum to capture additional metadata and relationships.
2026-01-30 00:29:31 +01:00

180 lines
7.5 KiB
YAML

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