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_setpoint + Setpoint\n- temperature_min \u2192 has_setpoint + Setpoint\n- temperature_max \u2192 has_setpoint + Setpoint\n- target_temperature_celsius \u2192 has_setpoint + Setpoint\n- target_relative_humidity \u2192 has_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/has_reference
  - ../slots/maximum_of_maximum
  - ../slots/minimum_of_minimum
  - ../slots/has_level
  - ../slots/has_setpoint
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:
    - has_setpoint
    - has_setpoint
    - minimum_of_minimum
    - maximum_of_maximum
    - has_level
    - has_setpoint
    - has_reference
    slot_usage:
      has_setpoint:
        range: SetpointTypeEnum
        required: true
        examples:
        - value: TEMPERATURE
        - value: RELATIVE_HUMIDITY
        - value: LIGHT_LUX
      has_setpoint:
        range: float
        required: true
        examples:
        - value: 18.0
        - value: 50.0
      minimum_of_minimum:
        range: float
        required: false
        examples:
        - value: 16.0
      maximum_of_maximum:
        range: float
        required: false
        examples:
        - value: 20.0
      has_level:
        range: float
        required: false
        examples:
        - value: 2.0
      has_setpoint:
        range: MeasureUnitEnum
        required: true
        examples:
        - value: DEGREE_CELSIUS
        - value: PERCENT
        - value: LUX
      has_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: "['*']"