GY-63_MS5611/libraries/Temperature/readme.md
2023-11-12 12:14:21 +01:00

7.6 KiB

Arduino CI Arduino-lint JSON check GitHub issues

License: MIT GitHub release PlatformIO Registry

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

#include "temperature.h"

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

Absolute Humidity

  • float absoluteHumidity(float Celsius, float relHumidity) Converts relative humidity and temperature to absolute humidity. Return unit is grams/m3.

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

Boiling temperature water

When you are in the mountains the cooking point of water drops. This can be so much that you can't boil an egg on mount Everest.

Temperature in F and C at which water cooks. Based upon: https://en.wikipedia.org/wiki/High-altitude_cooking

  • boilingFahrenheit(feet) boiling temperature Fahrenheit at height in feet.
  • boilingCelsius(meter) boiling temperature Celsius at height in meter.
  • boilingMeter(Celsius) returns height in meters for a given the boiling point in Celsius. Note this is an approximation by reversing the formula. Do not expect it to be very exact.

For Celsius from feet call:

C = boilingCelsius(feet * 0.3048);

For Fahrenheit from meters call:

F = boilingFahrenheit(meter * 3.2808);  //  * 3.280839895  == / 0.3048

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

#include "temperature.h"

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

  • split of TemperatureConversion class as a library of its own.
    • 0.4.0

Should

  • improve documentation
    • add short explanation per conversion unit?
    • freeze/boil temps.
  • unit tests
    • absoluteHumidity
    • boiling tests.
  • add function freezing point shift due to pressure.

Could

Wont

Support

If you appreciate my libraries, you can support the development and maintenance. Improve the quality of the libraries by providing issues and Pull Requests, or donate through PayPal or GitHub sponsors.

Thank you,