glam/schemas/20251121/linkml/modules/classes/Video.yaml
kempersc fc405445c6 Refactor and update schema definitions
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`.
- Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples.
- Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`.
- Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files.
- Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
2026-02-01 19:55:38 +01:00

118 lines
No EOL
3 KiB
YAML

id: https://nde.nl/ontology/hc/class/Video
name: Video
title: Video Media Resource
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
ma: http://www.w3.org/ns/ma-ont#
dcterms: http://purl.org/dc/terms/
imports:
- linkml:types
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_url
default_prefix: hc
classes:
Video:
class_uri: schema:VideoObject
description: 'Video media resource.
**DEFINITION**:
Represents a video file or stream that can be referenced as source
material for thumbnails, clips, chapters, and annotations. This class
enables structured representation of video resources with their
identifiers and URLs.
**HERITAGE INSTITUTION USE CASES**:
| Content Type | Examples |
|--------------|----------|
| Virtual tours | Museum walkthrough videos |
| Conservation | Restoration process documentation |
| Interviews | Oral history recordings |
| Lectures | Educational content, curator talks |
| Exhibitions | Exhibition documentation videos |
**PLATFORM SUPPORT**:
| Platform | Identifier | URL Pattern |
|----------|------------|-------------|
| YouTube | Video ID (11 chars) | youtube.com/watch?v={id} |
| Vimeo | Video ID (numeric) | vimeo.com/{id} |
| Wistia | Hashed ID | wistia.com/medias/{id} |
| Self-hosted | Custom | Institution-specific |
**RELATIONSHIP TO Thumbnail**:
Thumbnails are derived from Videos using the `derives_or_derived_from`
relationship, with the specific frame time captured via `has_or_had_time_interval`.
**ONTOLOGY ALIGNMENT**:
- **Primary**: `schema:VideoObject` (Schema.org)
- **Close**: `ma:MediaResource` (W3C Media Ontology)
'
slots:
- has_or_had_url
- has_or_had_identifier
- has_or_had_label
slot_usage:
has_or_had_url:
required: true
examples:
- value: https://www.youtube.com/watch?v=ABC123def45
- value: https://vimeo.com/123456789
has_or_had_identifier:
examples:
- value:
has_or_had_label:
range: string
inlined: true
exact_mappings:
- ma:MediaResource
close_mappings:
- dcterms:MovingImage
annotations:
specificity_score: '0.45'
specificity_rationale: Medium specificity - video resources are common across heritage platforms but more specialized than generic media.
migration_date: '2026-01-19'
migration_rule: Rule 53 (no bespoke slots), Rule 56 (semantic consistency)
custodian_types: "['*']"
examples:
- value:
has_or_had_url: https://www.youtube.com/watch?v=dQw4w9WgXcQ
has_or_had_identifier:
has_or_had_label:
has_or_had_label: Rijksmuseum Virtual Tour 2024
language: en
- value:
has_or_had_url: https://vimeo.com/987654321
has_or_had_label:
has_or_had_label: Conservation of The Night Watch
language: en