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

86 lines
2.9 KiB
YAML

id: https://nde.nl/ontology/hc/class/CollectionDiscoveryScore
name: collection_discovery_score_class
title: Collection Discovery Score Class
# Created per slot_fixes.yaml revision for collection_discovery_score migration
# RULE 53: Structured score class replacing primitive float
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 → has_or_had_score + CollectionDiscoveryScore migration"
annotations:
specificity_score: 0.75
specificity_rationale: "Fairly specific - applies to collection search/discovery contexts"
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"