fc405445c6
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`. - Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples. - Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`. - Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files. - Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
128 lines
7.4 KiB
YAML
128 lines
7.4 KiB
YAML
id: https://nde.nl/ontology/hc/class/Event
|
|
name: Event
|
|
title: Event Hub Class
|
|
prefixes:
|
|
linkml: https://w3id.org/linkml/
|
|
hc: https://nde.nl/ontology/hc/
|
|
crm: http://www.cidoc-crm.org/cidoc-crm/
|
|
prov: http://www.w3.org/ns/prov#
|
|
schema: http://schema.org/
|
|
rico: https://www.ica.org/standards/RiC/ontology#
|
|
dcterms: http://purl.org/dc/terms/
|
|
skos: http://www.w3.org/2004/02/skos/core#
|
|
default_prefix: hc
|
|
imports:
|
|
- linkml:types
|
|
- ../slots/has_or_had_description
|
|
- ../slots/has_or_had_documentation
|
|
- ../slots/has_or_had_hypernym
|
|
- ../slots/has_or_had_identifier
|
|
- ../slots/has_or_had_label
|
|
- ../slots/has_or_had_score
|
|
- ../slots/involves_or_involved
|
|
- ../slots/is_or_was_generated_by
|
|
- ../slots/takes_or_took_place_at
|
|
- ../slots/temporal_extent
|
|
classes:
|
|
Event:
|
|
class_uri: crm:E5_Event
|
|
description: "An abstract hub class representing temporal phenomena - things that happen\nand involve actors, places, and temporal extents.\n\n**HUB ARCHITECTURE**:\n\nThe Event class follows the hub pattern established by Custodian:\n- Minimal hub with persistent identifier (event_id)\n- Links to temporal extent (TimeSpan) via temporal_extent\n- Links to actors (Custodian, Person) via involved_actors\n- Links to place via took_place_at\n- Categorized by hypernym_event_type (generic) and domain-specific type\n\n**INHERITANCE HIERARCHY**:\n\n```\nEvent (this class - abstract)\n\u251C\u2500\u2500 OrganizationalChangeEvent (existing - organizational changes)\n\u251C\u2500\u2500 IntangibleHeritageEvent (future - ICH-related events)\n\u251C\u2500\u2500 CollectionEvent (future - accession, deaccession, loan)\n\u2514\u2500\u2500 PersonEvent (future - birth, death, career milestones)\n```\n\n**CIDOC-CRM ALIGNMENT**:\n\nMaps to crm:E5_Event which is defined as:\n\"This class comprises distinct,\
|
|
\ delimited and coherent processes and states, \neither deliberately or spontaneously caused by E39 Actors, that result in \nchanges in E18 Physical Things.\"\n\nKey relationships:\n- crm:P4_has_time-span \u2192 TimeSpan (when)\n- crm:P7_took_place_at \u2192 Place (where)\n- crm:P11_had_participant \u2192 Actor (who)\n- crm:P2_has_type \u2192 EventTypeEnum (what kind)\n\n**RELATIONSHIP TO EXISTING OrganizationalChangeEvent**:\n\nOrganizationalChangeEvent already exists and maps to crm:E5_Event.\nThis Event class provides:\n1. Shared base properties (temporal_extent, involved_actors, took_place_at)\n2. Generic event typing (hypernym_event_type)\n3. Foundation for other event types\n\nFuture migration: OrganizationalChangeEvent can inherit from Event.\n\n**RELATIONSHIP TO ACTORS**:\n\nEvents link to actors bidirectionally:\n- Event \u2192 involved_actors \u2192 Custodian/Person (who participated)\n- Custodian \u2192 organizational_change_events \u2192 Event (what events affected org)\n\
|
|
- Person \u2192 is_or_was_affected_by_event \u2192 Event (what events affected person)\n\n**EXAMPLE - Merger Event**:\n```yaml\nEvent:\n event_id: \"https://nde.nl/ontology/hc/event/nha-merger-2001\"\n event_label: \"Noord-Hollands Archief Merger\"\n hypernym_event_type: TRANSFORMATION\n temporal_extent:\n begin_of_the_begin: \"2001-01-01\"\n end_of_the_end: \"2001-01-01\"\n took_place_at: \"https://nde.nl/ontology/hc/place/nl-nh-haa\"\n involved_actors:\n - \"https://nde.nl/ontology/hc/nl-nh-haa-a-gah\"\n - \"https://nde.nl/ontology/hc/nl-nh-haa-a-ranh\"\n has_or_had_description: |\n Merger of Gemeentearchief Haarlem (founded 1910) and\n Rijksarchief in Noord-Holland (founded 1802) to form\n Noord-Hollands Archief.\n confidence_score: 0.95\n documentation_source:\n - \"https://noord-hollandsarchief.nl/over-ons/geschiedenis\"\n```\n\n**EXAMPLE - Destruction Event**:\n```yaml\nEvent:\n event_id: \"https://nde.nl/ontology/hc/event/gaza-library-destruction-2024\"\
|
|
\n event_label: \"Gaza Public Library Destruction\"\n hypernym_event_type: DESTRUCTION\n temporal_extent:\n begin_of_the_begin: \"2024-01-15\"\n end_of_the_end: \"2024-01-15\"\n took_place_at: \"https://nde.nl/ontology/hc/place/ps-gz-gaz\"\n has_or_had_description: |\n Gaza Public Library destroyed during military operations.\n confidence_score: 0.85\n```\n"
|
|
exact_mappings:
|
|
- crm:E5_Event
|
|
- prov:Activity
|
|
- rico:Event
|
|
close_mappings:
|
|
- schema:Event
|
|
- crm:E4_Period
|
|
- crm:E7_Activity
|
|
broad_mappings:
|
|
- crm:E2_Temporal_Entity
|
|
- prov:Entity
|
|
narrow_mappings:
|
|
- crm:E63_Beginning_of_Existence
|
|
- crm:E64_End_of_Existence
|
|
- crm:E81_Transformation
|
|
- crm:E10_Transfer_of_Custody
|
|
- crm:E9_Move
|
|
- crm:E85_Joining
|
|
- crm:E86_Leaving
|
|
slots:
|
|
- has_or_had_documentation
|
|
- has_or_had_description
|
|
- has_or_had_identifier
|
|
- has_or_had_label
|
|
- has_or_had_hypernym
|
|
- temporal_extent
|
|
|
|
- involves_or_involved
|
|
- has_or_had_score
|
|
- takes_or_took_place_at
|
|
- is_or_was_generated_by
|
|
slot_usage:
|
|
has_or_had_identifier:
|
|
required: true
|
|
identifier: true
|
|
has_or_had_hypernym:
|
|
required: true
|
|
range: uriorcurie
|
|
# range: EventType
|
|
inlined: true
|
|
has_or_had_label:
|
|
required: true
|
|
has_or_had_description:
|
|
required: false
|
|
temporal_extent:
|
|
required: false
|
|
range: TimeSpan
|
|
inlined: true
|
|
is_or_was_generated_by:
|
|
range: uriorcurie
|
|
# range: GenerationEvent
|
|
required: false
|
|
inlined: true
|
|
description: 'Generation event containing confidence score for this event. MIGRATED 2026-01-19: Replaces confidence_score slot with structured pattern.'
|
|
examples:
|
|
- value:
|
|
has_or_had_score:
|
|
has_or_had_score: 0.95
|
|
has_or_had_method: documentation_verification
|
|
comments:
|
|
- Event is the hub class for all temporal phenomena in the HC ontology
|
|
- Domain-specific events (OrganizationalChangeEvent, CollectionEvent) can inherit from Event
|
|
- TimeSpan link (temporal_extent) is critical - enables fuzzy temporal reasoning
|
|
- Actor links (involved_actors) connect events to both persons and organizations
|
|
- has_or_had_hypernym provides cross-domain event queries
|
|
- 'Future: Add participated_in_events slot to Custodian and Person for inverse navigation'
|
|
- "MIGRATED 2026-01-19: confidence_score \u2192 is_or_was_generated_by + ConfidenceScore"
|
|
examples:
|
|
- value:
|
|
has_or_had_identifier: https://nde.nl/ontology/hc/event/nha-merger-2001
|
|
has_or_had_label: Noord-Hollands Archief Merger
|
|
has_or_had_hypernym: TRANSFORMATION
|
|
temporal_extent:
|
|
begin_of_the_begin: '2001-01-01'
|
|
end_of_the_end: '2001-01-01'
|
|
takes_or_took_place_at: https://nde.nl/ontology/hc/place/nl-nh-haa
|
|
has_or_had_involved_actor:
|
|
- https://nde.nl/ontology/hc/nl-nh-haa-a-gah
|
|
- https://nde.nl/ontology/hc/nl-nh-haa-a-ranh
|
|
has_or_had_description: 'Merger of Gemeentearchief Haarlem (founded 1910) and
|
|
|
|
Rijksarchief in Noord-Holland (founded 1802) to form
|
|
|
|
Noord-Hollands Archief.
|
|
|
|
'
|
|
is_or_was_generated_by:
|
|
has_or_had_score:
|
|
has_or_had_score: 0.95
|
|
has_or_had_documentation:
|
|
- has_or_had_url:
|
|
url_value: https://noord-hollandsarchief.nl/over-ons/geschiedenis
|
|
annotations:
|
|
specificity_score: 0.1
|
|
specificity_rationale: Generic utility class/slot created during migration
|
|
custodian_types: "['*']"
|