glam/schemas/20251121/linkml/modules/classes/CollectionDiscoveryScore.yaml
2026-01-31 00:15:53 +01:00

74 lines
2.6 KiB
YAML

id: https://nde.nl/ontology/hc/class/CollectionDiscoveryScore
name: collection_discovery_score_class
title: Collection Discovery Score Class
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/specificity_annotation
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
default_range: string
classes:
CollectionDiscoveryScore:
class_uri: sosa:Observation
description: 'Structured score for collection discovery/exploration relevance.
Captures the computed relevance score from search/retrieval algorithms acting as observation systems, along with metadata about when and how the score was computed.
**Use cases**: - RAG retrieval relevance scores for collection metadata - Search result ranking scores - Collection exploration priority scores - Template-specific relevance for different query contexts
**Score semantics**: - 0.0 = Not relevant to query/context - 0.5 = Moderately relevant - 1.0 = Highly relevant'
exact_mappings:
- sosa:Observation
close_mappings:
- prov:Entity
- schema:Rating
slots:
- has_or_had_score
- specificity_annotation
attributes:
score_context:
range: string
description: Context or query type for which this score was computed. E.g., "collection_discovery", "archive_search", "museum_search"
computed_at:
range: datetime
description: When the score was computed.
algorithm_version:
range: string
description: Version of the scoring algorithm used. Enables reproducibility and score comparison across versions.
score_notes:
range: string
description: Additional notes about the score computation.
comments:
- Created per slot_fixes.yaml revision for collection_discovery_score migration
- Replaces primitive float with structured observation
- "RULE 53: Part of collection_discovery_score \u2192 has_or_had_score + CollectionDiscoveryScore migration"
annotations:
specificity_score: 0.75
specificity_rationale: Fairly specific - applies to collection search/discovery contexts
custodian_types: "['*']"
examples:
- value: 'has_or_had_score: 0.85
score_context: "collection_discovery"
computed_at: "2026-01-19T12:00:00Z"
algorithm_version: "v1.2.0"
'
- value: 'has_or_had_score: 0.92
score_context: "archive_search"
computed_at: "2026-01-19T14:30:00Z"
'