glam/schemas/20251121/linkml/modules/classes/DetectionThreshold.yaml
kempersc 776462de90 Migrate multiple slots to enhance semantic clarity and align with best practices
- Migrated catering_type to CateringType with subclasses for better classification.
- Updated certainty_level to has_or_had_level for improved metadata consistency.
- Addressed cessation_observed_in by confirming existing temporal data structure.
- Created NetAsset class and updated financial statements for richer financial modeling.
- Completed migrations for default_access_policy, default_audio_language, and default_language to structured classes.
- Migrated default_position to structured Alignment class for better representation.
- Updated defined_by_standard to broaden range for identifier standards.
- Migrated definition to structured Resolution class for video resolution modeling.
- Completed migrations for degree_name, deliverable, and departement_code to structured classes.
- Migrated deployment_date to structured DeploymentEvent with temporal extent.
- Migrated derived_from_entity and derived_from_observation to new reference structures.
- Completed description and description_text migrations to enhance content modeling.
- Migrated detection_count, detection_level, and detection_threshold to structured slots with classes.
- Migrated device-related slots to structured classes for better identification and classification.
- Added new slots and classes for historic building and web address modeling.
2026-01-25 12:47:38 +01:00

149 lines
5 KiB
YAML

# DetectionThreshold class
# Represents threshold configuration for detection/filtering in analysis pipelines
#
# Created: 2026-01-25
# Rule compliance: 0b (Type/Types pattern), 38 (slot centralization), 39 (RiC-O naming), 53 (slot_fixes.yaml)
# Migration: detection_threshold → filters_or_filtered + has_or_had_treshold + DetectionThreshold
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#
default_prefix: hc
imports:
- linkml:types
- ../metadata
- ../slots/has_or_had_label
- ../slots/has_or_had_description
- ../slots/has_or_had_type
classes:
DetectionThreshold:
class_uri: dqv:QualityMeasurement
description: |
Configuration for detection thresholds in analysis pipelines.
**DEFINITION**:
DetectionThreshold represents the confidence threshold settings used to filter
detection results. CV models output confidence scores; thresholds determine
which detections are included in results.
**Threshold Levels**:
| Threshold | Range | Use Case |
|-----------|-------|----------|
| HIGH_PRECISION | 0.9+ | Production display, high confidence |
| BALANCED | 0.7-0.9 | General use, balance precision/recall |
| HIGH_RECALL | 0.5-0.7 | Research, review, catch more |
| RAW | < 0.5 | Unfiltered, needs post-processing |
**Ontological Alignment**:
- **DQV**: `dqv:QualityMeasurement` - quality metric for data assessment
- **PROV-O**: Threshold as parameter of detection activity
**Migrated From** (per slot_fixes.yaml):
- `detection_threshold` (float) now uses:
- `filters_or_filtered` → DetectedEntity
- `has_or_had_treshold` → DetectionThreshold (this class)
**Usage Pattern**:
```
VideoAnnotation
└── filters_or_filtered → DetectedEntity
└── has_or_had_treshold → DetectionThreshold
├── threshold_value: 0.5
└── threshold_type: MINIMUM
```
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
attributes:
threshold_value:
range: float
required: true
minimum_value: 0.0
maximum_value: 1.0
description: |
The numeric threshold value (0.0-1.0).
Detections with confidence >= threshold_value are included.
examples:
- value: 0.5
description: Standard threshold
- value: 0.9
description: High precision threshold
threshold_type:
range: string
required: false
description: |
Type of threshold application.
- MINIMUM: Lower bound for inclusion
- MAXIMUM: Upper bound (rare)
- BAND: Range between two values
examples:
- value: MINIMUM
description: Minimum confidence for inclusion
slot_usage:
has_or_had_label:
description: Human-readable label for this threshold configuration
examples:
- value: "High Precision Threshold"
- value: "Research Mode Threshold"
has_or_had_type:
description: Type category for the threshold (HIGH_PRECISION, BALANCED, etc.)
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:
threshold_value: 0.5
threshold_type: MINIMUM
has_or_had_label: "Standard Detection"
description: "Standard detection threshold at 0.5 confidence"
- value:
threshold_value: 0.9
threshold_type: MINIMUM
has_or_had_label: "High Precision"
has_or_had_description: "For production display requiring high confidence"
description: "High precision threshold for production use"
- value:
threshold_value: 0.3
threshold_type: MINIMUM
has_or_had_label: "Research Mode"
has_or_had_description: "Low threshold to maximize recall for research"
description: "Low threshold for research/review workflows"