glam/schemas/20251121/linkml/modules/classes/DetectionThreshold.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

80 lines
3.4 KiB
YAML

id: https://nde.nl/ontology/hc/class/DetectionThreshold
name: DetectionThreshold
title: Detection Threshold Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
dqv: http://www.w3.org/ns/dqv#
schema: http://schema.org/
prov: http://www.w3.org/ns/prov#
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#
default_prefix: hc
imports:
- linkml:types
- ../metadata
- ../slots/has_or_had_description
- ../slots/has_or_had_label
- ../slots/has_or_had_type
classes:
DetectionThreshold:
class_uri: dqv:QualityMeasurement
description: "Configuration for detection thresholds in analysis pipelines.\n\n\
**DEFINITION**:\n\nDetectionThreshold represents the confidence threshold settings\
\ used to filter\ndetection results. CV models output confidence scores; thresholds\
\ determine\nwhich detections are included in results.\n\n**Threshold Levels**:\n\
\n| Threshold | Range | Use Case |\n|-----------|-------|----------|\n| HIGH_PRECISION\
\ | 0.9+ | Production display, high confidence |\n| BALANCED | 0.7-0.9 | General\
\ use, balance precision/recall |\n| HIGH_RECALL | 0.5-0.7 | Research, review,\
\ catch more |\n| RAW | < 0.5 | Unfiltered, needs post-processing |\n\n**Ontological\
\ Alignment**:\n- **DQV**: `dqv:QualityMeasurement` - quality metric for data\
\ assessment\n- **PROV-O**: Threshold as parameter of detection activity\n\n\
**Migrated From** (per slot_fixes.yaml):\n- `detection_threshold` (float) now\
\ uses:\n - `filters_or_filtered` → DetectedEntity\n - `has_or_had_treshold`\
\ → DetectionThreshold (this class)\n\n**Usage Pattern**:\n```\nVideoAnnotation\n\
\ └── filters_or_filtered → DetectedEntity\n └── has_or_had_treshold\
\ → DetectionThreshold\n ├── threshold_value: 0.5\n \
\ └── threshold_type: MINIMUM\n```\n"
exact_mappings:
- dqv:QualityMeasurement
close_mappings:
- schema:QuantitativeValue
related_mappings:
- prov:SoftwareAgent
slots:
- has_or_had_label
- has_or_had_description
- has_or_had_type
slot_usage:
has_or_had_label:
examples:
- value: High Precision Threshold
- value: Research Mode Threshold
has_or_had_type:
examples:
- value: HIGH_PRECISION
- value: BALANCED
annotations:
custodian_types: '["D"]'
custodian_types_rationale: Detection thresholds apply to digital platforms with
automated analysis
specificity_score: 0.75
specificity_rationale: Fairly specific to video/media analysis contexts
comments:
- Represents detection threshold configuration
- Migrated from detection_threshold slot per slot_fixes.yaml
- threshold_value is the numeric confidence cutoff
- threshold_type indicates how threshold is applied
examples:
- value:
has_or_had_label: Standard Detection
- value:
has_or_had_label: High Precision
has_or_had_description: For production display requiring high confidence
- value:
has_or_had_label: Research Mode
has_or_had_description: Low threshold to maximize recall for research