id: https://nde.nl/ontology/hc/class/area
name: area_class
title: Area Class
description: >-
  Class representing an area measurement with value, unit, and context.
  
  **RULE 53 COMPLIANT**: This is the authoritative class for area measurements,
  replacing domain-specific float slots like area_hectares, building_floor_area_sqm,
  and has_area_in_hectare.
  
  **REPLACES**:
  - area_hectares (OutdoorSite) - float in hectares
  - building_floor_area_sqm (HistoricBuilding) - float in square meters
  - has_area_in_hectare (bespoke, incorrectly created)
  
  **ADVANTAGES OVER SIMPLE FLOAT**:
  - Explicit unit specification (no ambiguity between m² and hectares)
  - Temporal context (measurement date for historic facilities)
  - Provenance (measurement method, source)
  - Estimation flag (is_estimate for approximate values)

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  qudt: http://qudt.org/schema/qudt/
  geosparql: http://www.opengis.net/ont/geosparql#

imports:
  - linkml:types
  - ../slots/20260202_matang/has_label
  - ../slots/20260202_matang/has_measurement_unit
  - ../slots/20260202_matang/has_value
  - ../slots/20260202_matang/new/is_estimate
  - ../slots/20260202_matang/new/measurement_date
  - ../slots/20260202_matang/new/measurement_method
default_prefix: hc

classes:
  Area:
    description: >-
      A measurement of spatial extent (area) with value, unit, and metadata.
      
      Captures area measurements for heritage facilities including outdoor sites,
      buildings, rooms, and storage areas. Supports multiple units (m², hectares,
      acres) with explicit unit specification.
      
      **TEMPORAL ASPECT**: Areas can change over time (building extensions,
      site acquisitions). The measurement_date captures when the area was measured.
      
      **ESTIMATION SUPPORT**: Heritage facilities often have estimated areas,
      especially for historic buildings. The is_estimate flag indicates uncertainty.
    class_uri: qudt:QuantityValue
    exact_mappings:
      - qudt:QuantityValue
    close_mappings:
      - schema:QuantitativeValue
      - geosparql:hasArea
    slots:
      - has_value
      - has_unit
      - measurement_date
      - is_estimate
      - measurement_method
      - has_label
    slot_usage:
      has_value:
        range: float
        required: true
        examples:
          - value: 25.0
          - value: 5000.0
      has_unit:
        range: MeasureUnit
        required: true
        inlined: true
        examples:
          - value:
              has_type: HECTARE
              has_symbol: "ha"
          - value:
              has_type: SQUARE_METER
              has_symbol: "m²"
      measurement_date:
        range: date
        required: false
        examples:
          - value: "2024-01-15"
          - value: "1985-06-01"
      is_estimate:
        range: boolean
        required: false
        examples:
          - value: true
          - value: false
      measurement_method:
#         range: string
        required: false
        examples:
          - value: "GIS analysis"
          - value: "Land survey"
          - value: "Historical records"
      has_label:
#         range: string
        examples:
          - value: "Total site area"
          - value: "Building floor area"
    examples:
      - value:
          has_unit:
            has_type: HECTARE
            has_symbol: "ha"
          has_label: "Sculpture garden area"
      - value:
          has_unit:
            has_type: SQUARE_METER
            has_symbol: "m²"
          measurement_date: "2023-03-15"
          is_estimate: false
          measurement_method: "Architectural survey"
          has_label: "Total floor area"
      - value:
          has_unit:
            has_type: HECTARE
            has_symbol: "ha"
          is_estimate: true
          measurement_method: "Historical records"
          has_label: "Estate grounds"
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: >-
        Area measurements applicable to all heritage custodian types.
      specificity_score: 0.4
      specificity_rationale: >-
        Broadly useful class - area measurements relevant for site planning,
        collection storage, visitor capacity, and facility management.


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