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
  - ../slots/has_or_had_label

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:
      - unit_type
      - unit_symbol
      - unit_code
      - has_or_had_label
    slot_usage:
      unit_type:
        description: >-
          The type of unit from MeasureUnitEnum (e.g., HECTARE, SQUARE_METER).
        range: MeasureUnitEnum
        required: true
      unit_symbol:
        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
      unit_code:
        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:
          unit_type: HECTARE
          unit_symbol: "ha"
          unit_code: "har"
          has_or_had_label: "hectare"
        description: Hectare unit for outdoor site area
      - value:
          unit_type: SQUARE_METER
          unit_symbol: "m²"
          unit_code: "m2"
          has_or_had_label: "square meter"
        description: Square meter unit for building floor area
      - value:
          unit_type: LINEAR_METER
          unit_symbol: "m"
          unit_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.

slots:
  unit_type:
    description: >-
      The enumerated type of measurement unit.
    range: MeasureUnitEnum
    slot_uri: qudt:unit

  unit_symbol:
    description: >-
      The symbol representing the unit (e.g., "ha", "m²").
    range: string
    slot_uri: qudt:symbol

  unit_code:
    description: >-
      Standard code for the unit from UCUM or QUDT vocabularies.
    range: string
    slot_uri: qudt:ucumCode