id: https://nde.nl/ontology/hc/classes/Unit
name: Unit
title: Unit
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  qudt: http://qudt.org/schema/qudt/
  schema: http://schema.org/
imports:
  - linkml:types
  - ../slots/has_label
# default_range: string
default_prefix: hc
classes:
  Unit:
    description: 'A simple unit of measurement for quantities.

      **PURPOSE**: Lightweight unit class for cases where a simple label suffices.
      For complex unit definitions with conversion factors, symbols, and dimensional
      analysis, use MeasureUnit class instead.

      **COMMON UNITS FOR HERITAGE COLLECTIONS**:

      | Unit | Description | Example Usage | |------|-------------|---------------|
      | item | Individual objects | "500 items" | | species | Biological species |
      "200 species" | | specimen | Individual specimens | "10,000 specimens" | | volume
      | Books/bound volumes | "50,000 volumes" | | linear_meter | Archival extent
      | "500 linear meters" | | hectare | Site area | "32 hectares" | | square_meter
      | Floor area | "10,000 m²" |

      **QUDT ALIGNMENT**: Maps to `qudt:Unit` for semantic interoperability.

      **RELATIONSHIP TO MeasureUnit**: Unit is a simplified alternative to MeasureUnit.
      Use Unit when: - Only a text label is needed - No conversion factors required
      - Simple quantity expressions

      Use MeasureUnit when: - Need unit symbols and codes - Require dimensional analysis
      - Complex unit conversions needed'
    class_uri: qudt:Unit
    exact_mappings:
    - qudt:Unit
    close_mappings:
    - schema:unitCode
    - schema:unitText
    slots:
    - has_label
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: Units apply to all heritage custodian types for measurement.
      custodian_types_primary: '*'
      specificity_score: 0.2
      specificity_rationale: Very low specificity - fundamental measurement concept.
    examples:
    - value: "Unit:\n  unit_value: \"item\"\n  has_label:\n    - label_text:\
        \ \"Items\"\n"
      description: Simple item count unit.
    - value: "Unit:\n  unit_value: \"species\"\n  has_label:\n    - label_text:\
        \ \"Species\"\n  unit_uri: \"dwc:individualCount\"\n"
      description: Biological species count unit.
    - value: "Unit:\n  unit_value: \"linear_meter\"\n  has_label:\n    - label_text:\
        \ \"Linear Meters\"\n  unit_uri: \"qudt:M\"\n"
      description: Archival extent unit.
    comments:
    - Created from slot_fixes.yaml migration (2026-01-19)
    - Lightweight alternative to MeasureUnit class
    - Use with has_unit slot
    - For collection_size migration - default unit is "item"