GY-63_MS5611/libraries/Temperature
2022-11-27 09:30:41 +01:00
..
.github add funding.yml 2022-08-03 21:56:07 +02:00
examples 0.3.3 Temperature 2022-01-09 20:35:35 +01:00
test 0.3.3 Temperature 2022-01-09 20:35:35 +01:00
.arduino-ci.yml 0.3.5 Temperature 2022-11-26 13:09:08 +01:00
CHANGELOG.md 0.3.5 Temperature 2022-11-26 13:09:08 +01:00
keywords.txt 0.3.2 Temperature 2022-01-09 11:07:58 +01:00
library.json 0.3.5 Temperature 2022-11-26 13:09:08 +01:00
library.properties 0.3.5 Temperature 2022-11-26 13:09:08 +01:00
LICENSE 0.2.5 Temperature 2021-12-28 19:11:26 +01:00
readme.md 0.3.5 Temperature 2022-11-26 13:09:08 +01:00
temperature.cpp 0.3.5 Temperature 2022-11-26 13:09:08 +01:00
temperature.h bump version string 2022-11-27 09:30:41 +01:00

Arduino CI Arduino-lint JSON check License: MIT GitHub release

Temperature

Arduino library with temperature conversion and weather functions including dewPoint, humidex, heatIndex and wind-chill.

Description

This library contains weather related functions. These functions are approximations based on work of NOAA a.o.

These functions can be used with temperature and humidity sensors e.g. DHT22 or Sensirion, to make a weather station application.

Note: pre-0.3.1 versions have incorrect heat-index.

Interface

Conversion

  • float Fahrenheit(float Celsius) idem.
  • float Celsius(float Fahrenheit) idem.
  • float Kelvin(float Celsius) idem.

More converters are implemented in the temperatureConverter class below.

DewPoint, humidex

  • float dewPoint(float Celsius, float humidity) idem.
  • float dewPointFast(float Celsius, float humidity) idem.
  • float humidex(float Celsius, float dewPoint) idem.

heatIndex

  • float heatIndex(float Fahrenheit, float humidity) idem.
  • float heatIndexC(float Celsius, float humidity) idem.

0.3.0

The formula for the heatIndex() was taken from https://en.wikipedia.org/wiki/Heat_index. Since version 0.3.0 the more elaborated version of https://www.wpc.ncep.noaa.gov/html/heatindex_equation.shtml will be used. Note: there will be performance differences.

Indicative table

Fahrenheit Celsius description colour code
70-79 21-26 warm green
80-89 26-32 very warm yellow
90-104 32-40 hot orange
105-129 40-54 very hot red
> 130 > 54 extreme hot purple

WindChill

Wind speed @ 10 meter, if convert is true => wind speed will be converted to 1.5 meter else ==> formula assumes wind speed @ 1.5 meter

  • float WindChill_F_mph(float Fahrenheit, float milesPerHour, bool convert = true)
  • float WindChill_C_kmph(float Celsius, float kilometerPerHour, bool convert = true)
  • float WindChill_C_mps(float Celsius, float meterPerSecond, bool convert = true)

Indicative table (subjective).

wind chill °C description
> -10 cold
-10 .. -25 very cold !
-25 .. -35 very very cold !
-35 .. -55 chance of frostbite
< -55 serious dangerous

temperatureConverter class

Since version 0.3.2 a temperature convertor class is added to convert to and from other (less known) temperature scales. The idea is to set a value in one scale and retrieve it in the other. As the converter holds the last value set, multiple conversions are easy. See example.

The scales are typically named after their inventor. Check Wikipedia for details about the scales.

Name units 1° in °K 0°C 100°C notes
Celsius °C 1.000000 0.00 100.00
Delisle °De 0.666666 -100.00 50.00
Fahrenheit °F 0.555556 32.00 212.00
Kelvin °K 1.000000 273.15 373.15
Newton -- 3.030303 0.00 33.00 not the force.
Rankine °Ra 0.555556 491.76 671.67 0°Ra == 0°K, steps == Fahrenheit.
Reamur °Re 1.250000 0.00 80.00
Romer °Ro 1.904762 7.50 60.00

Note: units to be verified.

Note: this class is slightly slower than direct conversion, but it prevents to have 8 x 7 optimized functions.

Interface

Constructor

  • temperatureConverter() Constructor sets the default to zero degrees C.

setters

  • void setKelvin(float value = 0)
  • void setCelsius(float value = 0)
  • void setFahrenheit(float value = 0)
  • void setReamur(float value = 0)
  • void setRankine(float value = 0)
  • void setDelisle(float value = 0)
  • void setNewton(float value = 0)
  • void setRomer(float value = 0)

getters

  • void getKelvin()
  • void getCelsius()
  • void getFahrenheit()
  • void getReamur()
  • void getRankine()
  • void getDelisle()
  • void getNewton()
  • void getRomer()

Operations

The functions have a limited scope so one cannot use it for all input values possible. The user should be aware of that. Check the references mentioned in the code and or Wikipedia to confirm the applicability of the values generated. The functions do not check the inputs.

See examples for typical usage.

Future

must

should

could