Français

Psychrometric Chart Advanced — Home Assistant card

Interactive psychrometric chart for Home Assistant: thermal comfort, dew point, enthalpy and the power needed to reach comfort.

Available on HACSClimate & comfortVersion v1.7.2★ 17 starsMinimum Home Assistant 2024.1.0

Open in HACS · Code on GitHub

Psychrometric Chart Advanced preview

Overview

This project provides a custom card for Home Assistant, allowing you to visualize a psychrometric chart based on temperature and humidity data from sensors. The card also calculates key values such as enthalpy, water content, and dew point. It indicates whether actions are needed to heat, cool, humidify, or dehumidify, while estimating the power required to reach the comfort zone.

Features

  • Advanced Visualization
  • Data History
  • Enhanced User Interface
  • Customizable Comfort Zone
  • Scientific Calculations Displayed
  • Advanced Chart Options
  • Multilingual
  • Zoom and Navigation

Installation

  1. In Home Assistant, open HACS (“Open in HACS” button above), add the guiohm79/psychrometric-chart-advanced repository if asked, then install “Psychrometric Chart Advanced” and reload your browser.
  2. Without HACS: download psychrometric-chart-advanced.js from the latest GitHub release, copy it to config/www/, then add the resource /local/psychrometric-chart-advanced.js (type “JavaScript module”) in Settings → Dashboards → Resources.

Configuration

type: 'custom:psychrometric-chart-advanced'

chartTitle: 'Psychrometric Chart'
points:
  - temp: sensor.room_temperature
    humidity: sensor.room_humidity
    color: "#ff0000"
    label: Master Bedroom
    icon: mdi:bed

Options

OptionTypeDefaultDescription
type (required)stringMust be custom:psychrometric-chart-enhanced
languagestringfrInterface language: en (English), fr (French), es (Spanish), or de (German)
points (required)listList of sensor points to display
points[].temp (required)stringTemperature sensor entity ID
points[].humidity (required)stringHumidity sensor entity ID
points[].colorstringRandomPoint color (hex format)
points[].labelstringPoint label
points[].iconstringmdi:homeMDI icon
bgColorstringThemeBackground color
textColorstringThemeText color
gridColorstringThemeGrid color
curveColorstringThemeHumidity curves color
bgOpacity / textOpacity / gridOpacity / curveOpacity / enthalpyOpacity / comfortOpacitynumberOpacity (0-100) for the matching Color option, set independently of the color itself. Adjusting opacity never overwrites the color, so it doesn't break light/dark theme switching
gridLineStylestringdashedGrid line style: solid, dashed, dotted, or dashdot
curveLineStylestringsolidHumidity curves line style
enthalpyLineStylestringdottedEnthalpy lines style
wetBulbLineStylestringdottedWet bulb lines style
comfortLineStylestringsolidComfort zone outline style
pointLineStylestringdashedPoint halo outline style
tempSubdivisionsnumber1Minor gridlines drawn between two temperature ticks (1-10). 1 means no intermediate line
showChartbooleantrueShow the psychrometric diagram. Set to false to keep only the calculated data cards (useful to stack several compact cards, one per room)
chartHeightnumberChart height in pixels. Left empty, the chart follows the space the card is given; a value pins it, and only a card too short to hold it still compresses it
chartAspectRationumber1.33Width/height ratio used when no height is imposed (1.33 = 4:3, 2 = twice as wide as tall)
themestringmodernData-card style: modern, classic (flat), compact (dense), or mono (technical readout: big temperature, monospace values right-aligned in two columns)
chartModestring2dChart projection: 2d (classic flat chart) or 3d (perspective scene — drag to rotate, wheel or two-finger pinch to zoom towards the pointer, two-finger drag to pan, plus 3D / top-view buttons that reset the camera)
heightMetricstringpmv3D only. What a sensor's height represents: pmv (rises with the distance from comfort, hot and cold), enthalpy, or flat (no height)
show3dPlanebooleanfalse3D only. Draw the grey base plane and its frame under the scene. Left off, the diagram floats on the card background
showCalculatedDatabooleantrueShow calculated data cards
comfortRangeobjectComfort zone configuration
comfortRange.tempMinnumber18Minimum comfort temperature (°C)
comfortRange.tempMaxnumber22Maximum comfort temperature (°C)
comfortRange.rhMinnumber40Minimum comfort relative humidity (%)
comfortRange.rhMaxnumber60Maximum comfort relative humidity (%)
comfortColorstringThemeComfort zone color
enthalpyColorstringThemeEnthalpy lines color
massFlowRatenumber0.5Mass flow rate (kg/s) for power calculations
chartTitlestringPsychrometric ChartChart title
themeModestringautoColour theme: auto (follows the Home Assistant light/dark theme), light, or dark
displayModestringcustomDetail level: minimal, custom (applies each point's details), or detailed
showEnthalpybooleanfalseShow enthalpy curves
showVaporPressurebooleantrueShow vapor pressure vertical grid lines (kPa)
showLegendbooleantrueShow legend
showPointLabelsbooleantrueShow point labels on chart
zoom_temp_minnumbernullMinimum temperature to display (°C) - enables auto zoom
zoom_temp_maxnumbernullMaximum temperature to display (°C) - must be > zoom_temp_min
zoom_humidity_minnumbernullMinimum humidity to display (%) - optional vertical centering
zoom_humidity_maxnumbernullMaximum humidity to display (%) - must be > zoom_humidity_min

FAQ

What is a psychrometric chart?

It is a chart that relates air temperature and humidity. It shows at a glance whether a room is in the comfort zone, its dew point, enthalpy and water content. The card places each of your sensors on it and tells whether to heat, cool, humidify or dehumidify.

Which sensors do I need?

One temperature sensor and one humidity sensor per point (points[].temp and points[].humidity). Several rooms can be shown on the same chart.

How do I install the card?

In HACS, Dashboard section, search for “Psychrometric Chart”, install it, then reload your browser. The “Open in HACS” button on this page takes you straight there.

Which languages does the card support?

English, French, Spanish and German, with the language option.

More cards