glam/frontend/public/schemas/20251121/linkml/modules/classes/AudioEventSegment.yaml
kempersc 2d09776856 Refactor StorageCondition schema: Migrate compliance_status to has_or_had_status with ComplianceStatus class
- Removed compliance_status slot and replaced it with has_or_had_status.
- Updated has_or_had_status to use ComplianceStatus for structured representation.
- Adjusted examples to reflect new structure for compliance status.
- Updated documentation to indicate migration and provide details on the ComplianceStatus class.
2026-01-22 16:22:16 +01:00

182 lines
6.6 KiB
YAML

id: https://nde.nl/ontology/hc/class/AudioEventSegment
name: audio_event_segment_class
title: Audio Event Segment Class
description: |
A temporal segment of audio containing a detected audio event (speech, music, silence, etc.).
MIGRATED from audio_event_segments slot (Rule 53).
Uses generic has_or_had_segment slot with range narrowed to AudioEventSegment.
imports:
- linkml:types
- ../slots/start_seconds
- ../slots/end_seconds
- ../slots/start_time
- ../slots/end_time
- ../slots/segment_index
- ../slots/segment_text
# MIGRATED 2026-01-19: confidence → is_or_was_generated_by + GenerationEvent + ConfidenceScore
- ../slots/is_or_was_generated_by
- ./GenerationEvent
- ./ConfidenceScore
- ../slots/specificity_annotation
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ../enums/AudioEventTypeEnum
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#
default_prefix: hc
classes:
AudioEventSegment:
class_uri: hc:AudioEventSegment
description: |
A temporal segment of audio containing a detected audio event.
**DEFINITION**:
AudioEventSegment represents a bounded temporal portion of audio content
where a specific type of audio event has been detected. This includes:
- Speech segments (with optional speaker/language info)
- Music segments (with optional genre/type info)
- Silence segments (gaps between audio)
- Sound event segments (applause, laughter, ambient sounds)
- Noise segments (for quality assessment)
**RELATIONSHIP TO VideoTimeSegment**:
AudioEventSegment is a specialized sibling of VideoTimeSegment:
- Both extend CIDOC-CRM E52_Time-Span concept
- VideoTimeSegment: general video temporal segments
- AudioEventSegment: audio-specific event segments
**AUDIO EVENT TYPES**:
| Event Type | Description | Example |
|------------|-------------|---------|
| SPEECH | Human speech detected | Interview segment |
| MUSIC | Music detected | Background soundtrack |
| SILENCE | Very low or no audio | Gap between segments |
| SOUND_EVENT | Non-speech/music sounds | Applause, footsteps |
| NOISE | Noise/interference | Quality issue marker |
| MIXED | Multiple event types | Overlapping audio |
**HERITAGE USE CASES**:
| Content Type | Application |
|--------------|-------------|
| Oral histories | Speech segment identification |
| Virtual tours | Background music detection |
| Lecture recordings | Audience reaction segments |
| Conservation videos | Narration vs ambient sound |
| Archival footage | Audio quality assessment |
**PROVENANCE**:
Created as part of slot migration (Rule 53) from deprecated
`audio_event_segments` slot to generic `has_or_had_segment` pattern.
exact_mappings:
- hc:AudioEventSegment
close_mappings:
- crm:E52_Time-Span
- ma:MediaFragment
related_mappings:
- oa:FragmentSelector
slots:
- start_seconds
- end_seconds
- start_time
- end_time
- segment_index
- segment_text
# MIGRATED 2026-01-19: confidence → is_or_was_generated_by (structured ConfidenceScore)
- is_or_was_generated_by
- specificity_annotation
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
attributes:
audio_event_type:
range: AudioEventTypeEnum
required: true
description: The type of audio event detected in this segment.
examples:
- value: SPEECH
description: Speech detected in this segment
- value: MUSIC
description: Music detected in this segment
slot_usage:
start_seconds:
range: float
required: true
minimum_value: 0.0
description: Start time in seconds for this audio event segment.
examples:
- value: 0.0
description: Audio event starts at beginning
- value: 45.5
description: Audio event starts at 45.5 seconds
end_seconds:
range: float
required: true
minimum_value: 0.0
description: End time in seconds for this audio event segment.
examples:
- value: 15.0
description: Audio event ends at 15 seconds
- value: 60.0
description: Audio event ends at 1 minute
start_time:
range: string
required: false
pattern: "^PT(\\d+H)?(\\d+M)?(\\d+(\\.\\d+)?S)?$"
description: Start time in ISO 8601 duration format.
examples:
- value: PT0M30S
description: 30 seconds from start
end_time:
range: string
required: false
pattern: "^PT(\\d+H)?(\\d+M)?(\\d+(\\.\\d+)?S)?$"
description: End time in ISO 8601 duration format.
examples:
- value: PT0M45S
description: 45 seconds from start
segment_text:
range: string
required: false
description: Text content for this segment (e.g., speech transcript, music description).
examples:
- value: "Welcome to the Rijksmuseum"
description: Speech transcript text
- value: "Classical background music"
description: Music segment description
is_or_was_generated_by:
range: GenerationEvent
required: false
inlined: true
description: >-
Generation event containing confidence score for audio event detection.
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: "audio_classification"
description: High confidence audio event detection
comments:
- Audio event segment for speech, music, silence, sound event detection
- Temporal boundaries with start/end seconds (primary) and ISO 8601 (secondary)
- Confidence scoring for AI-generated detections
- Part of Rule 53 slot migration from audio_event_segments
see_also:
- https://www.w3.org/TR/media-frags/
- https://www.w3.org/ns/ma-ont