174a420c08
All checks were successful
Deploy Frontend / build-and-deploy (push) Successful in 3m57s
- Remove inline slot definitions from 144 class files - Create 7 new centralized slot files in modules/slots/: - custodian_type_broader.yaml - custodian_type_narrower.yaml - custodian_type_related.yaml - definition.yaml - finding_aid_access_restriction.yaml - finding_aid_description.yaml - finding_aid_temporal_coverage.yaml - Add centralize_inline_slots.py automation script - Update manifest with new timestamp Rule 48: Class files must NOT define inline slots - all slots must be imported from modules/slots/ directory. Note: Pre-existing IdentifierFormat duplicate class definition (in Standard.yaml and IdentifierFormat.yaml) not addressed in this commit - requires separate schema refactor.
396 lines
13 KiB
YAML
396 lines
13 KiB
YAML
id: https://nde.nl/ontology/hc/class/VideoTranscript
|
|
name: video_transcript_class
|
|
title: Video Transcript Class
|
|
imports:
|
|
- linkml:types
|
|
- ./VideoTextContent
|
|
- ./VideoTimeSegment
|
|
- ../slots/full_text
|
|
- ../slots/includes_speaker
|
|
- ../slots/includes_timestamp
|
|
- ../slots/paragraph_count
|
|
- ../slots/primary_speaker
|
|
- ../slots/has_or_had_segment
|
|
- ../slots/sentence_count
|
|
- ../slots/source_language_auto_detected
|
|
- ../slots/speaker_count
|
|
- ../slots/specificity_annotation
|
|
- ../slots/template_specificity
|
|
- ../slots/transcript_format
|
|
- ./SpecificityAnnotation
|
|
- ./TemplateSpecificityScores
|
|
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#
|
|
default_prefix: hc
|
|
classes:
|
|
VideoTranscript:
|
|
is_a: VideoTextContent
|
|
class_uri: crm:E33_Linguistic_Object
|
|
abstract: false
|
|
description: "Full text transcription of video audio content.\n\n**DEFINITION**:\n\nA VideoTranscript is the complete\
|
|
\ textual representation of all spoken\ncontent in a video. It extends VideoTextContent with transcript-specific\nproperties\
|
|
\ and inherits all provenance tracking capabilities.\n\n**RELATIONSHIP TO VideoSubtitle**:\n\nVideoSubtitle is a subclass\
|
|
\ of VideoTranscript because:\n1. A subtitle file contains everything a transcript needs PLUS time codes\n2. You can\
|
|
\ derive a plain transcript from subtitles by stripping times\n3. This inheritance allows polymorphic handling of text\
|
|
\ content\n\n```\nVideoTranscript VideoSubtitle (is_a VideoTranscript)\n├── full_text ├── full_text\
|
|
\ (inherited)\n├── segments[] ├── segments[] (required, with times)\n└── (optional times) └── subtitle_format\
|
|
\ (SRT, VTT, etc.)\n```\n\n**SCHEMA.ORG ALIGNMENT**:\n\nMaps to `schema:transcript` property:\n> \"If this MediaObject\
|
|
\ is an AudioObject or VideoObject, \n> the transcript of that object.\"\n\n**CIDOC-CRM E33_Linguistic_Object**:\n\n\
|
|
E33 is the class comprising:\n> \"identifiable expressions in natural language or code\"\n\nA transcript is a linguistic\
|
|
\ object derived from the audio track of\na video (which is itself an E73_Information_Object).\n\n**TRANSCRIPT FORMATS**:\n\
|
|
\n| Format | Description | Use Case |\n|--------|-------------|----------|\n| PLAIN_TEXT | Continuous text, no structure\
|
|
\ | Simple search indexing |\n| PARAGRAPHED | Text broken into paragraphs | Human reading |\n| STRUCTURED | Segments\
|
|
\ with speaker labels | Research, analysis |\n| TIMESTAMPED | Segments with time markers | Navigation, subtitling |\n\
|
|
\n**GENERATION METHODS** (inherited from VideoTextContent):\n\n| Method | Typical Use | Quality |\n|--------|-------------|---------|\n\
|
|
| ASR_AUTOMATIC | Whisper, Google STT | 0.80-0.95 |\n| MANUAL_TRANSCRIPTION | Human transcriber | 0.98-1.0 |\n| PLATFORM_PROVIDED\
|
|
\ | YouTube auto-captions | 0.75-0.90 |\n| HYBRID | ASR + human correction | 0.95-1.0 |\n\n**HERITAGE INSTITUTION CONTEXT**:\n\
|
|
\nTranscripts are critical for heritage video collections:\n\n1. **Discovery**: Full-text search over video content\n\
|
|
2. **Accessibility**: Deaf/HoH access to spoken content\n3. **Preservation**: Text outlasts video format obsolescence\n\
|
|
4. **Research**: Corpus analysis, keyword extraction\n5. **Translation**: Base for multilingual access\n6. **SEO**:\
|
|
\ Search engine indexing of video content\n\n**STRUCTURED SEGMENTS**:\n\nWhen `segments` is populated, the transcript\
|
|
\ has structural breakdown:\n\n```yaml\nsegments:\n - segment_index: 0\n start_seconds: 0.0\n end_seconds: 5.5\n\
|
|
\ segment_text: \"Welcome to the Rijksmuseum.\"\n speaker_label: \"Narrator\"\n confidence: 0.94\n - segment_index:\
|
|
\ 1\n start_seconds: 5.5\n end_seconds: 12.3\n segment_text: \"Today we'll explore the Night Watch gallery.\"\
|
|
\n speaker_label: \"Narrator\"\n confidence: 0.91\n```\n\n**PROVENANCE** (inherited from VideoTextContent):\n\n\
|
|
All transcripts include:\n- `source_video`: Which video was transcribed\n- `generated_by`: Tool/person that created\
|
|
\ transcript\n- `generation_method`: ASR_AUTOMATIC, MANUAL_TRANSCRIPTION, etc.\n- `generation_timestamp`: When transcript\
|
|
\ was created\n- `overall_confidence`: Aggregate quality score\n- `is_verified`: Whether human-reviewed\n"
|
|
exact_mappings:
|
|
- crm:E33_Linguistic_Object
|
|
close_mappings:
|
|
- schema:transcript
|
|
related_mappings:
|
|
- dcterms:Text
|
|
slots:
|
|
- full_text
|
|
- includes_speaker
|
|
- includes_timestamp
|
|
- paragraph_count
|
|
- primary_speaker
|
|
- has_or_had_segment
|
|
- sentence_count
|
|
- source_language_auto_detected
|
|
- speaker_count
|
|
- specificity_annotation
|
|
- template_specificity
|
|
- transcript_format
|
|
slot_usage:
|
|
full_text:
|
|
slot_uri: schema:text
|
|
description: 'Complete transcript text as a single string.
|
|
|
|
|
|
Schema.org: text for primary textual content.
|
|
|
|
|
|
Contains all spoken content from the video, concatenated.
|
|
|
|
May include:
|
|
|
|
- Speaker labels (if includes_speakers = true)
|
|
|
|
- Timestamps (if includes_timestamps = true)
|
|
|
|
- Paragraph breaks (if format = PARAGRAPHED or STRUCTURED)
|
|
|
|
|
|
For structured access, use the `segments` slot instead.
|
|
|
|
'
|
|
range: string
|
|
required: true
|
|
examples:
|
|
- value: 'Welcome to the Rijksmuseum. Today we''ll explore the masterpieces
|
|
|
|
of Dutch Golden Age painting. Our first stop is the Night Watch
|
|
|
|
by Rembrandt van Rijn, painted in 1642.
|
|
|
|
'
|
|
description: Plain text transcript excerpt
|
|
- value: '[Narrator] Welcome to the Rijksmuseum.
|
|
|
|
[Narrator] Today we''ll explore the masterpieces of Dutch Golden Age painting.
|
|
|
|
[Curator] Our first stop is the Night Watch by Rembrandt van Rijn.
|
|
|
|
'
|
|
description: Transcript with speaker labels
|
|
transcript_format:
|
|
slot_uri: dcterms:format
|
|
description: 'Format/structure of the transcript text.
|
|
|
|
|
|
Dublin Core: format for resource format.
|
|
|
|
|
|
Indicates how the full_text is structured:
|
|
|
|
- PLAIN_TEXT: Continuous text without breaks
|
|
|
|
- PARAGRAPHED: Broken into paragraphs
|
|
|
|
- STRUCTURED: Includes speaker labels, times, or both
|
|
|
|
- TIMESTAMPED: Includes inline time markers
|
|
|
|
'
|
|
range: TranscriptFormatEnum
|
|
required: false
|
|
ifabsent: string(PLAIN_TEXT)
|
|
examples:
|
|
- value: STRUCTURED
|
|
description: Text with speaker labels and paragraph breaks
|
|
includes_timestamp:
|
|
slot_uri: hc:includesTimestamps
|
|
description: 'Whether the transcript includes time markers.
|
|
|
|
|
|
- **true**: Timestamps are embedded in full_text or segments have times
|
|
|
|
- **false**: No temporal information (default)
|
|
|
|
|
|
If true, prefer using `segments` for programmatic access.
|
|
|
|
'
|
|
range: boolean
|
|
required: false
|
|
ifabsent: 'false'
|
|
examples:
|
|
- value: true
|
|
description: Transcript has time codes
|
|
includes_speaker:
|
|
slot_uri: hc:includesSpeakers
|
|
description: 'Whether the transcript includes speaker identification.
|
|
|
|
|
|
- **true**: Speaker labels/diarization available
|
|
|
|
- **false**: Single speaker or no identification (default)
|
|
|
|
|
|
When true, check `speaker_count` for number of distinct speakers.
|
|
|
|
'
|
|
range: boolean
|
|
required: false
|
|
ifabsent: 'false'
|
|
examples:
|
|
- value: true
|
|
description: Multi-speaker transcript with diarization
|
|
has_or_had_segment:
|
|
slot_uri: hc:transcriptSegments
|
|
description: 'Structured breakdown of transcript into time-coded segments.
|
|
|
|
|
|
Optional for VideoTranscript (plain transcripts may not have times).
|
|
|
|
Required for VideoSubtitle (subtitles must have time codes).
|
|
|
|
|
|
Each segment is a VideoTimeSegment with:
|
|
|
|
- start_seconds / end_seconds: Time boundaries
|
|
|
|
- segment_text: Text for this segment
|
|
|
|
- confidence: Per-segment accuracy score
|
|
|
|
- speaker_id / speaker_label: Speaker identification
|
|
|
|
|
|
Use segments for:
|
|
|
|
- Video player synchronization
|
|
|
|
- Jump-to-time navigation
|
|
|
|
- Per-segment quality analysis
|
|
|
|
- Speaker-separated views
|
|
|
|
'
|
|
range: VideoTimeSegment
|
|
required: false
|
|
multivalued: true
|
|
inlined: true
|
|
inlined_as_list: true
|
|
examples:
|
|
- value: "- segment_index: 0\n start_seconds: 0.0\n end_seconds: 3.5\n segment_text: \"Welcome to the museum.\"\
|
|
\n confidence: 0.95\n"
|
|
description: Single structured segment
|
|
speaker_count:
|
|
slot_uri: hc:speakerCount
|
|
description: 'Number of distinct speakers identified in the transcript.
|
|
|
|
|
|
Only meaningful when includes_speakers = true.
|
|
|
|
|
|
0 = Unknown/not analyzed
|
|
|
|
1 = Single speaker (monologue)
|
|
|
|
2+ = Multi-speaker (dialogue, panel, interview)
|
|
|
|
'
|
|
range: integer
|
|
required: false
|
|
minimum_value: 0
|
|
examples:
|
|
- value: 3
|
|
description: Three speakers identified
|
|
primary_speaker:
|
|
slot_uri: hc:primarySpeaker
|
|
description: 'Identifier or name of the main/dominant speaker.
|
|
|
|
|
|
For interviews: the interviewee (not interviewer)
|
|
|
|
For presentations: the presenter
|
|
|
|
For tours: the guide
|
|
|
|
|
|
May be generic ("Narrator") or specific ("Dr. Taco Dibbits").
|
|
|
|
'
|
|
range: string
|
|
required: false
|
|
examples:
|
|
- value: Narrator
|
|
description: Generic primary speaker
|
|
- value: Dr. Taco Dibbits, Museum Director
|
|
description: Named primary speaker
|
|
source_language_auto_detected:
|
|
slot_uri: hc:sourceLanguageAutoDetected
|
|
description: 'Whether the content_language was auto-detected by ASR.
|
|
|
|
|
|
- **true**: Language detected by ASR model
|
|
|
|
- **false**: Language was specified/known (default)
|
|
|
|
|
|
Useful for quality assessment - auto-detection may be wrong.
|
|
|
|
'
|
|
range: boolean
|
|
required: false
|
|
ifabsent: 'false'
|
|
examples:
|
|
- value: true
|
|
description: Language was auto-detected
|
|
paragraph_count:
|
|
slot_uri: hc:paragraphCount
|
|
description: 'Number of paragraphs in the transcript.
|
|
|
|
|
|
Only meaningful when transcript_format = PARAGRAPHED or STRUCTURED.
|
|
|
|
|
|
Useful for content sizing and readability assessment.
|
|
|
|
'
|
|
range: integer
|
|
required: false
|
|
minimum_value: 0
|
|
examples:
|
|
- value: 15
|
|
description: Transcript has 15 paragraphs
|
|
sentence_count:
|
|
slot_uri: hc:sentenceCount
|
|
description: 'Approximate number of sentences in the transcript.
|
|
|
|
|
|
Derived from punctuation analysis or NLP sentence segmentation.
|
|
|
|
|
|
Useful for content analysis and readability metrics.
|
|
|
|
'
|
|
range: integer
|
|
required: false
|
|
minimum_value: 0
|
|
examples:
|
|
- value: 47
|
|
description: Transcript has ~47 sentences
|
|
specificity_annotation:
|
|
range: SpecificityAnnotation
|
|
inlined: true
|
|
template_specificity:
|
|
range: TemplateSpecificityScores
|
|
inlined: true
|
|
comments:
|
|
- Full text transcription of video audio content
|
|
- Extends VideoTextContent with transcript-specific properties
|
|
- Base class for VideoSubtitle (subtitles are transcripts + time codes)
|
|
- Supports both plain text and structured segment-based transcripts
|
|
- Critical for accessibility, discovery, and preservation
|
|
see_also:
|
|
- https://schema.org/transcript
|
|
- http://www.cidoc-crm.org/cidoc-crm/E33_Linguistic_Object
|
|
enums:
|
|
TranscriptFormatEnum:
|
|
description: 'Format/structure of transcript text content.
|
|
|
|
|
|
Indicates how the full_text is organized.
|
|
|
|
'
|
|
permissible_values:
|
|
PLAIN_TEXT:
|
|
description: 'Continuous text without structural markers.
|
|
|
|
No speaker labels, no timestamps, no paragraph breaks.
|
|
|
|
Suitable for simple full-text search indexing.
|
|
|
|
'
|
|
PARAGRAPHED:
|
|
description: 'Text broken into paragraphs.
|
|
|
|
May be based on topic changes, speaker pauses, or semantic units.
|
|
|
|
Improves human readability.
|
|
|
|
'
|
|
STRUCTURED:
|
|
description: 'Text with speaker labels and/or section markers.
|
|
|
|
Format: "[Speaker] Text content" or similar.
|
|
|
|
Enables speaker-specific analysis.
|
|
|
|
'
|
|
TIMESTAMPED:
|
|
description: 'Text with inline time markers.
|
|
|
|
Format: "[00:30] Text content" or similar.
|
|
|
|
Enables temporal navigation in text view.
|
|
|
|
'
|
|
VERBATIM:
|
|
description: 'Exact transcription including fillers, false starts, overlaps.
|
|
|
|
"[um]", "[pause]", "[crosstalk]" markers.
|
|
|
|
Used for linguistic analysis or legal transcripts.
|
|
|
|
'
|
|
CLEAN:
|
|
description: 'Edited for readability - fillers removed, grammar corrected.
|
|
|
|
May diverge slightly from literal spoken content.
|
|
|
|
Suitable for publication or accessibility.
|
|
|
|
'
|