GY-63_MS5611/libraries/Temperature/temperature.h

#pragma once
//
//    FILE: temperature.h
// VERSION: 0.2.5
//    DATE: 2015-03-29
// PURPOSE: collection temperature functions
//
//  HISTORY:
//  0.1.0   2015-03-29  initial version
//  0.1.1   2017-07-26  double to float (issue #33)
//  0.2.0   2020-04-04  #pragma once, removed WProgram.h, readme.md, comments
//                      replaced obsolete links with new ones,
//                      tested and removed some code
//  0.2.1   2020-05-26  added wind-chill formulas
//  0.2.2   2020-06-19  fix library.json
//  0.2.3   2020-08-27  fix #5 order of functions, typo, fixed 1 example
//  0.2.4   2021-01-08  Arduino-CI + unit tests
//  0.2.5   2021-12-28  Arduino-CI, library.json, readme.md, license, minor edits


#define TEMPERATURE_VERSION     (F("0.2.5"))


inline float Fahrenheit(float celsius)
{
  return 1.8 * celsius + 32;    // 5.0 / 9.0 = 1.8
}


inline float Celsius(float fahrenheit)
{
  return (fahrenheit - 32) * 0.55555555555;   // 5.0 / 9.0 = 0.555...
}


inline float Kelvin(float celsius)
{
  return celsius + 273.15;
}


// reference:
// [1] https://wahiduddin.net/calc/density_algorithms.htm
// [2] https://web.archive.org/web/20100528030817/https://www.colorado.edu/geography/weather_station/Geog_site/about.htm
// dewPoint function based on code of [2]
// calculation of the saturation vapour pressure part is based upon NOAA ESGG(temp)
float dewPoint(float celsius, float humidity)
{
  // Calculate saturation vapour pressure
  // ratio 100C and actual temp in Kelvin
  float A0 = 373.15 / (273.15 + celsius);
  // SVP = Saturation Vapor Pressure - based on ESGG() NOAA
  float SVP = -7.90298 * (A0 - 1.0);
  SVP +=  5.02808 * log10(A0);
  SVP += -1.3816e-7 * (pow(10, (11.344 * ( 1.0 - 1.0/A0))) - 1.0 );
  SVP +=  8.1328e-3 * (pow(10, (-3.49149 * (A0 - 1.0 ))) - 1.0 ) ;
  SVP += log10(1013.246);

  // calculate actual vapour pressure VP;
  // note to convert to KPa the -3 is used
  float VP = pow(10, SVP - 3) * humidity;
  float T = log( VP / 0.61078);   // temp var
  return (241.88 * T) / (17.558 - T);
}


// dewPointFast() is > 5x faster than dewPoint() - run dewpoint_test.ino
// delta mdewPointFastax with dewPoint() - run dewpoint_test.ino ==> ~0.347
// (earlier version mentions ~0.6544 but that test code is gone :(
// http://en.wikipedia.org/wiki/Dew_point
float dewPointFast(float celsius, float humidity)
{
  float a = 17.271;
  float b = 237.7;
  float temp = (a * celsius) / (b + celsius) + log(humidity/100);
  float Td = (b * temp) / (a - temp);
  return Td;
}


// https://en.wikipedia.org/wiki/Humidex
float humidex(float celsius, float dewPoint)
{
  float e = 19.833625 - 5417.753 /(273.16 + dewPoint);
  float h = celsius + 3.3941 * exp(e) - 5.555;
  return h;
}


// https://en.wikipedia.org/wiki/Heat_index
// TODO add valid range for TF & R
// TF = temp in Fahrenheit
// R = humidity in %
float heatIndex(float TF, float R)
{
  const float c1 = -42.379;
  const float c2 =  2.04901523;
  const float c3 = 10.14333127;
  const float c4 = -0.22475541;
  const float c5 = -0.00683783;
  const float c6 = -0.05481717;
  const float c7 =  0.00122874;
  const float c8 =  0.00085282;
  const float c9 = -0.00000199;

  float A = (( c5 * TF) + c2) * TF + c1;
  float B = (((c7 * TF) + c4) * TF + c3) * R;
  float C = (((c9 * TF) + c8) * TF + c6) * R * R;

  return A + B + C;
}


// https://en.wikipedia.org/wiki/Heat_index
// TODO add valid range for TF & R
float heatIndexC(float celcius, float humidity)
{
  const float c1 = -8.78469475556;
  const float c2 =  1.61139411;
  const float c3 =  2.33854883889;
  const float c4 = -0.14611605;
  const float c5 = -0.012308094;
  const float c6 = -0.0164248277778;
  const float c7 =  0.002211732;
  const float c8 =  0.00072546;
  const float c9 = -0.000003582;

  float A = (( c5 * celcius) + c2) * celcius + c1;
  float B = (((c7 * celcius) + c4) * celcius + c3) * humidity;
  float C = (((c9 * celcius) + c8) * celcius + c6) * humidity * humidity;

  return A + B + C;
}


// https://en.wikipedia.org/wiki/Wind_chill
//    US     = Fahrenheit / miles
//    METRIC = Celsius / meter/sec
// 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


// US
float WindChill_F_mph(const float fahrenheit, const float milesPerHour, const bool convert = true)
{
  float windSpeed = milesPerHour;
  if (convert) windSpeed = pow(milesPerHour, 0.16);
  return 35.74 + 0.6125 * fahrenheit + (0.4275 * fahrenheit - 35.75) * windSpeed;
}


// METRIC
float WindChill_C_kmph(const float celcius, const float kilometerPerHour, const bool convert = true)
{
  float windSpeed = kilometerPerHour;
  if (convert) windSpeed = pow(kilometerPerHour, 0.16);
  return 13.12 + 0.6215 * celcius + (0.3965 * celcius - 11.37) * windSpeed;
}


float WindChill_C_mps(const float celcius, const float meterPerSecond, const bool convert = true)
{
  return WindChill_C_kmph(celcius, meterPerSecond * 3.6, convert);
}


// -- END OF FILE --