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

139 lines
4.4 KiB
YAML

id: https://nde.nl/ontology/hc/class/VideoChapterList
name: video_chapter_list_class
title: Video Chapter List Class
imports:
- linkml:types
- ./VideoChapter
- ../slots/specificity_annotation
- ./SpecificityAnnotation
- ../slots/has_or_had_score
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ../slots/has_or_had_identifier
- ./VideoIdentifier
- ../slots/has_or_had_chapter
- ../slots/has_or_had_quantity
- ./Quantity
- ../slots/has_or_had_source
- ./Source
- ../slots/is_or_was_generated_by
- ./GenerationEvent
- ./Provenance
- ./TimeSpan
- ../slots/covers_full_video
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
prov: http://www.w3.org/ns/prov#
default_prefix: hc
classes:
VideoChapterList:
class_uri: schema:ItemList
description: 'A collection of chapters for a video.
Groups all chapters for a video with metadata about the chapter set.
Enables bulk operations on chapters:
- Import/export of chapter lists
- Validation of chapter coverage
- Source tracking for entire chapter set
'
exact_mappings:
- schema:ItemList
slots:
- has_or_had_chapter
- is_or_was_generated_by
- has_or_had_source
- covers_full_video
- has_or_had_quantity
- specificity_annotation
- has_or_had_score
- has_or_had_identifier
slot_usage:
has_or_had_identifier:
description: Reference to the parent video
range: VideoIdentifier
required: true
inlined: true
examples:
- value: '{"has_or_had_code": "dQw4w9WgXcQ", "platform": "YouTube"}'
description: YouTube video identifier
has_or_had_chapter:
range: VideoChapter
multivalued: true
required: true
inlined_as_list: true
has_or_had_quantity:
range: Quantity
required: false
inlined: true
description: 'Total number of chapters in this list.
MIGRATED 2026-01-14: Replaces total_chapter slot.
'
examples:
- value:
quantity_value: 12
quantity_type: CHAPTER_COUNT
has_or_had_measurement_unit:
has_or_had_type: CHAPTER
has_or_had_symbol: chapters
description: 12 chapters in this video
has_or_had_source:
description: Primary source for this chapter list. Uses Source class to capture how chapters were generated (manual, AI, imported, etc.).
range: Source
required: false
inlined: true
examples:
- value:
has_or_had_type: MANUAL
has_or_had_label: Creator-defined chapters
description: Manually defined chapters
- value:
has_or_had_type: YOUTUBE_AI
has_or_had_label: YouTube Auto-Chapters
description: YouTube AI-generated chapters
- value:
has_or_had_type: WHISPER_CHAPTERS
has_or_had_label: Whisper Analysis
has_or_had_description: Generated from transcript topic segmentation
description: Whisper-derived chapters
is_or_was_generated_by:
description: 'Generation event capturing when and how the chapter list was created. MIGRATED 2026-01-19: Replaces chapters_generated_at slot (Rule 53).'
range: GenerationEvent
required: false
inlined: true
examples:
- value:
temporal_extent:
begin_of_the_begin: '2024-01-15T10:30:00Z'
end_of_the_end: '2024-01-15T10:30:00Z'
has_or_had_provenance:
has_or_had_agent:
has_or_had_type: SOFTWARE
has_or_had_name: YouTube Auto-Chapters
has_or_had_description: AI-generated chapters from video analysis
description: AI chapter generation event with timestamp and provenance
- value:
temporal_extent:
begin_of_the_begin: '2024-03-20T14:00:00Z'
has_or_had_description: Manually created by content creator
description: Manual chapter creation event
covers_full_video:
range: boolean
required: false
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types:
- '*'
custodian_types_rationale: Universal utility concept