id: https://nde.nl/ontology/hc/class/measure-unit
name: measure_unit_class
title: MeasureUnit Class
description: >-
  Class representing a unit of measurement for quantities.
  
  **RULE 53 COMPLIANT**: Generic class for standardized unit representation,
  used by Area, Quantity, and other measurement classes.
  
  **ONTOLOGY ALIGNMENT**:
  - QUDT (Quantities, Units, Dimensions and Types)
  - schema:unitCode / schema:unitText
  - OM (Ontology of Units of Measure)

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  qudt: http://qudt.org/schema/qudt/
  om: http://www.ontology-of-units-of-measure.org/resource/om-2/

imports:
  - linkml:types
  - ../enums/MeasureUnitEnum
  # RiC-O style generic slots - migrated 2026-01-16 per Rule 53
  - ../slots/has_or_had_label
  - ../slots/has_or_had_code       # was: unit_code
  - ../slots/has_or_had_symbol     # was: unit_symbol
  - ../slots/has_or_had_type       # was: unit_type

default_prefix: hc

classes:
  MeasureUnit:
    description: >-
      A unit of measurement for expressing quantities.
      
      Captures the unit type (from MeasureUnitEnum), symbol, and optional
      conversion factors. Used as the range for has_or_had_unit slot.
      
      **EXAMPLES**:
      - Hectare (ha) for outdoor site area
      - Square meter (m²) for building floor area
      - Linear meter (m) for archival shelf extent
    class_uri: qudt:Unit
    exact_mappings:
      - qudt:Unit
      - om:Unit
    close_mappings:
      - schema:unitCode
    slots:
      - has_or_had_type      # was: unit_type - migrated 2026-01-16 per Rule 53
      - has_or_had_symbol    # was: unit_symbol - migrated 2026-01-16 per Rule 53
      - has_or_had_code      # was: unit_code - migrated 2026-01-16 per Rule 53
      - has_or_had_label
    slot_usage:
      has_or_had_type:  # was: unit_type - migrated 2026-01-16 per Rule 53
        description: >-
          The type of unit from MeasureUnitEnum (e.g., HECTARE, SQUARE_METER).
        range: MeasureUnitEnum
        required: true
      has_or_had_symbol:  # was: unit_symbol - migrated 2026-01-16 per Rule 53
        description: >-
          The symbol for the unit (e.g., "ha", "m²", "km").
        range: string
        required: false
        examples:
          - value: "ha"
            description: Hectare symbol
          - value: "m²"
            description: Square meter symbol
          - value: "m"
            description: Meter symbol
      has_or_had_code:  # was: unit_code - migrated 2026-01-16 per Rule 53
        description: >-
          Standard code for the unit (UCUM or QUDT code).
        range: string
        required: false
        examples:
          - value: "har"
            description: UCUM code for hectare
          - value: "m2"
            description: UCUM code for square meter
      has_or_had_label:
        description: >-
          Human-readable label for the unit.
        range: string
        examples:
          - value: "hectare"
            description: Hectare label
          - value: "square meter"
            description: Square meter label
    examples:
      - value:
          has_or_had_type: HECTARE
          has_or_had_symbol: "ha"
          has_or_had_code: "har"
          has_or_had_label: "hectare"
        description: Hectare unit for outdoor site area
      - value:
          has_or_had_type: SQUARE_METER
          has_or_had_symbol: "m²"
          has_or_had_code: "m2"
          has_or_had_label: "square meter"
        description: Square meter unit for building floor area
      - value:
          has_or_had_type: LINEAR_METER
          has_or_had_symbol: "m"
          has_or_had_code: "m"
          has_or_had_label: "linear meter"
        description: Linear meter for archival shelf extent
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: >-
        Measurement units applicable to all heritage custodian types.
      specificity_score: 0.3
      specificity_rationale: >-
        Foundational class - highly reusable across many contexts.


# REMOVED inline slots 2026-01-16 - Rule 48 violation
# Slots are imported from ../slots/ - do not define inline