units_of_measurement

Rule languages supports OpenHAB units of measurement

    • Given Clean OpenHAB with latest Ruby Libraries
    • And group "Numbers"
    • And items:
      typenamestatepattern
      Number:TemperatureNumberC23%.5f °C
      Number:TemperatureNumberF70%.5f °F
      NumberDimensionless2

  • | converts NumberItem to another unit

    • Given code in a rules file
        result = <convert_line>
  logger.info("#{NumberC.id} is #{result.format('%.1f %unit%')} in Fahrenheit")
    • When I deploy the rules file
    • Then It should log 'NumberC is 73.4 °F in Fahrenheit' within 5 seconds

    Examples:

    convert_line
    NumberC |ImperialUnits::FAHRENHEIT
    NumberC |'°F'

  • | Creates a QuantityType from a Dimensionless NumberItem

    • Given code in a rules file
        result = <convert_line>
  logger.info("#{Dimensionless.id} is #{result.format('%.1f %unit%')} in Fahrenheit")
    • When I deploy the rules file
    • Then It should log 'Dimensionless is 2.0 °F in Fahrenheit' within 5 seconds

    Examples:

    convert_line
    Dimensionless |ImperialUnits::FAHRENHEIT
    Dimensionless |'°F'

  • Dimensionless Numbers can be used for multiplication and division

    • Given code in a rules file
        result = <code_line>
  logger.info("Result is #{result.format('%.1f %unit%')}")
    • When I deploy the rules file
    • Then It should log 'Result is <result>' within 5 seconds

    Examples:

    code_line result
    NumberF * Dimensionless 140.0 °F
    NumberF / Dimensionless 35.0 °F
    Dimensionless * NumberF 140.0 °F
    2 * NumberF 140.0 °F

  • Comparisons work on dimensioned number items with different, but comparable units.

    • Given code in a rules file
        result = NumberC > NumberF
  logger.info("Result is #{result}")
    • When I deploy the rules file
    • Then It should log 'Result is true' within 5 seconds

  • Each unit needs to be normalized for all operations when combining operators with comparitors.

    • Given code in a rules file
        result = (NumberC |'°F') - (NumberF |'°F') < '4 °F'
  logger.info("Result is #{result}")
    • When I deploy the rules file
    • Then It should log 'Result is true' within 5 seconds

  • unit block should convert all units and numbers to a specific unit for all operations

    • Given code in a rules file
        result = <code_line>
  logger.info("Result is #{result.is_a?(QuantityType) ? result.format('%.1f %unit%') : result}")
    • When I deploy the rules file
    • Then It should log 'Result is <result>' within 5 seconds

    Examples:

    code_line result
    unit('°F') { NumberC - NumberF < 4 } true
    unit('°F') { NumberC - '24 °C' < 4 } true
    unit('°F') { QuantityType.new('24 °C') - NumberC < 4 } true
    unit('°C') { NumberF - '20 °C' < 2 } true
    unit('°C') { NumberF - Dimensionless } 19.1 °C
    unit('°C') { NumberC + NumberF } 44.1 °C
    unit('°C') { NumberF - Dimensionless < 20 } true
    unit('°C') { Dimensionless + NumberC == 25 } true
    unit('°C') { 2 + NumberC == 25 } true
    unit('°C') { Dimensionless * NumberC == 46 } true
    unit('°C') { 2 * NumberC == 46 } true
    unit('°C') { ( (2 * (NumberF + NumberC)) / Dimensionless ) < 45 } true
    unit('°C') { [NumberC, NumberF, Dimensionless].min } 2