kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/Event.yaml
kempersc 626bd3a095 refactor(schemas): apply naming conventions to 261 class files 
- Apply Rule 39: RiC-O style hasOrHad*/isOrWas* for temporal slots
- Apply Rule 43: Singular noun convention (keywords → keyword)
- Update slot references to match renamed slot files
- Maintain schema integrity across all class definitions
2026-01-10 15:36:33 +01:00

298 lines
12 KiB
YAML
Raw Blame History

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
- ../enums/EventTypeEnum
- ../slots/event_description
- ../slots/confidence_score
- ../slots/event_id
- ../slots/documentation_source
- ../slots/event_label
- ../slots/has_timespan
- ../slots/hypernym_event_type
- ../slots/has_or_had_involved_actor
- ../slots/specificity_annotation
- ../slots/template_specificity
- ../slots/took_place_at
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
slots:
hypernym_event_type:
slot_uri: crm:P2_has_type
description: |
High-level event type category from EventTypeEnum.
This is the GENERIC event type (CREATION, DESTRUCTION, TRANSFORMATION, etc.)
that provides cross-domain categorization.
Domain-specific event types (OrganizationalChangeEventTypeEnum) provide
more detailed classification within their domain.
**RELATIONSHIP**:
- hypernym_event_type: Generic category (this slot)
- event_type: Domain-specific type (on subclasses like OrganizationalChangeEvent)
**EXAMPLE**:
```yaml
Event:
hypernym_event_type: TRANSFORMATION # Generic
OrganizationalChangeEvent:
hypernym_event_type: TRANSFORMATION # Generic (inherited)
event_type: MERGER # Domain-specific
```
range: EventTypeEnum
required: true
exact_mappings:
- crm:P2_has_type
- prov:type
has_timespan:
slot_uri: crm:P4_has_time-span
description: |
Temporal extent of this event.
Links to TimeSpan class which supports fuzzy temporal bounds using
CIDOC-CRM's four-point temporal model:
- begin_of_the_begin (earliest possible start)
- end_of_the_begin (latest possible start)
- begin_of_the_end (earliest possible end)
- end_of_the_end (latest possible end)
**CIDOC-CRM**: P4_has_time-span
- Domain: E2_Temporal_Entity (includes E5_Event)
- Range: E52_Time-Span
**USE CASES**:
- Precise date known: All four bounds = same date
- Date uncertain: Use ranges (e.g., "sometime in 1920s")
- Duration event: Different start and end bounds
**EXAMPLE**:
```yaml
has_timespan:
begin_of_the_begin: "2001-01-01"
end_of_the_begin: "2001-01-01"
begin_of_the_end: "2001-01-01"
end_of_the_end: "2001-01-01"
description: "Merger effective January 1, 2001"
```
range: TimeSpan
required: false
inlined: true
exact_mappings:
- crm:P4_has_time-span
- rico:hasBeginningDate
- prov:atTime
took_place_at:
slot_uri: crm:P7_took_place_at
description: |
Location where this event took place.
Links to a Place reference (CustodianPlace or GeoSpatialPlace).
**CIDOC-CRM**: P7_took_place_at
- Domain: E4_Period (includes E5_Event)
- Range: E53_Place
**EXAMPLES**:
- Merger signed at headquarters: CustodianPlace
- Natural disaster affecting region: GeoSpatialPlace
range: uriorcurie
required: false
exact_mappings:
- crm:P7_took_place_at
- rico:hasOrHadLocation
- schema:location
has_or_had_involved_actor:
slot_uri: crm:P11_had_participant
description: |
Actors (persons and/or organizations) who participated in this event.
**CIDOC-CRM**: P11_had_participant
- Domain: E5_Event
- Range: E39_Actor
This slot can reference:
- Custodian hub (organizations)
- Person hub (individuals)
**INVERSE**: Actor.participated_in_events (to be added to Custodian/Person)
**EXAMPLE**:
```yaml
has_or_had_involved_actor:
- "https://nde.nl/ontology/hc/nl-nh-haa-a-gah" # Gemeentearchief Haarlem
- "https://nde.nl/ontology/hc/nl-nh-haa-a-ranh" # Rijksarchief NH
```
range: uriorcurie
multivalued: true
required: false
exact_mappings:
- crm:P11_had_participant
- prov:wasAssociatedWith
- schema:participant
event_label:
slot_uri: skos:prefLabel
description: |
Human-readable label for this event.
**EXAMPLE**: "Noord-Hollands Archief Merger 2001"
range: string
required: false
documentation_source:
slot_uri: dcterms:source
description: |
Sources documenting this event.
URLs to authoritative documents, news articles, official announcements,
or archival sources that provide evidence for the event.
range: uriorcurie
multivalued: true
required: false
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 has_timespan\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├── OrganizationalChangeEvent (existing - organizational\
\ changes)\n├── IntangibleHeritageEvent (future - ICH-related events)\n├── CollectionEvent\
\ (future - accession, deaccession, loan)\n└── 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 → TimeSpan (when)\n- crm:P7_took_place_at → Place (where)\n\
- crm:P11_had_participant → Actor (who)\n- crm:P2_has_type → 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 (has_timespan, involved_actors, took_place_at)\n2. Generic\
\ event typing (hypernym_event_type)\n3. Foundation for other event types\n\n\
Future migration: OrganizationalChangeEvent can inherit from Event.\n\n**RELATIONSHIP\
\ TO ACTORS**:\n\nEvents link to actors bidirectionally:\n- Event → involved_actors\
\ → Custodian/Person (who participated)\n- Custodian → organizational_change_events\
\ → Event (what events affected org)\n- Person → is_or_was_affected_by_event → 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\
\ has_timespan:\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 has_timespan:\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:
- confidence_score
- documentation_source
- event_description
- event_id
- event_label
- has_timespan
- hypernym_event_type
- has_or_had_involved_actor
- specificity_annotation
- template_specificity
- took_place_at
slot_usage:
event_id:
description: |
Persistent identifier for this event.
Format: https://nde.nl/ontology/hc/event/{event-slug}
**NAMING CONVENTION**:
- Use descriptive slug: {subject}-{action}-{year}
- Example: "nha-merger-2001", "gaza-library-destruction-2024"
required: true
identifier: true
hypernym_event_type:
description: |
Generic event type category.
This provides high-level classification using CIDOC-CRM event types:
- CREATION: Something came into being
- DESTRUCTION: Something ceased to exist
- TRANSFORMATION: Something changed nature (merger, split)
- TRANSFER: Custody/ownership changed
- MOVEMENT: Physical location changed
- MODIFICATION: Properties changed (rename)
- ACTIVITY: General purposeful action
- JOINING: Actor joined group
- LEAVING: Actor left group
required: true
has_timespan:
description: |
When this event occurred.
Uses TimeSpan class with CIDOC-CRM fuzzy temporal bounds.
For precise dates, set all four bounds to same value.
For uncertain dates, use ranges.
required: false
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
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 (has_timespan) is critical - enables fuzzy temporal reasoning
- Actor links (involved_actors) connect events to both persons and organizations
- hypernym_event_type provides cross-domain event queries
- 'Future: Add participated_in_events slot to Custodian and Person for inverse
navigation'
examples:
- value:
event_id: https://nde.nl/ontology/hc/event/nha-merger-2001
event_label: Noord-Hollands Archief Merger
hypernym_event_type: TRANSFORMATION
has_timespan:
begin_of_the_begin: '2001-01-01'
end_of_the_end: '2001-01-01'
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
description: Merger of two archives to form Noord-Hollands Archief
Reference in a new issue View git blame Copy permalink