id: https://nde.nl/ontology/hc/class/ApproximationStatus
name: approximation_status_class
title: Approximation Status 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#
default_prefix: hc
imports:
  - linkml:types
  - ../metadata
  - ../slots/has_description
  - ../slots/has_label
  - ../slots/has_level
  - ../slots/has_score
classes:
  ApproximationStatus:
    class_uri: hc:ApproximationStatus
    description: >-
      Indicator expressing the degree of precision or certainty for a value
      such as dates, quantities, or measurements, replacing simple boolean
      flags with structured uncertainty information.
    alt_descriptions:
      nl: >-
        Indicator die de mate van precisie of zekerheid voor een waarde uitdrukt,
        zoals datums, hoeveelheden of metingen, ter vervanging van eenvoudige
        booleaanse vlaggen door gestructureerde onzekerheidsinformatie.
      de: >-
        Indikator, der den Genauigkeits- oder Gewissheitsgrad fur einen Wert
        wie Datum, Mengen oder Messungen ausdruckt und einfache boolesche
        Flags durch strukturierte Unsicherheitsinformationen ersetzt.
      fr: >-
        Indicateur exprimant le degre de precision ou de certitude d'une valeur
        telle que des dates, quantites ou mesures, remplaçant les simples
        indicateurs booleens par des informations d'incertitude structurees.
      es: >-
        Indicador que expresa el grado de precision o certeza de un valor
        como fechas, cantidades o mediciones, reemplazando simples indicadores
        booleanos con informacion de incertidumbre estructurada.
      ar: >-
        مؤشر يعبر عن درجة الدقة أو اليقين لقيمة مثل التواريخ أو الكميات
        أو القياسات، ليحل محل العلامات المنطقية البسيطة بمعلومات عدم
        اليقين المنظمة.
      id: >-
        Indikator yang menyatakan tingkat presisi atau kepastian untuk nilai
        seperti tanggal, kuantitas, atau pengukuran, mengganti bendera boolean
        sederhana dengan informasi ketidakpastian yang terstruktur.
      zh: >-
        表示日期、数量或测量等值的精度或确定性程度的指标，用结构化的不确定性
        信息替代简单的布尔标志。
    structured_aliases:
    - literal_form: benaderingsstatus
      in_language: nl
    - literal_form: Approximationsstatus
      in_language: de
    - literal_form: statut d'approximation
      in_language: fr
    - literal_form: estado de aproximacion
      in_language: es
    - literal_form: حالة التقريب
      in_language: ar
    - literal_form: status aproksimasi
      in_language: id
    - literal_form: 近似状态
      in_language: zh
    close_mappings:
    - crm:E52_Time-Span
    - rico:DateType
    related_mappings:
    - skos:note
    broad_mappings:
    - skos:Concept
    slots:
    - has_level
    - has_label
    - has_description
    - has_score
    slot_usage:
      has_level:
        required: true
      has_label:
        required: false
        examples:
        - value: circa 1880
        - value: approximately 10,000
      has_description:
        required: false
        examples:
        - value: Founding date derived from secondary sources, exact day unknown
    comments:
    - Replaces simple boolean approximate field with structured uncertainty modeling
    - Supports EXACT, APPROXIMATE, ESTIMATED, UNCERTAIN, and UNKNOWN levels
    - Used by approximate slot for dates, quantities, and measurements
    - Complements CIDOC-CRM E52_Time-Span fuzzy boundary concepts
    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"
        has_score: 1.0
      description: Exact date known with certainty
    - value:
        has_level: APPROXIMATE
        has_label: circa 1880
        has_description: Founding date known only to year from newspaper accounts
        has_score: 0.7
      description: Approximate date (circa)
    - value:
        has_level: ESTIMATED
        has_label: estimated 1875-1885
        has_description: Date range inferred from building construction records
        has_score: 0.5
      description: Estimated date range
    - value:
        has_level: UNKNOWN
        has_label: date unknown
        has_description: No founding records survive
        has_score: 0.0
      description: Unknown date
    keywords:
    - approximation
    - uncertainty
    - precision
    - certainty
    - circa
    - estimated
    - exact
    - unknown
    notes:
      - |
        Preserved from prior description (commit 1fe1d1ad):

        "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**:\
    annotations:
      specificity_score: "0.4"
      specificity_rationale: Broadly useful across contexts where uncertainty needs expression
      custodian_types: "['*']"
enums:
  ApproximationLevelEnum:
    description: Levels of approximation/uncertainty for values.
    permissible_values:
      EXACT:
        description: Known with certainty
      APPROXIMATE:
        description: Close but not exact
      ESTIMATED:
        description: Calculated or inferred
      UNCERTAIN:
        description: Significant doubt exists
      UNKNOWN:
        description: Cannot be determined