Skip to content

A card to display the Heat Index and Discomfort Index (aka Thom Index)

License

Notifications You must be signed in to change notification settings

n0is3r/comfortable-environment-card

 
 

Repository files navigation

Comfortable Environment Card

A card to display the Heat Index and Discomfort Index (aka Thom Index)

The Heat Index (HI) combines temperature and humidity to give an equivalent temperature a body can perceive. The Discomfort Index (DI), is a value representing the sensation of comfort (or discomfort) you'll experiencing.

While the HI is useful if you're planning some activities that requires hard work (and probably leads to sweat), the DI tells you in realtime if the amount of humidity and the temperature is ok for your comfortable enviroment, since even if the temperature seems to be ok, you could feel hot, too hot, cold, etc. depending on the humidity.

GitHub Release License hacs_badge

Project Maintenance GitHub Activity

Options

Name Type Requirement Description Default
type string Required custom:comfortable-environment-card
room_name string Optional Room name at top of the card ""
temperature_sensor string Required Any "sensor" entity reporting temperature
humidity_sensor string Required Any "sensor" entity reporting humidity
display_precision number Required Numbers of decimals to show 1
show_index string Required Choose index to show (ALL, HI, DI) ALL

Screenshot

card_screenshot

Known Issues

The card editor has a filter to let user choose temperature and humidity sensors only, all other entities from HA are excluded from the selection Unfortunately if you have a sensor based on Min/Max Helper (aka "Combine the state of..."), you won't find it in the dropdown because it lacks the correct device_class attribute (see here and here)

Don't worry! There are (at least) three workarounds:

  • Use a Group Helper instead, the result will be the same (you can group temp/hum sensors and calc the mean/median value as in Min/Max)

  • While you're in card editing mode, press on "SHOW CODE EDITOR" and write the

    • temperature_sensor: sensor.my_temp_sensor

    or

    • humidity_sensor: sensor.my_hum_sensor

    value by hand, you should see the card renders as soon as you write the sensor name

  • Go in the HA Developer Tools from the sidebar, then choose "States" and search for your Min/Max sensor click on it and in the "State attribute" area, add the property

    • device_class: temperature

    or

    • device_class: humidity

    then press Set State, this attribute is valid only until the next restart but you need it just once in order to configure the card

Credits

Calcs are based on research and (mostly) from National Weather Service (https://www.wpc.ncep.noaa.gov/html/heatindex_equation.shtml) The temperature bar idea was inspired by @madmicio 's ph-meter-temperature card (https://github.com/madmicio/ph-meter-temperature)

Translations

Thanks to the people listed below, this card is available in the following languages:

About

A card to display the Heat Index and Discomfort Index (aka Thom Index)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 74.9%
  • JavaScript 25.1%