glam/schemas/20251121/linkml/modules/classes/Area.yaml

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/has_or_had_label
- ../slots/has_or_had_unit
- ../slots/is_estimate
- ../slots/measurement_date
- ../slots/measurement_method
- ./MeasureUnit
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:
      - quantity_value  # was: area_value (migrated 2026-01-22)
      - has_or_had_unit
      - measurement_date
      - is_estimate
      - measurement_method
      - has_or_had_label
    slot_usage:
      quantity_value:
        description: >-
          The numeric value of the area measurement.
          MIGRATED from area_value (2026-01-22) which was migrated from 
          area_hectares, building_floor_area_sqm (Rule 53).
          Using generic quantity_value aligns Area semantics with Quantity class.          
        range: float
        required: true
        examples:
          - value: 25.0
            description: 25 hectares (outdoor site)
          - value: 5000.0
            description: 5000 square meters (building)
      has_or_had_unit:
        description: >-
          The unit of measurement for this area.
          MIGRATED from implicit unit assumptions (Rule 53).          
        range: MeasureUnit
        required: true
        inlined: true
        examples:
          - value:
              has_or_had_type: HECTARE
              has_or_had_symbol: "ha"
            description: Hectare unit for outdoor site
          - value:
              has_or_had_type: SQUARE_METER
              has_or_had_symbol: "m²"
            description: Square meter unit for building floor
      measurement_date:
        description: >-
          Date when the area was measured or recorded.          
        range: date
        required: false
        examples:
          - value: "2024-01-15"
            description: Recent measurement
          - value: "1985-06-01"
            description: Historic measurement
      is_estimate:
        description: >-
          Whether the area is an estimate (true) or precise measurement (false).          
        range: boolean
        required: false
        examples:
          - value: true
            description: Estimated area for historic building
          - value: false
            description: Precise surveyed measurement
      measurement_method:
        description: >-
          Method used to measure the area (survey, GIS, historical records, etc.).          
        range: string
        required: false
        examples:
          - value: "GIS analysis"
            description: Geographic Information System measurement
          - value: "Land survey"
            description: Professional survey
          - value: "Historical records"
            description: From archival documents
      has_or_had_label:
        description: >-
          Human-readable label for the area measurement.          
        range: string
        examples:
          - value: "Total site area"
            description: Label for outdoor site
          - value: "Building floor area"
            description: Label for building
    examples:
      - value:
          quantity_value: 25.0
          has_or_had_unit:
            has_or_had_type: HECTARE
            has_or_had_symbol: "ha"
          has_or_had_label: "Sculpture garden area"
        description: Outdoor site area in hectares (replaces area_hectares)
      - value:
          quantity_value: 5000.0
          has_or_had_unit:
            has_or_had_type: SQUARE_METER
            has_or_had_symbol: "m²"
          measurement_date: "2023-03-15"
          is_estimate: false
          measurement_method: "Architectural survey"
          has_or_had_label: "Total floor area"
        description: Building floor area in square meters (replaces building_floor_area_sqm)
      - value:
          quantity_value: 650.0
          has_or_had_unit:
            has_or_had_type: HECTARE
            has_or_had_symbol: "ha"
          is_estimate: true
          measurement_method: "Historical records"
          has_or_had_label: "Estate grounds"
        description: Historic estate grounds with estimated area
    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