glam/schemas/20251121/linkml/modules/classes/Area.yaml
2026-01-30 23:56:19 +01:00

176 lines
No EOL
6.2 KiB
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
- ../slots/quantity_value
- ./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