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