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

1. 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 -

1. Add Repository

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

2. Install Plugin

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

From GitHub

1. Clone the repository

   Clone the repository to your local machine

2. 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.

3. 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