glam/schemas/20251121/linkml/modules/classes/Methodology.yaml

id: https://nde.nl/ontology/hc/class/Methodology
name: Methodology
title: Methodology
description: Structured description of the procedure used to derive measurements or analytical outcomes.
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  prov: http://www.w3.org/ns/prov#
  schema: http://schema.org/
  dcterms: http://purl.org/dc/terms/
  crm: http://www.cidoc-crm.org/cidoc-crm/
  skos: http://www.w3.org/2004/02/skos/core#
  rdfs: http://www.w3.org/2000/01/rdf-schema#
  org: http://www.w3.org/ns/org#
  xsd: http://www.w3.org/2001/XMLSchema#
imports:
  - linkml:types
  - ../enums/MethodologyTypeEnum
  - ../slots/has_description
  - ../slots/identified_by
  - ../slots/has_label
  - ../slots/has_score
  - ../slots/has_threshold
  - ../slots/has_version
  - ../slots/has_type
default_prefix: hc
classes:
  Methodology:
    class_uri: prov:Plan
    description: >-
      Structured plan describing the technique, algorithm, or procedural
      approach used to derive a measurement or analytical result.      
    alt_descriptions:
      nl: {text: Gestructureerd plan dat de techniek, het algoritme of de procedurele aanpak beschrijft waarmee een meting of analytisch resultaat is afgeleid., language: nl}
      de: {text: Strukturierter Plan, der Technik, Algorithmus oder Verfahrensansatz zur Ableitung eines Mess- oder Analyseergebnisses beschreibt., language: de}
      fr: {text: Plan structure decrivant la technique, l algorithme ou l approche procedurale utilises pour deriver une mesure ou un resultat analytique., language: fr}
      es: {text: Plan estructurado que describe la tecnica, algoritmo o enfoque procedural usado para derivar una medicion o resultado analitico., language: es}
      ar: {text: خطة منظمة تصف التقنية أو الخوارزمية أو النهج الإجرائي المستخدم لاشتقاق قياس أو نتيجة تحليلية., language: ar}
      id: {text: Rencana terstruktur yang menjelaskan teknik, algoritme, atau pendekatan prosedural yang digunakan untuk menurunkan pengukuran atau hasil analitis., language: id}
      zh: {text: 用于说明推导测量或分析结果所采用技术、算法或程序方法的结构化方案。, language: zh}
    structured_aliases:
      nl: [{literal_form: afleidingsmethodologie, language: nl}]
      de: [{literal_form: Ableitungsmethodik, language: de}]
      fr: [{literal_form: methodologie de derivation, language: fr}]
      es: [{literal_form: metodologia de derivacion, language: es}]
      ar: [{literal_form: منهجية اشتقاق, language: ar}]
      id: [{literal_form: metodologi penurunan, language: id}]
      zh: [{literal_form: 推导方法学方案, language: zh}]
    exact_mappings:
    - prov:Plan
    close_mappings:
    - schema:HowToStep
    related_mappings:
    - dcterms:methodology
    slots:
    - identified_by
    - has_type
    - has_label
    - has_description
    - has_version
    - has_threshold
    - has_score
    slot_usage:
      identified_by:
#         range: string # uriorcurie
        required: false
        examples:
        - value: https://nde.nl/ontology/hc/methodology/retinaface-arcface-v1
      has_type:
        range: MethodologyTypeEnum
        required: false
        examples:
        - value: ENTITY_RESOLUTION
        - value: OBJECT_TRACKING
      has_label:
#         range: string
        required: false
        description: 'Human-readable name for the methodology or algorithm. MIGRATED: Now serves both methodology name AND algorithm_name (Rule 53/56).'
        examples:
        - value: RetinaFace + ArcFace clustering
        - value: YOLOv8
        - value: ArcFace
      has_description:
#         range: string
        required: false
        examples:
        - value: Faces detected using RetinaFace, clustered using ArcFace embeddings
      has_version:
#         range: string
        required: false
        examples:
        - value: 1.0.0
        - value: v8n
      has_threshold:
        range: ConfidenceThreshold
        required: false
        examples:
        - value:
    comments:
      - |
        Preserved from prior description (commit 6e634651):

        "Describes the methodology, technique, or algorithm used to derive a measurement.\n**PROV-O ALIGNMENT**:\nMaps to `prov:Plan` which represents \"a set of actions or steps intended by one or more agents to achieve some goals.\" In measurement contexts, this describes HOW a value was computed or derived.\n**WHY METHODOLOGY MATTERS**:\nTwo measurements of \"unique objects\" could use different methodologies:\n| Methodology | Description | Accuracy | |-------------|-------------|----------| | ENTITY_RESOLUTION | Deduplication via feature matching | High | | TRACKING | Object tracking across frames | Medium | | MANUAL_COUNT | Human counting | Variable | | SAMPLING | Statistical sampling | Estimated |\nWithout methodology, two measurements cannot be meaningfully compared.\n**HERITAGE USE CASES**:\n- **Video annotation**: How unique faces/objects were counted (entity resolution) - **Collection inventories**: How item counts were derived (physical vs. digital) - **Visitor statistics**:\        
    - Describes HOW a measurement was derived
    - Essential for comparing measurements from different sources
    - Maps to PROV-O Plan for provenance tracking
    - Rule 53 compliant - supports unique_object_count/unique_face_count migration
    see_also:
    - https://www.w3.org/TR/prov-o/#Plan
    examples:
    - value:
        methodology_type: ENTITY_RESOLUTION
        has_label: RetinaFace + ArcFace clustering
        has_description: Faces detected using RetinaFace model, then clustered using ArcFace embeddings with cosine similarity threshold 0.6.
        has_version: '1.0'
        has_threshold:
        - threshold_value: 0.6
    - value:
        methodology_type: OBJECT_TRACKING
        has_label: DeepSORT multi-object tracking
        has_description: Objects tracked across video frames using DeepSORT algorithm with Kalman filtering and appearance features.
        has_version: '1.0'
    annotations:
      specificity_score: 0.1
      specificity_rationale: Generic utility class/slot created during migration
      custodian_types: "['*']"