glam/schemas/20251121/linkml/modules/classes/PublicationEvent.yaml
kempersc 47663e7c79 Refactor schema definitions and slots for improved temporal modeling and publisher representation
- Migrated `published_at` to `is_or_was_published_at` with structured `PublicationEvent` class for enhanced temporal accuracy.
- Introduced `has_or_had_publisher` slot to replace the string-based `publisher` slot, allowing for detailed publisher information.
- Added new slots: `deduction_percentage`, `regulatory_body`, `expiration_date`, and `jurisdiction` to support tax scheme documentation.
- Archived outdated slots: `published_by` and `publisher`, ensuring compliance with updated naming conventions and ontology alignment.
- Updated `Database` types to `DatabaseSystem` for consistency in technological infrastructure classification.
- Broadened range types for slots `allows_or_allowed` and `includes_or_included` from `string` to `uriorcurie` to resolve OWL ambiguities.
- Enhanced documentation and examples across various classes and slots to clarify usage and improve understanding.
2026-01-17 21:10:50 +01:00

99 lines
3.6 KiB
YAML

id: https://nde.nl/ontology/hc/class/PublicationEvent
name: publication_event_class
title: Publication Event Class
description: |
Event representing the publication of content, following CIDOC-CRM event modeling.
CREATED 2026-01-17 per Rule 53/56: Provides structured publication event
representation instead of simple datetime. Enables rich temporal modeling
including fuzzy date boundaries.
Supports:
- Social media posts with publication timestamps
- Document publications with date ranges
- Historical publications with uncertain dates
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
schema: http://schema.org/
prov: http://www.w3.org/ns/prov#
dcterms: http://purl.org/dc/terms/
imports:
- linkml:types
- ./TimeSpan
- ../slots/temporal_extent
- ../slots/has_or_had_label
- ../slots/has_or_had_identifier
- ../slots/specificity_annotation
- ../slots/has_or_had_score
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
default_prefix: hc
classes:
PublicationEvent:
class_uri: crm:E7_Activity
description: |
Event of content being published, following CIDOC-CRM activity pattern.
MIGRATED from published_at datetime slot per Rule 53/56 (2026-01-17).
**Why Event Wrapper?**
- Enables fuzzy temporal boundaries (uncertainty in publication dates)
- Supports multiple publication events (republications, versions)
- Links to agents/locations involved in publication
- Follows ontology best practices (CIDOC-CRM activity modeling)
**USE CASES**:
- Social media posts: Precise publication timestamp
- Historical documents: "Published sometime in 1892"
- Archival records: "Published between 1800-1805"
**FOR PRECISE TIMESTAMPS**:
Set all four TimeSpan boundaries to the same instant.
exact_mappings:
- crm:E7_Activity
- prov:Activity
close_mappings:
- schema:PublishAction
related_mappings:
- dcterms:created
slots:
- temporal_extent
- has_or_had_label
- has_or_had_identifier
- specificity_annotation
- has_or_had_score
slot_usage:
temporal_extent:
description: |
When the publication occurred. For precise timestamps, set all four
TimeSpan boundaries to the same instant. For uncertain dates, use
fuzzy boundaries.
range: TimeSpan
inlined: true
required: true
has_or_had_label:
description: Optional label for the publication event (e.g., "First Edition", "Reprint 2020")
required: false
comments:
- "Precise date: Set begin_of_the_begin == end_of_the_begin == begin_of_the_end == end_of_the_end"
- "Uncertain date: Use fuzzy boundaries (e.g., begin_of_the_begin: 1892-01-01, end_of_the_end: 1892-12-31)"
examples:
- value:
temporal_extent:
begin_of_the_begin: "2025-07-30T18:05:15Z"
end_of_the_begin: "2025-07-30T18:05:15Z"
begin_of_the_end: "2025-07-30T18:05:15Z"
end_of_the_end: "2025-07-30T18:05:15Z"
description: Precise social media post timestamp
- value:
temporal_extent:
begin_of_the_begin: "1892-01-01T00:00:00Z"
end_of_the_begin: "1892-06-30T00:00:00Z"
begin_of_the_end: "1892-06-30T00:00:00Z"
end_of_the_end: "1892-12-31T00:00:00Z"
has_or_had_label: "First Edition"
description: Historical publication with uncertain date (sometime in 1892)