0.4.0 Temperature

RobTillaart · RobTillaart · commit c458fc371315 · 2025-06-26T19:55:49.000+02:00
diff --git a/libraries/Temperature/CHANGELOG.md b/libraries/Temperature/CHANGELOG.md
@@ -6,14 +6,23 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 
+## [0.4.0] - 2025-06-26
+- add discomfortIndex
+- add example
+- update unit tests
+- update keywords.txt
+- update readme.md
+- minor edits
+
+----
+
 ## [0.3.7] - 2023-11-12
 - update readme.md
 - renamed TEMPERATURE_VERSION => TEMPERATURE_LIB_VERSION
 - updated examples to show LIB version
 - update keywords.txt
 - minor edits
 
-
 ## [0.3.6] - 2023-02-17
 - add **absoluteHumidity(TC, RH)** from relative humidity
 - add **boilingFahrenheit(feet)** boiling temperature Fahrenheit at height in feet.
diff --git a/libraries/Temperature/LICENSE b/libraries/Temperature/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2015-2024 Rob Tillaart
+Copyright (c) 2015-2025 Rob Tillaart
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/libraries/Temperature/examples/boilingPoint_test/boilingPoint_test.ino b/libraries/Temperature/examples/boilingPoint_test/boilingPoint_test.ino
@@ -3,7 +3,6 @@
 //  AUTHOR: Rob Tillaart
 // PURPOSE: Demo for boiling point formula
 //     URL: https://github.com/RobTillaart/Temperature
-//
 
 
 #include "temperature.h"
@@ -14,6 +13,7 @@ uint32_t stop, start;
 void setup()
 {
   Serial.begin(115200);
+  Serial.println();
   Serial.println(__FILE__);
   Serial.print("TEMPERATURE_LIB_VERSION: ");
   Serial.println(TEMPERATURE_LIB_VERSION);
@@ -49,7 +49,7 @@ void setup()
     Serial.print("\n");
   }
   Serial.println();
-  
+
   for (float temp = 100; temp >= 98; temp -= 0.1)
   {
     Serial.print(temp);
diff --git a/libraries/Temperature/examples/dewpoint_test/dewpoint_test.ino b/libraries/Temperature/examples/dewpoint_test/dewpoint_test.ino
@@ -2,7 +2,7 @@
 //    FILE: dewpoint_test.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: demo
-//    DATE: 2020-04-04
+//     URL: https://github.com/RobTillaart/Temperature
 
 
 #include "temperature.h"
@@ -19,6 +19,7 @@ volatile float dp;
 void setup()
 {
   Serial.begin(115200);
+  Serial.println();
   Serial.println(__FILE__);
   Serial.print("TEMPERATURE_LIB_VERSION: ");
   Serial.println(TEMPERATURE_LIB_VERSION);
diff --git a/libraries/Temperature/examples/discomfortIndex_test/discomfortIndex_test.ino b/libraries/Temperature/examples/discomfortIndex_test/discomfortIndex_test.ino
@@ -0,0 +1,73 @@
+//
+//    FILE: discomfortIndex_test.ino
+//  AUTHOR: Rob Tillaart
+// PURPOSE: demo
+//     URL: https://github.com/RobTillaart/Temperature
+
+
+#include "temperature.h"
+
+void setup()
+{
+  Serial.begin(115200);
+  Serial.println();
+  Serial.println(__FILE__);
+  Serial.print("TEMPERATURE_LIB_VERSION: ");
+  Serial.println(TEMPERATURE_LIB_VERSION);
+  Serial.println();
+
+/*
+  for (int RH = 10; RH < 100; RH += 10)
+  {
+    for (int TC = 10; TC <= 50; TC += 5)
+    {
+      float DI = discomfortIndex(TC, RH);
+      float TT = DI2Celsius(DI, RH);
+
+      Serial.print(RH);
+      Serial.print('\t');
+      Serial.print(TC);
+      Serial.print('\t');
+      Serial.print(DI, 1);
+      Serial.print('\t');
+      Serial.print(TT - TC, 1);
+      Serial.println();
+    }
+    Serial.println();
+  }
+*/
+
+  //  print MATRIX
+  Serial.print("    RH\t");
+  for (int RH = 10; RH < 100; RH += 5)
+  {
+    Serial.print(RH);
+    Serial.print('\t');
+  }
+  Serial.println();
+  Serial.println("TC");
+
+  for (int TC = 10; TC <= 50; TC += 5)
+  {
+    Serial.print(TC);
+    Serial.print('\t');
+    for (int RH = 10; RH < 100; RH += 5)
+    {
+      float DI = discomfortIndex(TC, RH);
+      Serial.print(DI, 1);
+      Serial.print('\t');
+    }
+    Serial.println();
+  }
+  Serial.println();
+
+  Serial.print("\nDone...");
+}
+
+
+void loop()
+{
+}
+
+
+//  -- END OF FILE --
diff --git a/libraries/Temperature/examples/heatindexC_table/heatindexC_table.ino b/libraries/Temperature/examples/heatindexC_table/heatindexC_table.ino
@@ -2,7 +2,7 @@
 //    FILE: heatindexC_table.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: demo
-//    DATE: 2020-04-04
+//     URL: https://github.com/RobTillaart/Temperature
 
 
 #include "temperature.h"
@@ -14,6 +14,7 @@ volatile float hi;
 void setup()
 {
   Serial.begin(115200);
+  Serial.println();
   Serial.println(__FILE__);
   Serial.print("TEMPERATURE_LIB_VERSION: ");
   Serial.println(TEMPERATURE_LIB_VERSION);
diff --git a/libraries/Temperature/examples/heatindexC_test/heatindexC_test.ino b/libraries/Temperature/examples/heatindexC_test/heatindexC_test.ino
@@ -2,7 +2,7 @@
 //    FILE: heatindexC_test.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: demo - test average performance per call in micros.
-//    DATE: 2020-04-04
+//     URL: https://github.com/RobTillaart/Temperature
 
 
 #include "temperature.h"
@@ -17,6 +17,7 @@ volatile float hi;
 void setup()
 {
   Serial.begin(115200);
+  Serial.println();
   Serial.println(__FILE__);
   Serial.print("TEMPERATURE_LIB_VERSION: ");
   Serial.println(TEMPERATURE_LIB_VERSION);
diff --git a/libraries/Temperature/examples/heatindex_table/heatindex_table.ino b/libraries/Temperature/examples/heatindex_table/heatindex_table.ino
@@ -2,7 +2,7 @@
 //    FILE: heatindex_table.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: demo
-//    DATE: 2020-04-04
+//     URL: https://github.com/RobTillaart/Temperature
 
 
 #include "temperature.h"
@@ -14,6 +14,7 @@ volatile float hi;
 void setup()
 {
   Serial.begin(115200);
+  Serial.println();
   Serial.println(__FILE__);
   Serial.print("TEMPERATURE_LIB_VERSION: ");
   Serial.println(TEMPERATURE_LIB_VERSION);
diff --git a/libraries/Temperature/examples/heatindex_test/heatindex_test.ino b/libraries/Temperature/examples/heatindex_test/heatindex_test.ino
@@ -2,7 +2,7 @@
 //    FILE: heatIndex_test.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: demo
-//    DATE: 2020-04-04
+//     URL: https://github.com/RobTillaart/Temperature
 
 
 #include "temperature.h"
@@ -16,6 +16,7 @@ volatile float hi;
 void setup()
 {
   Serial.begin(115200);
+  Serial.println();
   Serial.println(__FILE__);
   Serial.print("TEMPERATURE_LIB_VERSION: ");
   Serial.println(TEMPERATURE_LIB_VERSION);
diff --git a/libraries/Temperature/examples/humidex_table/humidex_table.ino b/libraries/Temperature/examples/humidex_table/humidex_table.ino
@@ -2,7 +2,7 @@
 //    FILE: humidex_table.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: demo
-//    DATE: 2020-04-05
+//     URL: https://github.com/RobTillaart/Temperature
 
 
 #include "temperature.h"
@@ -11,6 +11,7 @@
 void setup()
 {
   Serial.begin(115200);
+  Serial.println();
   Serial.println(__FILE__);
   Serial.print("TEMPERATURE_LIB_VERSION: ");
   Serial.println(TEMPERATURE_LIB_VERSION);
diff --git a/libraries/Temperature/examples/humidex_test/humidex_test.ino b/libraries/Temperature/examples/humidex_test/humidex_test.ino
@@ -2,7 +2,7 @@
 //    FILE: humidex_test.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: demo
-//    DATE: 2020-04-05
+//     URL: https://github.com/RobTillaart/Temperature
 
 
 #include "temperature.h"
@@ -17,6 +17,7 @@ volatile float hi;
 void setup()
 {
   Serial.begin(115200);
+  Serial.println();
   Serial.println(__FILE__);
   Serial.print("TEMPERATURE_LIB_VERSION: ");
   Serial.println(TEMPERATURE_LIB_VERSION);
diff --git a/libraries/Temperature/examples/tempConvertor_test/tempConvertor_test.ino b/libraries/Temperature/examples/tempConvertor_test/tempConvertor_test.ino
@@ -2,7 +2,7 @@
 //    FILE: temperatureConvertor.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: test
-//    DATE: 2022-01-08
+//     URL: https://github.com/RobTillaart/Temperature
 
 
 #include "temperature.h"
@@ -11,8 +11,9 @@ temperatureConverter TC;
 
 void setup()
 {
-  Serial.begin(115200);
   while(!Serial);
+  Serial.begin(115200);
+  Serial.println();
   Serial.println(__FILE__);
   Serial.print("TEMPERATURE_LIB_VERSION: ");
   Serial.println(TEMPERATURE_LIB_VERSION);
diff --git a/libraries/Temperature/examples/windChill_test/windChill_test.ino b/libraries/Temperature/examples/windChill_test/windChill_test.ino
@@ -2,14 +2,15 @@
 //    FILE: windChill_test.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: demo
-//    DATE: 2022-01-09
+//     URL: https://github.com/RobTillaart/Temperature
 
 
 #include "temperature.h"
 
 void setup()
 {
   Serial.begin(115200);
+  Serial.println();
   Serial.println(__FILE__);
   Serial.print("TEMPERATURE_LIB_VERSION: ");
   Serial.println(TEMPERATURE_LIB_VERSION);
@@ -24,7 +25,6 @@ void setup()
   Serial.println(WindChill_F_mph (0, 10, false), 3);
   Serial.println(WindChill_C_kmph(0, 10, false), 3);
   Serial.println(WindChill_C_mps (0, 10, false), 3);
- 
 
   Serial.print("Done...");
 }
diff --git a/libraries/Temperature/keywords.txt b/libraries/Temperature/keywords.txt
@@ -31,6 +31,8 @@ boilingFahrenheit	KEYWORD2
 boilingCelsius	KEYWORD2
 boilingMeter	KEYWORD2
 
+discomfortIndex	KEYWORD2
+DI2Celsius	KEYWORD2
 
 
 # temperatureConverter class
diff --git a/libraries/Temperature/library.json b/libraries/Temperature/library.json
@@ -15,7 +15,7 @@
     "type": "git",
     "url": "https://github.com/RobTillaart/Temperature"
   },
-  "version": "0.3.7",
+  "version": "0.4.0",
   "license": "MIT",
   "frameworks": "*",
   "platforms": "*",
diff --git a/libraries/Temperature/library.properties b/libraries/Temperature/library.properties
@@ -1,5 +1,5 @@
 name=Temperature
-version=0.3.7
+version=0.4.0
 author=Rob Tillaart <rob.tillaart@gmail.com>
 maintainer=Rob Tillaart <rob.tillaart@gmail.com>
 sentence=Library with weather and temperature conversion functions.
diff --git a/libraries/Temperature/readme.md b/libraries/Temperature/readme.md
@@ -31,6 +31,7 @@ Note: pre-0.3.1 versions have incorrect heat-index.
 - https://www.wpc.ncep.noaa.gov/html/heatindex_equation.shtml
 - https://wahiduddin.net/calc/density_algorithms.htm
 - https://github.com/RobTillaart/pressure
+- https://temperatures.com/  just a lot of interesting stuff
 
 
 ## Interface
@@ -131,6 +132,24 @@ For Fahrenheit from meters call:
 F = boilingFahrenheit(meter * 3.2808);  //  * 3.280839895  == / 0.3048
 ```
 
+
+###  Discomfort Index
+
+- **float discomfortIndex(float TC, float RH)**
+- **float DI2Celsius(float DI, float RH)**
+
+
+|  DI (°C)  |  colour  |  description  |
+|:---------:|:--------:|:--------------|
+|    < 21   |  green   |  no discomfort
+|  21..24   |  yellow  |  < 50% people feel D.
+|  24..27   |  orange  |  > 50% people feel D.
+|  27..29   |  red     |  most people feel serious D.
+|  29..32   |  purple  |  severe D.
+|    > 32   |  black   |  extreme D. (emergency)
+
+Colour could be implemented with - https://github.com/RobTillaart/map2colour
+
 ----
 
 # TemperatureConverter class
diff --git a/libraries/Temperature/temperature.cpp b/libraries/Temperature/temperature.cpp
diff --git a/libraries/Temperature/temperature.h b/libraries/Temperature/temperature.h
diff --git a/libraries/Temperature/test/unit_test_001.cpp b/libraries/Temperature/test/unit_test_001.cpp
