id: https://nde.nl/ontology/hc/class/CertaintyLevel
name: certainty_level_class
title: Certainty Level Class

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  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#
  prov: http://www.w3.org/ns/prov#

default_prefix: hc

imports:
  - linkml:types
  - ../metadata
  - ../slots/has_note
  - ../slots/has_score
  - ../slots/has_level
classes:
  CertaintyLevel:
    class_uri: rico:ConfidenceLevel
    description: |
      A structured representation of certainty/confidence level with explanatory notes.
      
      **Purpose**:
      CertaintyLevel encapsulates both the level of certainty (CERTAIN, PROBABLE,
      POSSIBLE, UNCERTAIN) and any notes explaining the certainty assessment.
      Used primarily in provenance research to document confidence in ownership
      transfer claims.
      
      **Ontological Alignment**:
      - **Primary**: `rico:ConfidenceLevel` - RiC-O confidence level
      - **Close**: `crm:P141_assigned` - CIDOC-CRM attribute assignment
      
      **Standard Values for level_value**:
      - CERTAIN: Documentary evidence confirms the claim
      - PROBABLE: Strong circumstantial evidence supports the claim
      - POSSIBLE: Reasonable inference from available context
      - UNCERTAIN: Speculative or unverified claim
      
      **Use Cases**:
      - Provenance event certainty (ProvenanceEvent)
      - Attribution confidence (artwork authorship)
      - Dating confidence (temporal assertions)
      - Identification confidence (person/place identification)
      
      **Replaces** (per slot_fixes.yaml):
      - `certainty_level` (string) → has_level with CertaintyLevel class
      - `certainty_note` (string) → has_note with Note class (within CertaintyLevel)
      
    exact_mappings:
      - rico:ConfidenceLevel
    
    close_mappings:
      - crm:P141_assigned
      - prov:qualifiedAssociation
    
    slots:
      - has_level
      - has_note
      - has_score
    
    slot_usage:
      has_level:
#         range: string
        required: true
        examples:
          - value: CERTAIN
          - value: PROBABLE
          - value: POSSIBLE
          - value: UNCERTAIN
      has_note:
#         range: string
        multivalued: true
        inlined: false # Fixed invalid inline for primitive type
        required: false
        examples:
          - value:
              note_type: certainty
              note_content: "Confirmed by sale catalogue and receipt"
          - value:
              note_type: certainty
              note_content: "Inferred from stylistic analysis and collection history"
          - value:
              note_type: certainty
              note_content: "Provenance gap 1933-1945 requires further research"
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: Certainty documentation applicable to all custodian types.
      custodian_types_primary: null
      specificity_score: 0.4
      specificity_rationale: Moderately specific class for provenance and attribution certainty.
    
    examples:
      - value: |
          level_value: CERTAIN
          has_note:
            - note_type: certainty
              note_content: "Confirmed by sale catalogue and receipt"
              note_date: "2025-06-15"
      - value: |
          level_value: PROBABLE
          has_note:
            - note_type: certainty
              note_content: "Van Ruijven was Vermeer's patron; likely acquired directly from artist"
      - value: |
          level_value: UNCERTAIN
          has_note:
            - note_type: certainty
              note_content: "Provenance gap 1933-1945 requires further research"
            - note_type: certainty
              note_content: "Documentation incomplete; collector fled Vienna 1938"