glam/schemas/20251121/linkml/modules/classes/Event.yaml
kempersc 69a22e2b5a Refactor and expand LinkML slot definitions
- Deleted the `rights_statement_url` slot definition as it is no longer needed.
- Added multiple new slots including `has_legal_basis`, `has_statement`, `impose`, `pose_condition`, and `reviewed_through` with detailed descriptions and ontology alignments.
- Updated existing slots to improve clarity and consistency, including renaming `close_mappings` to `related_mappings` in several definitions.
- Enhanced the `require` slot with additional aliases for better usability.
- Improved documentation and comments across all slot definitions to clarify their purpose and usage.
2026-02-08 23:37:44 +01:00

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/20260202_matang/has_description
- ../slots/20260202_matang/has_documentation
- ../slots/20260202_matang/has_hypernym
- ../slots/20260202_matang/identified_by
- ../slots/20260202_matang/has_label
- ../slots/20260202_matang/has_score
- ../slots/20260202_matang/new/involves_or_involved
- ../slots/20260202_matang/generated_by
- ../slots/20260202_matang/in_place
- ../slots/20260202_matang/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 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_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_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_documentation
- has_description
- identified_by
- has_label
- has_hypernym
- temporal_extent
- involves_or_involved
- has_score
- takes_or_took_place_at
- generated_by
slot_usage:
identified_by:
required: true
identifier: true
has_hypernym:
required: true
# range: string # uriorcurie
# range: EventType
inlined: false # Fixed invalid inline for primitive type
has_label:
required: true
has_description:
required: false
temporal_extent:
required: false
range: TimeSpan
inlined: true
generated_by:
# range: string # uriorcurie
# range: GenerationEvent
required: false
inlined: false # Fixed invalid inline for primitive type
description: 'Generation event containing confidence score for this event. MIGRATED 2026-01-19: Replaces confidence_score slot with structured pattern.'
examples:
- value:
has_score:
has_score: 0.95
has_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_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 generated_by + ConfidenceScore"
examples:
- value:
identified_by: https://nde.nl/ontology/hc/event/nha-merger-2001
has_label: Noord-Hollands Archief Merger
has_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_involved_actor:
- https://nde.nl/ontology/hc/nl-nh-haa-a-gah
- https://nde.nl/ontology/hc/nl-nh-haa-a-ranh
has_description: 'Merger of Gemeentearchief Haarlem (founded 1910) and
Rijksarchief in Noord-Holland (founded 1802) to form
Noord-Hollands Archief.
'
generated_by:
has_score:
has_score: 0.95
has_documentation:
- has_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: "['*']"