glam/schemas/20251121/linkml/modules/classes/Setpoint.yaml
kempersc fc405445c6 Refactor and update schema definitions
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`.
- Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples.
- Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`.
- Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files.
- Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
2026-02-01 19:55:38 +01:00

112 lines
4.2 KiB
YAML

id: https://nde.nl/ontology/hc/class/Setpoint
name: setpoint_class
title: Setpoint Class
description: "Environmental control setpoint for storage conditions.\n\nCreated per slot_fixes.yaml migration for:\n- temperature_target \u2192 has_or_had_setpoint + Setpoint\n- temperature_min \u2192 has_or_had_setpoint + Setpoint\n- temperature_max \u2192 has_or_had_setpoint + Setpoint\n- target_temperature_celsius \u2192 has_or_had_setpoint + Setpoint\n- target_relative_humidity \u2192 has_or_had_setpoint + Setpoint\n\nThis class models environmental control parameters (temperature, humidity, etc.)\nas first-class entities with proper unit handling, tolerances, and ISO standard references.\n"
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/MeasureUnitEnum
- ../enums/SetpointTypeEnum
- ../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,\nand tolerance for a measurable property (temperature, humidity, light, etc.).\n\n**BRICK SCHEMA ALIGNMENT**:\nbrick:Setpoint - \"A point that represents a value used to guide the \noperation of equipment and/or systems\"\n\n**PRESERVATION CONTEXT**:\nSetpoints define target environmental conditions for heritage preservation.\nHVAC systems maintain conditions around setpoints within tolerance bands.\n\n**ISO STANDARD REFERENCES**:\n- ISO 11799:2015 (Archives): 16-18\xB0C, 30-45% RH\n- ISO 18911:2010 (Cold storage): 0 to +4\xB0C, 30% RH\n- ISO 18920:2011 (Photographs): 15-18\xB0C, 30-40% RH\n- BS 4971:2017 (UK Standard): 13-16\xB0C, 35-60% RH\n- EN 15757:2010 (Climate control): historic climate principle\n"
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
examples:
- value: TEMPERATURE
- value: RELATIVE_HUMIDITY
- value: LIGHT_LUX
setpoint_value:
range: float
required: true
examples:
- value: 18.0
- value: 50.0
setpoint_min:
range: float
required: false
examples:
- value: 16.0
setpoint_max:
range: float
required: false
examples:
- value: 20.0
setpoint_tolerance:
range: float
required: false
examples:
- value: 2.0
setpoint_unit:
range: MeasureUnitEnum
required: true
examples:
- value: DEGREE_CELSIUS
- value: PERCENT
- value: LUX
iso_standard_reference:
range: string
required: false
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
- 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
- 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
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"