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

107 lines
5.1 KiB
YAML

id: https://nde.nl/ontology/hc/class/ApproximationStatus
name: approximation_status_class
title: ApproximationStatus Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
crm: http://www.cidoc-crm.org/cidoc-crm/
rico: https://www.ica.org/standards/RiC/ontology#
skos: http://www.w3.org/2004/02/skos/core#
imports:
- linkml:types
- ../metadata
- ../slots/has_or_had_level
- ../slots/has_or_had_label
- ../slots/has_or_had_description
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ../slots/specificity_annotation
- ../slots/has_or_had_score
default_prefix: hc
classes:
ApproximationStatus:
class_uri: hc:ApproximationStatus
description: "Status indicating the level of approximation or uncertainty for a value.\n**PURPOSE**:\nApproximationStatus captures structured uncertainty information for values like dates, quantities, and measurements where precision varies. This replaces simple boolean \"approximate: true/false\" with richer modeling.\n**UNCERTAINTY LEVELS**:\n| Level | Label | Description | Example | |-------|-------|-------------|---------| | EXACT | Exact | Known with certainty | \"1880-03-15\" | | APPROXIMATE | Approximate | Close but not exact | \"circa 1880\" | | ESTIMATED | Estimated | Calculated/inferred | \"estimated 1875-1885\" | | UNCERTAIN | Uncertain | Significant doubt | \"possibly 19th century\" | | UNKNOWN | Unknown | Cannot be determined | \"date unknown\" |\n**CIDOC-CRM ALIGNMENT**:\nCIDOC-CRM models time-span precision through E52_Time-Span with fuzzy boundaries. ApproximationStatus provides a complementary vocabulary for expressing certainty levels.\n**USE CASES**:\n1. **Date Uncertainty**:\
\ Founding dates known only to decade 2. **Quantity Estimates**: Collection size approximations 3. **Location Precision**: Address known only to city level 4. **Historical Events**: Uncertain timing of organizational changes\n**EXAMPLE**:\n```yaml event_date: \"1880\" is_or_was_approximate:\n has_or_had_level: APPROXIMATE # was: approximation_level\n has_or_had_label: \"circa 1880\"\n has_or_had_description: \"Founding date known only to year from secondary sources\"\n```"
exact_mappings:
- crm:E52_Time-Span
close_mappings:
- rico:DateType
related_mappings:
- skos:note
slots:
- has_or_had_level
- has_or_had_label
- has_or_had_description
- specificity_annotation
- has_or_had_score
slot_usage:
has_or_had_level:
range: ApproximationLevelEnum
required: true
description: Level of approximation/uncertainty for the value.
has_or_had_label:
range: string
required: false
description: Human-readable label for the approximation status.
examples:
- value: circa 1880
description: Approximate date label
- value: approximately 10,000
description: Approximate quantity label
has_or_had_description:
range: string
required: false
description: Explanation of why the value is approximate and how uncertainty was determined.
examples:
- value: Founding date derived from secondary sources, exact day unknown
description: Provenance of uncertainty
comments:
- ApproximationStatus replaces simple boolean approximate field
- Provides structured uncertainty modeling for dates, quantities, etc.
- Aligned with CIDOC-CRM E52_Time-Span precision concepts
- Used by is_or_was_approximate slot
see_also:
- https://www.cidoc-crm.org/Entity/e52-time-span/version-7.1.3
examples:
- value:
has_or_had_level: EXACT
has_or_had_label: '1880-03-15'
description: Exact date with full precision
- value:
has_or_had_level: APPROXIMATE
has_or_had_label: circa 1880
has_or_had_description: Founding date known only to year from newspaper accounts
description: Approximate date with explanation
- value:
has_or_had_level: ESTIMATED
has_or_had_label: estimated 1875-1885
has_or_had_description: Date range inferred from building construction records
description: Estimated date range
- value:
has_or_had_level: UNKNOWN
has_or_had_label: date unknown
has_or_had_description: No founding records survive
description: Unknown date
annotations:
specificity_score: 0.3
specificity_rationale: Approximation status is broadly useful across contexts where uncertainty needs to be expressed.
custodian_types: "['*']"
custodian_types_rationale: Universal utility concept
enums:
ApproximationLevelEnum:
description: Levels of approximation/uncertainty for values.
permissible_values:
EXACT:
description: Value is known with certainty
APPROXIMATE:
description: Value is close but not exact (circa, roughly)
ESTIMATED:
description: Value is calculated or inferred
UNCERTAIN:
description: Significant doubt about accuracy
UNKNOWN:
description: Value cannot be determined