glam/schemas/20251121/linkml/modules/classes/Setpoint.yaml
2026-01-16 18:57:52 +01:00

158 lines
No EOL
5.1 KiB
YAML

id: https://nde.nl/ontology/hc/class/Setpoint
name: setpoint_class
title: Setpoint Class
description: |
Environmental control setpoint for storage conditions.
Created per slot_fixes.yaml migration for:
- temperature_target → has_or_had_setpoint + Setpoint
- temperature_min → has_or_had_setpoint + Setpoint
- temperature_max → has_or_had_setpoint + Setpoint
- target_temperature_celsius → has_or_had_setpoint + Setpoint
- target_relative_humidity → has_or_had_setpoint + Setpoint
This class models environmental control parameters (temperature, humidity, etc.)
as first-class entities with proper unit handling, tolerances, and ISO standard references.
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
qudt: http://qudt.org/schema/qudt/
brick: https://brickschema.org/schema/Brick#
sosa: http://www.w3.org/ns/sosa/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
default_prefix: hc
imports:
- linkml:types
- ../enums/SetpointTypeEnum
- ../enums/MeasureUnitEnum
- ../slots/iso_standard_reference
- ../slots/setpoint_max
- ../slots/setpoint_min
- ../slots/setpoint_tolerance
- ../slots/setpoint_type
- ../slots/setpoint_unit
- ../slots/setpoint_value
classes:
Setpoint:
class_uri: brick:Setpoint
description: |
An environmental control setpoint specifying a target value, acceptable range,
and tolerance for a measurable property (temperature, humidity, light, etc.).
**BRICK SCHEMA ALIGNMENT**:
brick:Setpoint - "A point that represents a value used to guide the
operation of equipment and/or systems"
**PRESERVATION CONTEXT**:
Setpoints define target environmental conditions for heritage preservation.
HVAC systems maintain conditions around setpoints within tolerance bands.
**ISO STANDARD REFERENCES**:
- ISO 11799:2015 (Archives): 16-18°C, 30-45% RH
- ISO 18911:2010 (Cold storage): 0 to +4°C, 30% RH
- ISO 18920:2011 (Photographs): 15-18°C, 30-40% RH
- BS 4971:2017 (UK Standard): 13-16°C, 35-60% RH
- EN 15757:2010 (Climate control): historic climate principle
exact_mappings:
- brick:Setpoint
- qudt:Quantity
close_mappings:
- sosa:ObservableProperty
slots:
- setpoint_type
- setpoint_value
- setpoint_min
- setpoint_max
- setpoint_tolerance
- setpoint_unit
- iso_standard_reference
slot_usage:
setpoint_type:
range: SetpointTypeEnum
required: true
description: The type of environmental parameter (temperature, humidity, etc.)
examples:
- value: TEMPERATURE
- value: RELATIVE_HUMIDITY
- value: LIGHT_LUX
setpoint_value:
range: float
required: true
description: The target setpoint value.
examples:
- value: 18.0
description: Target temperature 18°C
- value: 50.0
description: Target humidity 50% RH
setpoint_min:
range: float
required: false
description: Minimum acceptable value.
examples:
- value: 16.0
setpoint_max:
range: float
required: false
description: Maximum acceptable value.
examples:
- value: 20.0
setpoint_tolerance:
range: float
required: false
description: Acceptable deviation from target (±).
examples:
- value: 2.0
description: ±2°C tolerance
setpoint_unit:
range: MeasureUnitEnum
required: true
description: Unit of measurement for the setpoint value.
examples:
- value: DEGREE_CELSIUS
- value: PERCENT
- value: LUX
iso_standard_reference:
range: string
required: false
description: ISO or other standard reference for this setpoint.
examples:
- value: "ISO 11799:2015"
- value: "EN 15757:2010"
examples:
- value:
setpoint_type: TEMPERATURE
setpoint_value: 18.0
setpoint_min: 16.0
setpoint_max: 20.0
setpoint_tolerance: 2.0
setpoint_unit: DEGREE_CELSIUS
iso_standard_reference: "ISO 11799:2015"
description: Standard archive temperature setpoint
- value:
setpoint_type: RELATIVE_HUMIDITY
setpoint_value: 50.0
setpoint_min: 45.0
setpoint_max: 55.0
setpoint_tolerance: 5.0
setpoint_unit: PERCENT
iso_standard_reference: "ISO 11799:2015"
description: Standard archive humidity setpoint
- value:
setpoint_type: TEMPERATURE
setpoint_value: -18.0
setpoint_min: -20.0
setpoint_max: -15.0
setpoint_tolerance: 2.0
setpoint_unit: DEGREE_CELSIUS
iso_standard_reference: "ISO 18911:2010"
description: Cold storage temperature setpoint
# REMOVED inline slots 2026-01-16 - Rule 48 violation
# Slots are imported from ../slots/ - do not define inline