kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/VideoTextContent.yaml
kempersc 6c3fa6b5a3 Remove deprecated slots and add new slot definitions for enhanced data modeling 
- Deleted obsolete slot definitions for work_location and workshop_space.
- Introduced new TaxonName class to represent scientific taxonomic names with detailed attributes.
- Archived existing slots related to surname_prefix, target_name, taxon_name, terminal_count, text_region_count, title, title_proper, total_chapter, total_characters_extracted, total_connections_extracted, track_name, transcript_format, traveling_venue, type_label, type_status, typical_responsibility, unesco_domain, unesco_inscription_year, unesco_list_status, uniform_title, unit_name, used_by_custodian, uv_filtered_required, valid_from_geo, valid_to_geo, validation_status, variant_of_name, verification_date, viability_status, within_auxiliary_place, and within_place.
- Updated slot descriptions and structures to improve clarity and compliance with standards.
2026-01-15 11:42:35 +01:00

263 lines
10 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/VideoTextContent
name: video_text_content_class
title: Video Text Content Class
imports:
- linkml:types
- ./VideoPost
- ../slots/character_count
- ../slots/content_language
- ../slots/content_title
- ../slots/generated_by
- ../slots/generation_method
- ../slots/generation_timestamp
- ../slots/is_verified
- ../slots/model_provider
- ../slots/model_version
- ../slots/overall_confidence
- ../slots/processing_duration_seconds
- ../slots/source_video
- ../slots/source_video_url
- ../slots/specificity_annotation
- ../slots/template_specificity
- ../slots/temporal_extent # was: verification_date - migrated per Rule 53
- ./TimeSpan
# REMOVED 2026-01-14: verification_date - migrated to temporal_extent (Rule 53)
# REMOVED: ../slots/verified_by - migrated to is_or_was_verified_by with Verifier (2026-01-14, Rule 53)
- ../slots/is_or_was_verified_by
- ./Verifier
# REMOVED: ../slots/word_count - migrated to has_or_had_quantity with WordCount (2026-01-14, Rule 53)
- ../slots/has_or_had_quantity
- ./WordCount
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
- ../enums/GenerationMethodEnum
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
prov: http://www.w3.org/ns/prov#
crm: http://www.cidoc-crm.org/cidoc-crm/
skos: http://www.w3.org/2004/02/skos/core#
oa: http://www.w3.org/ns/oa#
default_prefix: hc
classes:
VideoTextContent:
class_uri: crm:E73_Information_Object
abstract: true
description: "Abstract base class for all textual/derived content from videos.\n\n**DEFINITION**:\n\nVideoTextContent\
\ is the abstract parent for all text that is extracted,\ntranscribed, or derived from video content. This includes:\n\
\n| Subclass | Source | Description |\n|----------|--------|-------------|\n| VideoTranscript | Audio | Full text transcription\
\ of spoken content |\n| VideoSubtitle | Audio | Time-coded caption entries (SRT/VTT) |\n| VideoAnnotation | Visual\
\ | CV/multimodal-derived descriptions |\n\n**PROVENANCE REQUIREMENTS**:\n\nAll video-derived text MUST include comprehensive\
\ provenance:\n\n1. **Source**: Which video was processed (`source_video`)\n2. **Method**: How was content generated\
\ (`generation_method`)\n3. **Agent**: Who/what generated it (`generated_by`)\n4. **Time**: When was it generated (`generation_timestamp`)\n\
5. **Version**: Tool/model version (`model_version`)\n6. **Quality**: Overall confidence (`overall_confidence`)\n\n\
**PROV-O ALIGNMENT**:\n\nMaps to W3C PROV-O for provenance tracking:\n\n```turtle\n:transcript a hc:VideoTranscript\
\ ;\n prov:wasGeneratedBy :asr_activity ;\n prov:wasAttributedTo :whisper_model ;\n prov:generatedAtTime \"\
2025-12-01T10:00:00Z\" ;\n prov:wasDerivedFrom :source_video .\n```\n\n**CIDOC-CRM E73_Information_Object**:\n\n\
- E73 is the base for all identifiable immaterial items\n- Includes texts, computer programs, songs, recipes\n- VideoTextContent\
\ are E73 instances derived from video (E73)\n\n**GENERATION METHODS**:\n\n| Method | Description | Typical Confidence\
\ |\n|--------|-------------|-------------------|\n| ASR_AUTOMATIC | Automatic speech recognition | 0.75-0.95 |\n| ASR_ENHANCED\
\ | ASR with post-processing | 0.85-0.98 |\n| MANUAL_TRANSCRIPTION | Human transcription | 0.98-1.0 |\n| MANUAL_CORRECTION\
\ | Human-corrected ASR | 0.95-1.0 |\n| CV_AUTOMATIC | Computer vision detection | 0.60-0.90 |\n| MULTIMODAL | Combined\
\ audio+visual AI | 0.70-0.95 |\n| OCR | Optical character recognition | 0.80-0.98 |\n| PLATFORM_PROVIDED | From YouTube/Vimeo\
\ API | 0.85-0.95 |\n\n**HERITAGE INSTITUTION CONTEXT**:\n\nVideo text content is critical for:\n- **Accessibility**:\
\ Deaf/HoH users need accurate captions\n- **Discovery**: Full-text search over video collections\n- **Preservation**:\
\ Text outlasts video format obsolescence\n- **Research**: Analyzing spoken content at scale\n- **Translation**: Multilingual\
\ access to heritage content\n\n**LANGUAGE SUPPORT**:\n\n- `content_language`: Primary language of text content\n- May\
\ differ from video's default_audio_language if translated\n- ISO 639-1 codes (e.g., \"nl\", \"en\", \"de\")\n"
exact_mappings:
- crm:E73_Information_Object
close_mappings:
- prov:Entity
related_mappings:
- schema:CreativeWork
- dcterms:Text
slots:
- character_count
- content_language
- content_title
- generated_by
- generation_method
- generation_timestamp
- is_verified
- model_provider
- model_version
- overall_confidence
- processing_duration_seconds
- source_video
- source_video_url
- specificity_annotation
- template_specificity
- temporal_extent # was: verification_date - migrated per Rule 53
# REMOVED: verified_by - migrated to is_or_was_verified_by with Verifier (2026-01-14, Rule 53)
- is_or_was_verified_by
# REMOVED: word_count - migrated to has_or_had_quantity with WordCount (2026-01-14, Rule 53)
- has_or_had_quantity
slot_usage:
source_video:
range: string
required: true
examples:
- value: FbIoC-Owy-M
description: YouTube video ID as source reference
source_video_url:
range: uri
required: false
examples:
- value: https://www.youtube.com/watch?v=FbIoC-Owy-M
description: Full YouTube video URL
content_language:
range: string
required: true
examples:
- value: nl
description: Dutch language content
- value: en
description: English translation
content_title:
range: string
required: false
examples:
- value: De Vrijheidsroute Ep.3 - Dutch Transcript
description: Descriptive title for transcript
generated_by:
range: string
required: true
examples:
- value: openai/whisper-large-v3
description: OpenAI Whisper ASR model
- value: YouTube Auto-captions
description: Platform-provided captions
- value: manual:curator@rijksmuseum.nl
description: Human transcriber
generation_method:
range: GenerationMethodEnum
required: true
examples:
- value: ASR_AUTOMATIC
description: Automatic speech recognition
- value: MANUAL_TRANSCRIPTION
description: Human transcription
generation_timestamp:
range: datetime
required: true
examples:
- value: '2025-12-01T10:30:00Z'
description: Generated December 1, 2025 at 10:30 UTC
model_version:
range: string
required: false
examples:
- value: large-v3
description: Whisper model version
- value: v2.3.1
description: Software version number
model_provider:
range: string
required: false
examples:
- value: OpenAI
description: Model provider
- value: Google Cloud
description: Cloud service provider
overall_confidence:
range: float
required: false
minimum_value: 0.0
maximum_value: 1.0
examples:
- value: 0.92
description: High confidence ASR output
is_verified:
range: boolean
required: false
ifabsent: 'false'
examples:
- value: true
description: Human-verified transcript
# DEPRECATED: verified_by - migrated to is_or_was_verified_by with Verifier (2026-01-14, Rule 53)
# verified_by:
# range: string
# required: false
# examples:
# - value: curator@rijksmuseum.nl
# description: Staff member who verified
is_or_was_verified_by:
range: Verifier
required: false
inlined: true
description: |
Who verified the annotation.
MIGRATED from verified_by slot (2026-01-14) per Rule 53.
Uses Verifier class for structured verifier with name, type, and URI.
examples:
- value: |
verifier_name: curator@rijksmuseum.nl
verifier_type: PERSON
description: Staff member who verified
# DEPRECATED: verification_date - migrated to temporal_extent with TimeSpan (2026-01-14, Rule 53)
# verification_date:
# range: datetime
# required: false
# examples:
# - value: '2025-12-02T15:00:00Z'
# description: Verified December 2, 2025
temporal_extent: # was: verification_date - migrated per Rule 53
description: |
Verification date using CIDOC-CRM TimeSpan.
MIGRATED from verification_date per slot_fixes.yaml (Rule 53).
Use begin_of_the_begin for the verification timestamp.
range: TimeSpan
inlined: true
required: false
examples:
- value:
begin_of_the_begin: '2025-12-02T15:00:00Z'
description: Verified December 2, 2025
processing_duration_seconds:
range: float
required: false
minimum_value: 0.0
examples:
- value: 45.3
description: Processed in 45.3 seconds
# DEPRECATED: word_count - migrated to has_or_had_quantity with WordCount (2026-01-14, Rule 53)
# word_count:
# range: integer
# required: false
# minimum_value: 0
# examples:
# - value: 1523
# description: 1,523 words in transcript
has_or_had_quantity:
range: WordCount
required: false
inlined: true
description: |
Word count in the transcript.
MIGRATED from word_count slot (2026-01-14) per Rule 53.
Uses WordCount class for structured quantity with value.
examples:
- value: |
value: 1523
description: 1,523 words in transcript
character_count:
range: integer
required: false
minimum_value: 0
examples:
- value: 8742
description: 8,742 characters
comments:
- Abstract base for all video-derived text content
- Comprehensive PROV-O provenance tracking
- Confidence scoring for AI-generated content
- Verification workflow support
- Critical for heritage accessibility and discovery
see_also:
- https://www.w3.org/TR/prov-o/
- http://www.cidoc-crm.org/cidoc-crm/E73_Information_Object
Reference in a new issue View git blame Copy permalink