kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/CollectionEvent.yaml
kempersc ba2c766dd0 Add new slots and update existing ones following RiC-O temporal naming conventions 
- Introduced `founding_date`, `founding_date_diocese`, and `fr` slots for capturing founding dates and French language text.
- Created `collects_or_collected`, `has_or_had_objective`, `has_or_had_percentage`, `has_or_had_place`, `has_or_had_reply`, `has_or_had_web_page`, `is_or_was_acquired_by`, `is_or_was_appreciated`, `is_or_was_founded_through`, `is_or_was_part_of`, `is_or_was_part_of_total`, `start_of_the_start`, `takes_or_took_comission`, and `was_fetched_at` slots to enhance data modeling capabilities.
- Each slot includes detailed descriptions, examples, and ontology alignments to ensure clarity and usability.
- Migration notes added for slots transitioned from previous definitions to maintain historical context and facilitate understanding of changes.
2026-01-22 15:15:56 +01:00

268 lines
8.7 KiB
YAML
Raw Blame History

# 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
Reference in a new issue View git blame Copy permalink