glam/schemas/20251121/linkml/modules/classes/ConfidenceScore.yaml
kempersc 1516d509cf Add metadata to LinkML class definitions and update prefixes
- Added `id`, `name`, `title`, and `description` fields to multiple LinkML class YAML files.
- Standardized prefixes across all class definitions.
- Introduced a new script `fix_linkml_metadata.py` to automate the addition of metadata to class files.
- Updated existing class files to ensure compliance with the new metadata structure.
2026-01-29 17:40:47 +01:00

136 lines
4.4 KiB
YAML

id: https://nde.nl/ontology/hc/class/ConfidenceScore
name: ConfidenceScore
title: Confidence Score
description: LinkML class definition for Confidence Score
prefixes:
linkml: https://w3id.org/linkml/
schema: http://schema.org/
skos: http://www.w3.org/2004/02/skos/core#
rico: https://www.ica.org/standards/RiC/ontology#
wd: http://www.wikidata.org/entity/
# ConfidenceScore - Confidence score class for quality/certainty measurements
#
# Created per slot_fixes.yaml migration for: confidence_score
# Revision: is_or_was_generated_by + GenerationEvent + has_or_had_score + ConfidenceScore
# Creation date: 2026-01-19
id: https://nde.nl/ontology/hc/class/ConfidenceScore
name: confidence_score_class
title: Confidence Score
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
sosa: http://www.w3.org/ns/sosa/
prov: http://www.w3.org/ns/prov#
schema: http://schema.org/
imports:
- linkml:types
- ../slots/has_or_had_score
- ../slots/has_or_had_method
- ../slots/has_or_had_description
default_prefix: hc
classes:
ConfidenceScore:
description: >-
A structured confidence score representing quality/certainty measurements.
**MIGRATION**:
Replaces simple `confidence_score` float slot with structured class:
- `has_or_had_score`: The numeric value (0.0-1.0)
- `has_or_had_method`: How confidence was calculated
- `has_or_had_description`: Explanation of confidence assessment
**USAGE**:
- Process quality assessment (methodology confidence)
- Match/similarity confidence (entity resolution)
- Extraction confidence (NLP/XPath extraction)
- Prediction confidence (ML model outputs)
**RANGE**: 0.0 (low confidence) to 1.0 (high confidence)
**ONTOLOGY MAPPING**:
- sosa:hasSimpleResult for the score value
- prov:value as close mapping
class_uri: sosa:Result
exact_mappings:
- sosa:Result
close_mappings:
- prov:Value
- schema:Rating
slots:
- has_or_had_score
- has_or_had_method
- has_or_had_description
slot_usage:
has_or_had_score:
range: float
minimum_value: 0.0
maximum_value: 1.0
required: true
description: >-
The confidence score value, ranging from 0.0 (no confidence) to 1.0 (complete confidence).
examples:
- value: 0.95
description: High confidence (95%)
- value: 0.50
description: Moderate confidence (50%)
- value: 0.10
description: Low confidence (10%)
has_or_had_method:
range: string
required: false
description: >-
Method or algorithm used to calculate the confidence score.
examples:
- value: "fuzzy_string_matching"
description: String similarity method
- value: "xpath_extraction_validation"
description: XPath match validation
- value: "llm_classification"
description: LLM-based classification
has_or_had_description:
range: string
required: false
description: >-
Human-readable explanation of the confidence assessment.
examples:
- value: "High confidence - exact name match with verified ISIL code"
description: Explanation for high score
annotations:
custodian_types: '["*"]'
custodian_types_rationale: >-
Confidence scoring applies universally across all data extraction contexts.
custodian_types_primary: "*"
specificity_score: 0.20
specificity_rationale: >-
Low specificity - fundamental measurement concept for data quality.
examples:
- value:
has_or_had_score: 0.95
has_or_had_method: "xpath_extraction"
has_or_had_description: "Exact match found at expected XPath location"
description: High confidence XPath extraction
- value:
has_or_had_score: 0.65
has_or_had_method: "fuzzy_string_matching"
has_or_had_description: "Moderate similarity to reference name (Levenshtein ratio 0.85)"
description: Moderate confidence entity resolution
comments:
- Created from slot_fixes.yaml migration (2026-01-19)
- Replaces simple confidence_score float slot
- Used with is_or_was_generated_by slot for provenance