kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/VideoTimeSegment.yaml
kempersc ca4a54181e Refactor schema files to improve clarity and maintainability 
- Updated WorldCatIdentifier.yaml to remove unnecessary description and ensure consistent formatting.
- Enhanced WorldHeritageSite.yaml by breaking long description into multiple lines for better readability and removed unused attributes.
- Simplified WritingSystem.yaml by removing redundant attributes and ensuring consistent formatting.
- Cleaned up XPathScore.yaml by removing unnecessary attributes and ensuring consistent formatting.
- Improved YoutubeChannel.yaml by breaking long description into multiple lines for better readability.
- Enhanced YoutubeEnrichment.yaml by breaking long description into multiple lines for better readability.
- Updated YoutubeVideo.yaml to break long description into multiple lines and removed legacy field name.
- Refined has_or_had_affiliation.yaml by removing unnecessary comments and ensuring clarity.
- Cleaned up is_or_was_retrieved_at.yaml by removing unnecessary comments and ensuring clarity.
- Added rules for generic slots and avoiding rough edits in schema files to maintain structural integrity.
- Introduced changes_or_changed_through.yaml to define a new slot for linking entities to change events.
2026-01-31 00:46:23 +01:00

250 lines
6.8 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/VideoTimeSegment
name: video_time_segment_class
title: Video Time Segment Class
imports:
- linkml:types
- ../slots/has_or_had_score
- ../slots/has_or_had_time_interval
- ../slots/is_or_was_generated_by
- ../slots/segment_index
- ../slots/segment_text
- ../slots/speaker_id
- ../slots/speaker_label
- ../slots/specificity_annotation
- ./ConfidenceScore
- ./GenerationEvent
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ./TimeInterval
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
crm: http://www.cidoc-crm.org/cidoc-crm/
oa: http://www.w3.org/ns/oa#
ma: http://www.w3.org/ns/ma-ont#
prov: http://www.w3.org/ns/prov#
skos: http://www.w3.org/2004/02/skos/core#
rdfs: http://www.w3.org/2000/01/rdf-schema#
org: http://www.w3.org/ns/org#
xsd: http://www.w3.org/2001/XMLSchema#
default_prefix: hc
classes:
VideoTimeSegment:
class_uri: crm:E52_Time-Span
abstract: false
description: 'A temporal segment within a video, defined by start and end times.
**DEFINITION**:
VideoTimeSegment represents a bounded temporal portion of video content.
It is the foundational unit for time-coded content including:
- Subtitle/caption entries (text displayed at specific times)
- Annotation segments (detected scenes, objects, faces)
- Chapter markers (user-defined content sections)
**DUAL TIME REPRESENTATION**:
Times are stored in two formats for different use cases:
| Format | Example | Use Case |
|--------|---------|----------|
| ISO 8601 duration | PT0M30S | Human-readable, serialization |
| Seconds (float) | 30.0 | Computation, synchronization |
Both representations MUST be kept in sync. The seconds format is
primary for computation; ISO 8601 is derived for display/storage.
**MEDIA FRAGMENTS URI (W3C)**:
VideoTimeSegment aligns with W3C Media Fragments URI 1.0 specification
for addressing temporal fragments of video:
```
https://example.com/video.mp4#t=30,35
```
The `start_seconds` and `end_seconds` map directly to the `t=` parameter.
**WEB ANNOTATION COMPATIBILITY**:
When used as an annotation target selector:
- Maps to `oa:FragmentSelector` with `conformsTo` Media Fragments
- Enables interoperability with W3C Web Annotation Data Model
**CIDOC-CRM E52_Time-Span**:
In cultural heritage documentation:
- E52_Time-Span is the extent of a time-span
- Used for temporal properties of cultural objects
- VideoTimeSegment extends this to media-specific temporal segments
**CONFIDENCE SCORING**:
For segments generated by ASR (speech recognition) or CV (computer vision):
- `confidence`: 0.0-1.0 score for segment accuracy
- Enables filtering by quality threshold
- Critical for AI-generated transcripts and annotations
**HERITAGE USE CASES**:
| Use Case | Example | Start | End |
|----------|---------|-------|-----|
| Subtitle entry | "Welcome to the museum" | 0:30 | 0:35 |
| Scene annotation | "Exhibition hall panorama" | 1:00 | 1:30 |
| Chapter marker | "Introduction" | 0:00 | 2:00 |
| Object detection | "Painting: Night Watch" | 3:15 | 3:20 |
| Speaker change | "Curator speaking" | 5:00 | 7:30 |
'
exact_mappings:
- crm:E52_Time-Span
- oa:FragmentSelector
close_mappings:
- ma:MediaFragment
related_mappings:
- schema:Clip
slots:
- has_or_had_time_interval
- segment_index
- segment_text
- speaker_id
- speaker_label
- specificity_annotation
- has_or_had_score
- is_or_was_generated_by
attributes:
start_time:
range: string
required: false
pattern: ^PT(\d+H)?(\d+M)?(\d+(\.\d+)?S)?$
description: 'Start time of the segment in ISO 8601 duration format (e.g. PT30S).
Defined as attribute to avoid dependency on archived start_time slot.
'
examples:
- value: PT0M30S
description: 30 seconds from video start
- value: PT1H15M30S
description: 1 hour 15 minutes 30 seconds
start_seconds:
range: float
required: true
minimum_value: 0.0
description: 'Start time of the segment in seconds.
Defined as attribute to avoid dependency on archived start_seconds slot.
'
examples:
- value: 30.0
description: 30 seconds from start
- value: 30.5
description: 30.5 seconds (millisecond precision)
slot_usage:
has_or_had_time_interval:
range: TimeInterval
required: true
inlined: true
examples:
- value:
segment_text:
range: string
required: false
examples:
- value: Welkom bij het Rijksmuseum
- value: The curator explains the painting's history
segment_index:
range: integer
required: false
minimum_value: 0
examples:
- value: 0
- value: 42
is_or_was_generated_by:
range: GenerationEvent
required: false
inlined: true
description: 'Generation event containing confidence score for ASR/CV segment accuracy. MIGRATED 2026-01-19: Replaces confidence slot with structured pattern.'
examples:
- value:
has_or_had_score:
has_or_had_score: 0.95
has_or_had_method: asr_transcription
- value:
has_or_had_score:
has_or_had_score: 0.72
has_or_had_method: cv_detection
speaker_id:
range: string
required: false
examples:
- value: SPEAKER_01
- value: curator_taco_dibbits
speaker_label:
range: string
required: false
examples:
- value: Narrator
- value: Dr. Taco Dibbits, Museum Director
rules:
- postconditions:
comments:
- Reusable time segment for subtitles, annotations, chapters
- 'Dual time format: ISO 8601 for serialization, seconds for computation'
- Aligns with W3C Media Fragments URI specification
- Confidence scoring for AI-generated content
- Speaker diarization support for multi-speaker transcripts
- "MIGRATED 2026-01-19: confidence \u2192 is_or_was_generated_by + ConfidenceScore"
see_also:
- https://www.w3.org/TR/media-frags/
- https://www.w3.org/TR/annotation-model/
- https://www.w3.org/ns/ma-ont
- http://www.cidoc-crm.org/cidoc-crm/E52_Time-Span
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"
Reference in a new issue View git blame Copy permalink