glam/schemas/20251121/linkml/modules/classes/Event.yaml
kempersc c1946e93f9 Refactor VideoPost and WebObservation schemas; remove deprecated slots and migrate to new structures
- Updated VideoPost.yaml to include new slots and remove deprecated ones, enhancing video-specific properties.
- Removed extraction_confidence from WebObservation.yaml, streamlining the schema.
- Deleted obsolete slot files: characteristics.yaml, class_definition.yaml, confidence.yaml, confidence_method.yaml, confidence_score.yaml, confidence_value.yaml, count.yaml, and hosts_branch.yaml.
- Introduced ghost_slots.txt to track unused slots.
- Archived previous versions of characteristics, class_definition, confidence, confidence_method, confidence_score, confidence_value, count, and hosts_branch slots for historical reference.
- Added new slots: has_or_had_citation, has_or_had_city_code, and is_or_was_location_of with appropriate descriptions and mappings.
2026-01-28 15:04:11 +01:00

148 lines
8.3 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
- ./TimeSpan
- ../slots/has_or_had_description
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_hypernym
- ./Description
- ./Identifier
- ./Label
- ./EventType
- ../slots/temporal_extent
- ../slots/involves_or_involved
- ./Actor
- ../slots/specificity_annotation
- ../slots/has_or_had_score
- ../slots/takes_or_took_place_at
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ../slots/is_or_was_generated_by
- ./GenerationEvent
- ./ConfidenceScore
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 event_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 event_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
- specificity_annotation
- has_or_had_score
- takes_or_took_place_at
- is_or_was_generated_by
slot_usage:
has_or_had_identifier:
required: true
identifier: true
description: Unique identifier for this event. MIGRATED from event_id (2026-01-26).
has_or_had_hypernym:
required: true
range: EventType
description: High-level classification of the event (e.g. TRANSFORMATION, DESTRUCTION). MIGRATED from hypernym_event_type per Rule 53. Uses EventType class (wrapping EventTypeEnum).
inlined: true
has_or_had_label:
required: true
description: Label/name of the event. MIGRATED from event_label (2026-01-26).
has_or_had_description:
required: false
description: Description of the event. MIGRATED from event_description (2026-01-26).
temporal_extent:
required: false
range: TimeSpan
inlined: true
description: Temporal extent of the event. Replaces has_timespan (migrated 2026-01-26).
is_or_was_generated_by:
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
description: High confidence from verified documentation
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
description: Merger of two archives to form Noord-Hollands Archief with structured confidence score
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types:
- '*'
custodian_types_rationale: Universal utility concept