id: https://nde.nl/ontology/hc/class/AutoGeneration
name: auto_generation_class
title: AutoGeneration Class
imports:
  - linkml:types
  - ../slots/has_description
  - ../slots/has_label
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  dcterms: http://purl.org/dc/terms/
default_prefix: hc
classes:
  AutoGeneration:
    class_uri: prov:Activity
    description: 'Represents automatic generation or creation of content by a system or algorithm.

      **DEFINITION**:

      AutoGeneration models the automatic creation of content such as subtitles, chapters, transcripts, or metadata by AI/ML systems, platform algorithms, or automated processes. This replaces simple boolean flags like `auto_generated` with a structured class that can capture the generation method and provenance.

      **ONTOLOGY ALIGNMENT**:

      - PROV-O: `prov:Activity` - an activity that generates entities - PROV-O: `prov:wasGeneratedBy` - links to generating activity - Schema.org: `schema:CreateAction` - creation action

      **GENERATION METHODS**:

      - ASR (Automatic Speech Recognition): Speech-to-text for subtitles - Scene Detection: AI-based video chapter generation - NLP: Natural language processing for metadata extraction - OCR: Optical character recognition for text extraction

      **USE CASES**:

      1. **Auto-Subtitles**: YouTube auto-generated captions 2. **Auto-Chapters**: AI-detected video chapters 3. **Auto-Transcripts**: ASR-generated transcripts 4. **Auto-Metadata**: ML-extracted metadata'
    exact_mappings:
    - prov:Activity
    close_mappings:
    - schema:CreateAction
    related_mappings:
    - prov:wasGeneratedBy
    slots:
    - has_label
    - has_description
    slot_usage:
      has_label:
#         range: string
        examples:
        - value: YouTube Auto-Caption
        - value: ASR Transcription
      has_description:
#         range: string
        examples:
        - value: Automatically generated by YouTube's speech recognition system
        - value: Generated using Whisper ASR model
    comments:
    - Generic auto-generation class replacing domain-specific boolean flags
    - Captures generation method and provenance
    - Aligns with PROV-O Activity for provenance tracking
    see_also:
    - https://www.w3.org/TR/prov-o/#Activity
    - https://schema.org/CreateAction
    examples:
    - value:
        has_label: YouTube Auto-Caption
        has_description: Automatically generated by YouTube's speech recognition
    annotations:
      specificity_score: 0.1
      specificity_rationale: Generic utility class/slot created during migration
      custodian_types: "['*']"