HaVpdChart for Home Assistant

HaVpdChart is a custom card component for Home Assistant that allows for visual representations of VPD (Vapour Pressure Deficit) based on temperature and humidity sensors. It's ideal for monitoring environmental conditions in tents or rooms.

Prerequisites

Home Assistant installation
Basic knowledge of YAML and Home Assistant configuration

Installation

HACS Easy Installation

Currently not available - still wait for accept pull request

HACS Installation

If you have HACS installed, you can add this repository to HACS as a custom repository. Otherwise you can easily install it

sudo docker exec -it [dockername] bash
wget -O - https://get.hacs.xyz | bash -

Add Repository

Click HACS -> Three Dot Menu upper right -> Custom Repository -> Category: Lovelace | Repositury Url: https://github.com/mentalilll/ha-vpd-chart
Install Plugin

Search for VPD within Integrations and install ha-vpd-chart

From GitHub

Clone the repository

Clone the repository to your local machine
Incorporate the file into Home Assistant Docker
1. Navigate to the directory that is mapped to /config in your Docker setup.
2. Create 2 new directory's named www/community/ha-vpd-chart/ within /config folder.
3. Copy the contents of the dist directory from the repository into the <config>/www/community/ha-vpd-chart/ directory.
Add the resource in Home Assistant

Add the resource through the Home Assistant UI under Configuration -> Lovelace Dashboards -> Resource\

If you don't have the menu than go to http://<your_homeassistant_instance:8123>/config/lovelace/resources
and add the following:

url: /local/community/ha-vpd-chart/ha-vpd-chart.js
type: module

Note: After adding the resource, you may need to restart Home Assistant.

Usage

Easy start as Chart View:

type: custom:ha-vpd-chart
sensors:
  - temperature: sensor.temperature_2
    humidity: sensor.humidity_2
    name: Tent 1
  - temperature: sensor.temperature_tent_2
    humidity: sensor.humidity_tent_2
    name: Tent 2

Easy start as Bar View:

type: custom:ha-vpd-chart
is_bar_view: true
sensors:
  - temperature: sensor.temperature_2
    humidity: sensor.humidity_2
    name: Tent 1
  - temperature: sensor.temperature_tent_2
    humidity: sensor.humidity_tent_2
    name: Tent 2

To use the HaVpdChart in your Lovelace dashboard, add the following configuration to your dashboard. Adjust the sensors and other options according to your setup:

type: custom:ha-vpd-chart
air_text: Temp. #optional "" for Empty
rh_text: r.H. #optional "" for Empty
min_temperature: 5 #optional
max_temperature: 35 #optional
min_humidity: 10 #optional
max_humidity: 100 #optional
min_height: 200 #optional (minimum height of the chart as px)
is_bar_view: false #optional
enable_tooltip: true #optional
enable_axes: true #optional
enable_ghostmap: true #optional
enable_triangle: true #optional
enable_crosshair: true #optional
enable_fahrenheit: false #optional
enable_zoom: true #optional
enable_show_always_informations: true #optional
enable_legend: true #optional
leaf_temperature_offset: 2 || input_number.leaf_offset_example #optional
sensors:
  - temperature: sensor.temperature_2
    humidity: sensor.humidity_2
    leaf_temperature: sensor.infrared_sensor #optional
    name: Tent 1
  - temperature: sensor.temperature_tent_2
    humidity: sensor.humidity_tent_2
    name: Tent 2
vpd_phases: #optional
  - upper: 0.0
    className: gray-danger-zone
    color: #999999
  - lower: 0.0
    upper: 0.4
    className: under-transpiration
    color: #0000FF
  - lower: 0.4
    upper: 0.8
    className: early-veg
  - lower: 0.8
    upper: 1.2
    className: late-veg
  - lower: 1.2
    upper: 1.6
    className: mid-late-flower
  - lower: 1.6
    className: danger-zone
calculateVPD: |2-
          const VPleaf = 610.7 * Math.exp(17.27 * Tleaf / (Tleaf + 237.3)) / 1000; 
          const VPair = 610.7 * Math.exp(17.27 * Tair / (Tair + 237.3)) / 1000 * RH / 100;
          return VPleaf - VPair;

Configuration Parameters

Name	Type	Required	Default	Description
type	string	required		Must be `custom:ha-vpd-chart`.
air_text	string	optional	`Air`	The text used for temperature readings. Default is "Air".
rh_text	string	optional	`RH`	The text used for humidity readings. Default is "RH".
kpa_text	string	optional	`kPa`	The text used for kPa readings. Default is "kPa".
min_temperature	number	optional	`5`	Minimum temperature in the chart. Default is 5.
min_humidity	number	optional	`10`	Minimum humidity in the chart. Default is 10.
max_temperature	number	optional	`35`	Maximum temperature in the chart. Default is 35.
max_humidity	number	optional	`90`	Maximum humidity in the chart. Default is 90.
min_height	number	optional	`200`	Minimum height of the chart as px. Default is 200.
leaf_temperature_offset	number\|string	optional	`2`\|`input_number.leaf_offset_example`	Sets the Temperature Offset of the Leaf
sensors	list	required		A list of sensors with their temperature and humidity entity IDs, and an optional name for display.
vpd_phases	list	optional	See description	A list of VPD phases and their classes for visual representation. See below for defaults.
enable_tooltip	boolean	optional	`true`	Tooltip enabled by default.
is_bar_view	boolean	optional	`true`	Enable Bar view of this chart for fast information of sensors
enable_axes	boolean	optional	`true`	Enable Axes on the Chart
enable_ghostmap	boolean	optional	`true`	Enable Ghostmap on the Chart
enable_triangle	boolean	optional	`true`	Enable Triangle instead of Circle for tooltip marker
enable_crosshair	boolean	optional	`true`	Enable MouseHover Crosshair
enable_fahrenheit	boolean	optional	`false`	Enable Fahrenheit instead of Celsius
enable_zoom	boolean	optional	`true`	Enable zoom function for chart
enable_show_always_informations	boolean	optional	`true`	Enable show always tooltip informations for chart
enable_legend	boolean	optional	`true`	Enable Legend function for chart
calculateVPD	string	optional	See description	Custom function to calculate VPD.

Default vpd_phases Configuration:

under-transpiration: VPD < 0.4
early-veg: 0.4 ≤ VPD < 0.8
late-veg: 0.8 ≤ VPD < 1.2
mid-late-flower: 1.2 ≤ VPD < 1.6
danger-zone: VPD ≥ 1.6

mentalilll/ha-vpd-chart