id: https://nde.nl/ontology/hc/class/TemperatureDeviation
name: TemperatureDeviation
title: Temperature Deviation Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  qudt: http://qudt.org/schema/qudt/
  brick: https://brickschema.org/schema/Brick#
  schema: http://schema.org/
  crm: http://www.cidoc-crm.org/cidoc-crm/
  wd: http://www.wikidata.org/entity/
default_prefix: hc
imports:
  - linkml:types
  - ../slots/has_or_had_description
  - ../slots/has_or_had_label
  - ../slots/has_or_had_measurement_unit
  - ../slots/has_or_had_quantity
classes:
  TemperatureDeviation:
    class_uri: qudt:Tolerance
    description: "Structured specification of allowed temperature deviation/tolerance.\n\
      **DEFINITION**:\nRepresents the acceptable range of temperature variation from\
      \ a setpoint, typically expressed as ±X degrees Celsius (e.g., ±2°C).\n**ONTOLOGY\
      \ MAPPING**:\n- class_uri: qudt:Tolerance (QUDT tolerance concept) - close_mapping:\
      \ brick:Temperature_Deadband (building automation)\n**ISO STANDARD REFERENCE\
      \ VALUES**:\n| Standard | Context | Typical Tolerance | |----------|---------|-------------------|\
      \ | ISO 11799:2015 | Archives | ±2°C daily | | ISO 18911:2010 | Cold/Frozen\
      \ Storage | ±2°C | | BS 4971:2017 | UK Sensitive Materials | ±1°C | | EN 16893:2018\
      \ | Museums | ±2°C recommended |\n**PRESERVATION CONTEXT**:\nTemperature fluctuations\
      \ cause dimensional changes in hygroscopic materials (paper, parchment, leather,\
      \ textiles). Repeated cycling leads to mechanical fatigue and cumulative damage.\
      \ Tighter tolerances are critical for mixed media objects (e.g., oil paintings\
      \ on canvas).\n**WHY NOT JUST FLOAT?**\nSimple float fields like `temperature_tolerance:\
      \ 2.0` lose important context: - What's the unit? (Celsius? Fahrenheit?) - Is\
      \ this plus/minus or just plus? - What standard is this based on? - When was\
      \ this tolerance established?\n**MIGRATION NOTE**:\nThis class replaces the\
      \ bespoke `temperature_tolerance` slot (float range). Used via the generic `allows_or_allowed`\
      \ slot per Rule 53/56.\n**EXAMPLE**:\n```yaml EnvironmentalZone:\n  allows_or_allowed:\n\
      \    - deviation_value: 2.0\n      deviation_direction: PLUS_MINUS\n      has_or_had_measurement_unit:\n\
      \        has_or_had_type: DEGREE_CELSIUS\n        has_or_had_symbol: \"°C\"\n\
      \      iso_standard_reference: \"ISO 11799:2015\"\n```"
    exact_mappings:
    - qudt:Tolerance
    close_mappings:
    - brick:Temperature_Deadband
    - crm:E54_Dimension
    related_mappings:
    - wd:Q11466
    - schema:additionalProperty
    slots:
    - has_or_had_quantity
    - has_or_had_measurement_unit
    - has_or_had_description
    - has_or_had_label
    - iso_standard_reference
    slot_usage:
      has_or_had_quantity:
        range: integer
        required: false
        inlined: true
        examples:
        - value:
            has_or_had_measurement_unit:
              has_or_had_type: DEGREE_CELSIUS
              has_or_had_symbol: °C
      has_or_had_measurement_unit:
        range: MeasureUnit
        required: false
        inlined: true
        examples:
        - value:
            has_or_had_type: DEGREE_CELSIUS
            has_or_had_symbol: °C
      has_or_had_description:
        range: string
        required: false
        examples:
        - value: Tighter tolerance required for daguerreotype collection
      has_or_had_label:
        range: string
        required: false
        examples:
        - value: Archive Standard Tolerance
        - value: Cold Storage Precision Tolerance
    comments:
    - MIGRATED from temperature_tolerance slot (float) per Rule 53/56
    - Used via allows_or_allowed slot for temporal flexibility
    - Companion to humidity_tolerance migration (HumidityDeviation class)
    - Setpoint class already handles target values - this handles deviations
    see_also:
    - https://www.iso.org/standard/63810.html
    - https://www.iso.org/standard/46602.html
    - http://qudt.org/schema/qudt/Tolerance
    annotations:
      specificity_score: '0.65'
      specificity_rationale: Specialized for environmental control in storage facilities
      qudt_unit: unit:DEG_C
      ucum_code: Cel
      iso_reference: ISO 11799:2015, ISO 18911:2010, BS 4971:2017
      preservation_parameter: 'true'
      custodian_types: '[''*'']'
    examples:
    - value:
        has_or_had_measurement_unit:
          has_or_had_type: DEGREE_CELSIUS
          has_or_had_symbol: °C
        iso_standard_reference: ISO 11799:2015
        has_or_had_label: Standard Archive Tolerance
        has_or_had_description: Per ISO 11799:2015 for paper-based materials
    - value:
        has_or_had_measurement_unit:
          has_or_had_type: DEGREE_CELSIUS
          has_or_had_symbol: °C
        iso_standard_reference: BS 4971:2017
        has_or_had_label: Sensitive Materials Tolerance
    - value:
        iso_standard_reference: ISO 18911:2010
        has_or_had_description: Precision cold storage for film negatives
enums:
  DeviationDirectionEnum:
    description: Direction of allowed deviation from a setpoint.
    permissible_values:
      PLUS_MINUS: null
      PLUS: null
      MINUS: null