HA WeatherSense – Scientifically* Accurate Feels-Like Temp, Comfort Levels & Dynamic Icons

Plug-and-play “feels-like” readings and an instant comfy/not-comfy flag for Home Assistant.
No jargon, just data that works!

Important

Please note: As these are the initial release versions, bugs and errors may occur.

Features

• Calculates perceived temperature using scientifically validated models
• Supports both indoor and outdoor environments
• Takes into account:
  • Temperature
  • Humidity
  • Wind speed (for outdoor)
  • Atmospheric pressure
  • Solar radiation (optional)
  • Time of day
• Provides comfort level assessment with detailed explanations
• Includes comfort status indicator (is_comfortable attribute)
• Dynamic icons that change based on comfort level
• Supports different temperature units (°C/°F)
• Automatic unit conversion for any input sensors
• Easy setup through the UI

Installation

HACS (Recommended)

1. Make sure HACS is installed in your Home Assistant instance
2. Add this repository as a custom repository in HACS:
   • Go to HACS → Integrations → ⋮ (menu) → Custom repositories
   • Add https://github.com/smkrv/ha-weathersense as a repository
   • Select "Integration" as the category
3. Click "Install" on the HA WeatherSense integration
4. Restart Home Assistant

Manual Installation

1. Download the latest release from the GitHub repository
2. Extract the weathersense folder from the custom_components directory
3. Copy the folder to your Home Assistant's custom_components directory
4. Restart Home Assistant

Configuration

1. Go to Settings → Devices & Services
2. Click "Add Integration" and search for "HA WeatherSense"
3. Follow the configuration steps:
   • Enter a name for your sensor
   • Select a temperature sensor
   • Select a humidity sensor
   • Optionally select wind speed sensor
   • Optionally select pressure sensor
   • Optionally select solar radiation sensor
   • Specify if the sensor is for outdoor or indoor use
   • Optionally select your preferred temperature display unit

You can add multiple instances of the integration for different locations (e.g., living room, bedroom, outside).

Sensor Attributes

The integration provides the following attributes:

Attribute	Description
comfort_level	Current comfort level code
comfort_description	Short description of the comfort level
comfort_explanation	Detailed explanation of the comfort level
calculation_method	Method used for calculation (Heat Index, Wind Chill, etc.)
temperature	Source temperature value (in °C)
humidity	Source humidity value (%)
wind_speed	Source wind speed value (in m/s) if available
pressure	Source pressure value (in kPa) if available
is_outdoor	Whether this is an outdoor or indoor sensor
time_of_day	Current time when calculation was performed
is_comfortable	Boolean indicating if current conditions are comfortable

Dynamic Icons

The sensor's icon changes automatically based on the current comfort level:

Comfort Level	Icon
extreme_cold	mdi:snowflake-alert
very_cold	mdi:snowflake
cold	mdi:weather-snowy
cool	mdi:thermometer-low
slightly_cool	mdi:thermometer-minus
comfortable	mdi:hand-okay
slightly_warm	mdi:thermometer-plus
warm	mdi:thermometer-high
hot	mdi:weather-sunny
very_hot	mdi:weather-sunny-alert
extreme_hot	mdi:fire-alert

How It Works

HA WeatherSense uses different calculation methods depending on the environment and temperature range:

Outdoor Calculations

• Heat Index: Used when temperature is ≥ 27°C and humidity ≥ 40%
• Wind Chill: Used when temperature is ≤ 10°C and wind speed > 1.34 m/s
• Steadman Apparent Temperature: Used for all other conditions

Additional corrections are applied for:

• Time of day (solar radiation effect)
• Atmospheric pressure variations
• Solar radiation (if sensor provided)

Indoor Calculations

For indoor environments, a simplified thermal comfort model is used that primarily considers temperature and humidity interactions.

Comfort Levels

The integration provides a comfort assessment with the following levels:

Level	Description	Explanation
extreme_cold	Extreme Cold Stress	Extreme risk: frostbite possible in less than 5 minutes
very_cold	Very Strong Cold Stress	High risk: frostbite possible in 5-10 minutes
cold	Strong Cold Stress	Warning: frostbite possible in 10-30 minutes
cool	Moderate Cold Stress	Caution: prolonged exposure may cause discomfort
slightly_cool	Slight Cold Stress	Slightly cool: light discomfort for sensitive individuals
comfortable	No Thermal Stress	Optimal thermal conditions: most people feel comfortable
slightly_warm	Slight Heat Stress	Slightly warm: light discomfort for sensitive individuals
warm	Moderate Heat Stress	Caution: fatigue possible with prolonged exposure
hot	Strong Heat Stress	Extreme caution: heat exhaustion possible
very_hot	Very Strong Heat Stress	Danger: heat cramps and exhaustion likely
extreme_hot	Extreme Heat Stress	Extreme danger: heat stroke imminent

Example Automations

Adjust HVAC based on feels-like temperature

automation:
  - alias: "Adjust HVAC based on feels-like temperature"
    trigger:
      - platform: state
        entity_id: sensor.feels_like_temperature
    condition:
      - condition: numeric_state
        entity_id: sensor.feels_like_temperature
        above: 26
    action:
      - service: climate.set_temperature
        target:
          entity_id: climate.living_room
        data:
          temperature: 23

Send notification when conditions become uncomfortable

automation:
  - alias: "Notify when outdoor conditions become uncomfortable"
    trigger:
      - platform: state
        entity_id: sensor.outdoor_feels_like
        attribute: is_comfortable
        from: "true"
        to: "false"
    action:
      - service: notify.mobile_app
        data:
          title: "Weather Alert"
          message: >
            Outdoor conditions are now {{ state_attr('sensor.outdoor_feels_like', 'comfort_description') | lower }}.
            Feels like {{ states('sensor.outdoor_feels_like') }}°.
            {{ state_attr('sensor.outdoor_feels_like', 'comfort_explanation') }}

Display comfort level in dashboard

type: entities
entities:
  - entity: sensor.feels_like_temperature
    secondary_info: last-changed
    name: Feels Like Temperature
    icon: mdi:thermometer
    tap_action:
      action: more-info
    footer:
      type: text
      content: "{{ state_attr('sensor.feels_like_temperature', 'comfort_description') }}"

Scientific Background

The calculations used in HA WeatherSense are based on peer-reviewed scientific models and official standards used by meteorological organizations worldwide:

Heat Index

The Heat Index formula is the official algorithm used by the US National Weather Service (NWS), developed by Rothfusz (1990) and refined by the NWS. It has been validated through extensive physiological studies measuring human heat stress responses.

Wind Chill Temperature

The Wind Chill model implemented is the standard adopted jointly by Environment Canada and the US National Weather Service in 2001, based on research by Osczevski and Bluestein (2005). It was developed using human trials that measured facial heat loss in wind tunnel tests.

Steadman Apparent Temperature

For moderate temperatures, we use Steadman's (1994) Apparent Temperature model, which has been adopted by the Australian Bureau of Meteorology and other international weather services. It accounts for both humidity and wind effects in a unified equation.

Indoor Comfort Model

The indoor comfort assessment is based on principles from ISO 7730:2005 (Ergonomics of the thermal environment) and ASHRAE Standard 55-2020, which define internationally recognized thermal comfort standards.

References

1. Steadman, R.G. (1994). "Norms of apparent temperature in Australia." Australian Meteorological Magazine, 43, 1-16.
2. Rothfusz, L.P. (1990). "The heat index equation." National Weather Service Technical Attachment (SR 90-23).
3. Osczevski, R., & Bluestein, M. (2005). "The new wind chill equivalent temperature chart." Bulletin of the American Meteorological Society, 86(10), 1453-1458.
4. ISO 7730:2005. "Ergonomics of the thermal environment."
5. ASHRAE Standard 55-2020. "Thermal Environmental Conditions for Human Occupancy."

These models are used daily by meteorological services worldwide to provide accurate "feels like" temperatures to the public, making HA WeatherSense's calculations reliable for both comfort assessment and safety warnings.

Roadmap

Future improvements planned for this integration:

• Support for additional languages
• More advanced indoor comfort models (PMV/PPD)
• Integration with weather forecasts for predictive comfort
• Custom comfort thresholds configuration
• Dashboard card with visual comfort indicators
• Support for UV index in comfort calculations
• Improved solar radiation modeling

Troubleshooting

Common Issues

1. Unrealistic temperature values: If you see extremely high or low feels-like temperatures, check that your input sensors are providing reasonable values and have the correct units.

2. Incorrect comfort level: The comfort level is determined based on the calculated feels-like temperature. If it seems incorrect, verify that the outdoor/indoor setting matches your sensor's actual location.

3. Sensor shows "unavailable": Ensure all required source sensors are available and providing valid readings.

Debug Logging

To enable debug logs for troubleshooting:

1. Add the following to your configuration.yaml:

   logger:
     default: info
     logs:
       custom_components.weathersense: debug

2. Restart Home Assistant
3. Check the logs for detailed information about calculations and conversions

Legal Disclaimer and Limitation of Liability

Software Disclaimer

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

📝 License

Author: SMKRV CC BY-NC-SA 4.0 - see LICENSE for details.

---

💡 Support the Project

The best support is:

• Sharing feedback
• Contributing ideas
• Recommending to friends
• Reporting issues
• Star the repository

If you want to say thanks financially, you can send a small token of appreciation in USDT:

USDT Wallet (TRC10/TRC20): TXC9zYHYPfWUGi4Sv4R1ctTBGScXXQk5HZ

Open-source is built by community passion! 🚀

---

Made with ❤️ for the Home Assistant Community

Report Bug · Request Feature