Psychrometric Chart Advanced — Home Assistant card
Interactive psychrometric chart for Home Assistant: thermal comfort, dew point, enthalpy and the power needed to reach comfort.
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
- 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.
- 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
| Option | Type | Default | Description |
|---|---|---|---|
type (required) | string | Must be custom:psychrometric-chart-enhanced | |
language | string | fr | Interface language: en (English), fr (French), es (Spanish), or de (German) |
points (required) | list | List of sensor points to display | |
points[].temp (required) | string | Temperature sensor entity ID | |
points[].humidity (required) | string | Humidity sensor entity ID | |
points[].color | string | Random | Point color (hex format) |
points[].label | string | Point label | |
points[].icon | string | mdi:home | MDI icon |
bgColor | string | Theme | Background color |
textColor | string | Theme | Text color |
gridColor | string | Theme | Grid color |
curveColor | string | Theme | Humidity curves color |
bgOpacity / textOpacity / gridOpacity / curveOpacity / enthalpyOpacity / comfortOpacity | number | Opacity (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 | |
gridLineStyle | string | dashed | Grid line style: solid, dashed, dotted, or dashdot |
curveLineStyle | string | solid | Humidity curves line style |
enthalpyLineStyle | string | dotted | Enthalpy lines style |
wetBulbLineStyle | string | dotted | Wet bulb lines style |
comfortLineStyle | string | solid | Comfort zone outline style |
pointLineStyle | string | dashed | Point halo outline style |
tempSubdivisions | number | 1 | Minor gridlines drawn between two temperature ticks (1-10). 1 means no intermediate line |
showChart | boolean | true | Show the psychrometric diagram. Set to false to keep only the calculated data cards (useful to stack several compact cards, one per room) |
chartHeight | number | Chart 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 | |
chartAspectRatio | number | 1.33 | Width/height ratio used when no height is imposed (1.33 = 4:3, 2 = twice as wide as tall) |
theme | string | modern | Data-card style: modern, classic (flat), compact (dense), or mono (technical readout: big temperature, monospace values right-aligned in two columns) |
chartMode | string | 2d | Chart 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) |
heightMetric | string | pmv | 3D only. What a sensor's height represents: pmv (rises with the distance from comfort, hot and cold), enthalpy, or flat (no height) |
show3dPlane | boolean | false | 3D only. Draw the grey base plane and its frame under the scene. Left off, the diagram floats on the card background |
showCalculatedData | boolean | true | Show calculated data cards |
comfortRange | object | Comfort zone configuration | |
comfortRange.tempMin | number | 18 | Minimum comfort temperature (°C) |
comfortRange.tempMax | number | 22 | Maximum comfort temperature (°C) |
comfortRange.rhMin | number | 40 | Minimum comfort relative humidity (%) |
comfortRange.rhMax | number | 60 | Maximum comfort relative humidity (%) |
comfortColor | string | Theme | Comfort zone color |
enthalpyColor | string | Theme | Enthalpy lines color |
massFlowRate | number | 0.5 | Mass flow rate (kg/s) for power calculations |
chartTitle | string | Psychrometric Chart | Chart title |
themeMode | string | auto | Colour theme: auto (follows the Home Assistant light/dark theme), light, or dark |
displayMode | string | custom | Detail level: minimal, custom (applies each point's details), or detailed |
showEnthalpy | boolean | false | Show enthalpy curves |
showVaporPressure | boolean | true | Show vapor pressure vertical grid lines (kPa) |
showLegend | boolean | true | Show legend |
showPointLabels | boolean | true | Show point labels on chart |
zoom_temp_min | number | null | Minimum temperature to display (°C) - enables auto zoom |
zoom_temp_max | number | null | Maximum temperature to display (°C) - must be > zoom_temp_min |
zoom_humidity_min | number | null | Minimum humidity to display (%) - optional vertical centering |
zoom_humidity_max | number | null | Maximum 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.