glam/schemas/20251121/linkml/modules/classes/GenerationEvent.yaml

133 lines
4.4 KiB
YAML

# GenerationEvent - Event representing the generation/creation of something
#
# Created per slot_fixes.yaml migration for: chapters_generated_at
# Revision specifies: GenerationEvent with has_or_had_provenance + temporal_extent
# Updated 2026-01-19: Added has_or_had_score for confidence tracking (confidence_* migration)
# Creation date: 2026-01-19
id: https://nde.nl/ontology/hc/class/GenerationEvent
name: generation_event_class
title: Generation Event Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
prov: http://www.w3.org/ns/prov#
schema: http://schema.org/
imports:
- linkml:types
- ../slots/has_or_had_provenance
- ./Provenance
- ../slots/temporal_extent
- ./TimeSpan
- ../slots/has_or_had_description
- ../slots/has_or_had_score
- ./ConfidenceScore
default_prefix: hc
classes:
GenerationEvent:
description: >-
An event representing the generation or creation of an entity.
**USAGE**:
Used for tracking when and how something was generated, including:
- Video chapter generation (manual, AI, imported)
- Content extraction events
- Automated processing activities
- Confidence scoring for generated content
**STRUCTURE**:
- temporal_extent: When the generation occurred (TimeSpan)
- has_or_had_provenance: Who/what performed the generation (Provenance)
- has_or_had_description: Details about the generation process
- has_or_had_score: Confidence score for the generated content (ConfidenceScore)
**ONTOLOGY ALIGNMENT**:
- Maps to prov:Generation (PROV-O generation event)
- Also maps to schema:CreateAction (Schema.org action)
class_uri: prov:Generation
exact_mappings:
- prov:Generation
close_mappings:
- schema:CreateAction
slots:
- temporal_extent
- has_or_had_provenance
- has_or_had_description
- has_or_had_score
slot_usage:
temporal_extent:
description: When the generation event occurred
range: TimeSpan
required: false
inlined: true
examples:
- value:
begin_of_the_begin: "2024-01-15T10:30:00Z"
end_of_the_end: "2024-01-15T10:30:00Z"
description: Point-in-time generation event
has_or_had_provenance:
description: Provenance information about who/what generated the entity
range: Provenance
required: false
inlined: true
examples:
- value:
has_or_had_agent:
has_or_had_type: SOFTWARE
has_or_had_name: "YouTube Auto-Chapters"
description: AI-generated chapters
has_or_had_description:
description: Additional details about the generation process
range: string
required: false
examples:
- value: "Generated using Whisper transcript segmentation"
description: Description of generation method
has_or_had_score:
description: >-
Confidence score for the generation output. Uses ConfidenceScore class
to capture structured confidence with method and explanation.
range: ConfidenceScore
required: false
inlined: true
examples:
- value:
has_or_had_score: 0.95
has_or_had_method: "xpath_extraction"
has_or_had_description: "High confidence - exact match at expected location"
description: Confidence score for generated content
annotations:
custodian_types: '["*"]'
custodian_types_rationale: >-
Generation events are universal for tracking content creation.
custodian_types_primary: "*"
specificity_score: 0.30
specificity_rationale: >-
Moderately low specificity - used across many content types.
examples:
- value:
temporal_extent:
begin_of_the_begin: "2024-01-15T10:30:00Z"
has_or_had_description: "AI-generated video chapters from transcript"
has_or_had_score:
has_or_had_score: 0.92
has_or_had_method: "transcript_segmentation"
description: Video chapter generation event with confidence
comments:
- Created from slot_fixes.yaml migration (2026-01-19)
- Updated 2026-01-19 to include has_or_had_score for confidence tracking