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

141 lines
No EOL
4.4 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/has_or_had_value
- ../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:
- has_or_had_value
- has_or_had_unit
- measurement_date
- is_estimate
- measurement_method
- has_or_had_label
slot_usage:
has_or_had_value:
range: float
required: true
examples:
- value: 25.0
- value: 5000.0
has_or_had_unit:
range: MeasureUnit
required: true
inlined: true
examples:
- value:
has_or_had_type: HECTARE
has_or_had_symbol: "ha"
- value:
has_or_had_type: SQUARE_METER
has_or_had_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_or_had_label:
range: string
examples:
- value: "Total site area"
- value: "Building floor area"
examples:
- value:
has_or_had_unit:
has_or_had_type: HECTARE
has_or_had_symbol: "ha"
has_or_had_label: "Sculpture garden area"
- value:
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"
- value:
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"
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