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_description
  - ../slots/has_label
  - ../slots/has_level
  - ../slots/has_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\" approximate:\n  has_level: APPROXIMATE  # was: approximation_level\n  has_label: \"circa 1880\"\n  has_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_level
    - has_label
    - has_description
    - has_score
    slot_usage:
      has_level:
#         range: string
        required: true
      has_label:
#         range: string
        required: false
        examples:
        - value: circa 1880
        - value: approximately 10,000
      has_description:
#         range: string
        required: false
        examples:
        - value: Founding date derived from secondary sources, exact day unknown
    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 approximate slot
    see_also:
    - https://www.cidoc-crm.org/Entity/e52-time-span/version-7.1.3
    examples:
    - value:
        has_level: EXACT
        has_label: '1880-03-15'
    - value:
        has_level: APPROXIMATE
        has_label: circa 1880
        has_description: Founding date known only to year from newspaper accounts
    - value:
        has_level: ESTIMATED
        has_label: estimated 1875-1885
        has_description: Date range inferred from building construction records
    - value:
        has_level: UNKNOWN
        has_label: date unknown
        has_description: No founding records survive
    annotations:
      specificity_score: 0.3
      specificity_rationale: Approximation status is broadly useful across contexts where uncertainty needs to be expressed.
      custodian_types: "['*']"
enums:
  ApproximationLevelEnum:
    description: Levels of approximation/uncertainty for values.
    permissible_values:
      EXACT:
      APPROXIMATE:
      ESTIMATED:
      UNCERTAIN:
      UNKNOWN: