Plugins 〉Psychart
Psychart
Psychart v4.3.0
A Psychrometric Chart for Monitoring Data Center Health & Human Comfort
View air conditions on a psychrometric chart.
What is a psychrometric chart?
Psychrometric charts are charts adopted by ASHRAE that plot various thermodynamic properties of air-vapor mixtures. These charts are particularly useful in HVAC applications. The following properties describe what's called a state of air. Two properties are needed to fix the state of air, which means that two properties are needed in order to calculate every other property. The following 4 properties are plotted by Psychart by default:
- Dry Bulb
- The temperature of air using a dry thermometer.
- Wet Bulb
- Wet bulb temperature can be practically explained by the temperature of a surface where water is evaporating.
- Dew Point
- Water will condense from the air at or below this temperature.
- Relative Humidity
- A ratio of vapor pressure in the air to the saturation vapor pressure. 0%rh indicates absolutely dry air, and 100%rh indicates saturated air.
Psychart also has the capability to derive the following state variables, which are optionally displayed using the Show Advanced State Variables switch in Display options.
- Vapor Pressure
- The partial pressure of water in the vapor-air mixture.
- Humidity Ratio
- Weight of water vapor per weight of dry air.
- Enthalpy
- In thermodynamics, refers to the total heat content of the vapor-air mixture.
- Specific Volume
- Amount of volume taken up by one unit of mass of the vapor-air mixture.
Getting started
This section will go over the options in the panel editor.
Panel options
This is the default panel options for all Grafana panels which gives the user access to the panel title and description and other UI effects.
Chart options
These options affect how the chart itself is displayed.
Allows the user to select whether measurements are being reported in US or SI units, the local altitude, graph bounds, flip X & Y, and optionally display ASHRAE comfort regions (envelopes). For data center envelopes, these comfort regions follow the 2021 ASHRAE standard and are designed for data centers and IT spaces of various criticality. For human comfort envelopes, these comfort regions follow the ASHRAE-55 guidelines published in 2017. These human comfort envelopes are a function of metabolic rate (MET, which is dependent on the indoor activity), clothing level (CLO), and air speed. In both cases, the envelopes show the target region for conditioned air supplied into the indoor space.
Data options
These options help process the incoming data.
Psychart is capable of plotting several data series of states per panel. The amount of data series is defined by the series count. Due to the fact that 2 properties are needed to fix the state, at least two numeric time-dependent fields are required. The user must select whether those two fields are dry bulb and wet bulb, dry bulb and dew point, or dry bulb and relative humidity. These fields must then be entered into the field selectors below respectively.
It is important to note that one or two queries may be necessary depending on the data structure. One single query may be sufficient to return the two fields needed to fix the state. Other times, one query will be needed to obtain the dry bulb field and another for relative humidity field, for example.
Different data series are independent from one another - one series may incorporate dry bulb and wet bulb measurements, and another may incorporate dry bulb and dew point measurements, for instance.
Series display options
This section configures each individual data series.
First, a legend must be set. This will name your data series as well as add a label when hovering the cursor over the plotted data. Then, select the 2 data series which represent the 2 psychrometric measurements.
The rest of the options change the visual appearance of data within the chart. This allows the user to change the point radius, optionally draw a line between adjacent points in time, and select a color gradient for the data series. Gradients always use the more saturated/contrasting colors for the more recent data points, regardless of which theme (light/dark) is preferred. The user can also optionally select to view more state variables here.
Errors & Troubleshooting
Some errors can arise from the Data options section due to the fact that wet bulb and dew point must be less than or equal to the dry bulb temperature and relative humidity must be within the range of 0-1. If relative humidity is a driving measurement, make sure that the measurement type is correct (0-1 or 0%-100%). For other measurements, make sure that they are being reported correctly.
Psychart matches up values with similar timestamps. For a dry bulb & relative humidity series, the dry bulb measurement timestamp must match that of the relative humidity timestamp in order to be recognized as a single point. The Query options in the query inspector may provide the tools required to fix any time discrepancies.
Importantly, if there is missing data in one field, for example if dry bulb temperature has not been reporting for the last 5 minutes, no new states are calculated, and no new data is plotted in Psychart for the last 5 minutes to avoid the display of inaccurate data.
Psychart works best both visually and practically when observing a narrow span of time. If Psychart is loading very slowly, try to decrease the Time range in Grafana. Both absolute and relative time spans are accepted by Psychart. If the data still seems too cluttered, try disabling the line that connects the series, reducing the point radius, or reducing the amount of data series rendered on a single panel.
Finally, if there are issues after upgrading to a newer version of Psychart, (for example the regions are not being rendered) try to open the panel editor, reapply your customization settings, and save the panel. Sometimes, the panel options are not properly stored from version to version.
License
Psychart was created by Nicolas Ventura, owned by Berkeley Lab, a DOE funded national laboratory, and is distributed under the BSD-3-Clause-LBNL license.
| Plugin ID | Last Updated | Version |
|---|---|---|
ventura-psychrometric-panel | 2024-04-17 | 4.3.0 |
Screenshots
Basic HVAC use case: Air handler supply conditions for a data center
Outdoor weather conditions use case
Using Psychart with SI units
HVAC design use case: Using Psychart as a psychrometric calculator
An example of the standard panel editor for Psychart
Multiple data series on the same chart
Psychart can handle a lot of data at once
Usage of Psychart to render a Mollier Diagram
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Installing Psychart on Grafana Cloud:
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
For more information, visit the docs on plugin installation.
Installing on a local Grafana:
For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.
1. Install the Panel
Use the grafana-cli tool to install Psychart from the commandline:
grafana-cli plugins install The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.
Alternatively, you can manually download the .zip file for your architecture below and unpack it into your grafana plugins directory.
Alternatively, you can manually download the .zip file and unpack it into your grafana plugins directory.
2. Add the Panel to a Dashboard
Installed panels are available immediately in the Dashboards section in your Grafana main menu, and can be added like any other core panel in Grafana.
To see a list of installed panels, click the Plugins item in the main menu. Both core panels and installed panels will appear.
Changelog
4.3.0
- Update to the latest version of
@grafana/create-plugin(4.6.2)- Grafana version required:
>=10.3.3 - Compatibility check workflow is now fixed!
- Grafana version required:
- Update dependency versions of
smath(1.8.5) andviridis(1.1.4) - Support the ability to render Mollier Diagrams by mirroring Psychart on the
x=yline (thanks for the idea, @yevgeny7!) - Improve panel interior padding by splitting it into
xandyvalues instead of using a single value - Add placeholders in all panel option fields (shown when field is empty)
- Min/max values for
dbMaxanddpMaxoptions are now dynamically calculated so thatdbMaxmust be strictly greater than or equal todpMax - Improve code quality by...
- Changing
lettoconst - Adding
readonlymodifiers where possible - Adding explicit access modifiers (by default, TypeScript sets all class members
publicif not specified)
- Changing
- Minor Webpack configuration simplifications (standalone app)
- Fix bug where relative humidity was displayed from 0-1 instead of 0-100%
4.2.2
- Bug fix where region shading gradient was not reversed for light theme
- Updates to standalone app
- Add option for rendering IBM TS4500 ambient envelopes
- Use
script deferand remove window load event listener
4.2.1
- Update dependency versions
- Clean script can now remove backups
- Minor cleanups within
Psychartclass
4.2.0
- Add LBL/DOE notice in README
- Replace custom
JMathwithsmathdependency for linear interpolation functions - Replace custom
Colorwithviridisdependency for color gradient functions- Allow all default/builtin gradients from this package, adds >10 new gradients to Psychart!
- Use "Purplish" palette for region shading
- Default series names are numbered instead of lettered
- Maximum of 100 data series rendered on Psychart
- Remove
defaultexports over preference to named exports (undo change from 4.0.1) - Region shading is now affected by your Grafana theme for better contrast
- Add IBM TS4500 ambient condition envelopes
4.1.0
- Update to the latest version of
@grafana/create-plugin(4.0.1) - Add link to issues in main README page and plugin page
- Minor updates to runner update command (select non-hidden files only)
- Correctly set the license type in package.json (thank you, @nagisa!) #10 and README
- Add extra stats towards the bottom of the plugin README
- Remove duplicate images in build output
4.0.6
- Update to the latest version of
@grafana/create-plugin(3.5.0)- Updates workflow action dependency versions, thanks to my pull request!
- Update dashboard provisioning configuration
- Datasource is random 30Hz data stream
- Add
-Uflag in runner that will automatically re-build with latest version of@grafana/create-plugin
4.0.5
- Update to the latest version of
@grafana/create-plugin(3.1.3)
4.0.4
- Update to the latest version of
@grafana/create-plugin(2.11.1)
4.0.3
- Update to the latest version of
@grafana/create-plugin(2.10.1)- Use
grafana/plugin-actions/build-pluginaction
- Use
- Add popularity badge in plugin README
4.0.2
- Add banner image in GitHub repository
- Update to the latest version of
@grafana/create-plugin(2.8.0)- Except for
grafana/plugin-actions/build-pluginaction - Add dashboard provisioning
- Except for
- Major updates to runner file
- Check options using
getopts - Redesign logic/error messages for plugin validation and publishing
- Check options using
4.0.1
- Make exports default where possible
- Reverse gradients for light theme
- The most saturated colors are the more recent data points, regardless of which theme
- Fix bug where normalized values would return a value outside of
[0, 1]whenmin = max - Minor improvements in region colorizing
- Updated some screenshots in
README- Showing the panel editor options
- Example with multiple data series
- Standalone app only published on version releases
4.0.0
- Psychart now has the ability to render multiple data series
- Options are shown as nested options under
Data optionsin the panel editor - Can now be labeled, and Psychart will show the series label in the hover text
- Supports different styles for different series
- Series count limit: 104 (send me an email if you would like this increased)
- Options are shown as nested options under
- Psychart will only attempt to plot data if the data series name is a valid option
- Panel editor options are now automatically validated
- Deprecated options are now deleted from dashboard settings
- Reference files with relative paths without the
./ - Data points now just store dry bulb +
othervalue + measurement type, whereotheris either wet bulb, dew point, or relative humidity, depending on the measurement type - Add version number in
README.md - Update to the latest version of
@grafana/create-plugin(2.6.0)- Node version upgraded to
v20
- Node version upgraded to
- Gradient icons are now automatically generated based on gradient definitions
- Gradient icons are now shown in standalone app when setting up Psychart
- Added 4 new gradients! Credit
- Emerald
- Mint
- Sunset
- Dusk
3.3.1
- Change
-rflag to-gflag in runner (restarts local Grafana instance) - Fix edge case in
normalizefunction wheremin = max - Psychrometric regions now utilize the full scale of the gradient
- Improve error checking for psychrometric states (remove nuisance error)
- Update data formatter for newer Grafana API version
3.3.0
- Update to the latest version of
@grafana/create-plugin(2.0.2)- Grafana version required:
>=10.0.3
- Grafana version required:
- Node version updated to
v18
3.2.3
- Update to the latest version of
@grafana/create-plugin(1.12.0)
3.2.2
- Update to the latest version of
@grafana/create-plugin(1.10.0) - Fix incorrect plugin ID in
docker-compose.yaml - Remove references to
GRAFANA_API_KEYin favor ofGRAFANA_ACCESS_POLICY_TOKEN
3.2.1
- Update to the latest version of
@grafana/create-plugin(1.9.0) - Remove references to
npmin build script - Store series value in label named
field.config.displayNameFromDS
3.2.0
- Update to the latest version of
@grafana/create-plugin(1.6.3)- Grafana version required:
>=9.5.3
- Grafana version required:
- Automatically build and validate plugin in validation script
3.1.3
- Update to the latest version of
@grafana/create-plugin(1.3.0) - Change
yarncommands tonpm run
3.1.2
- Move
README.mdfrom base folder tosrc/ - Update dependencies
3.1.1
- Screenshots are moved to
README.md
3.1.0
- Screenshots are no longer packaged with the plugin
- Add more and new screenshots with better descriptions
- Fix bug that prevented the default gradient from being set
- Don't attempt to plot data if no field names are selected
- Show an error if field is not found or otherwise invalid
- Show an error if maximum dew point > maximum dry bulb
- Add author contact information in
plugin.json - Publishing script now ensures changelog matches published version number
3.0.1
- Set
Viridisas the default color gradient - Add a short blurb in
README.mdin Troubleshooting to explain how to fix errors when upgrading to major versions
3.0.0
- Migrate from a JavaScript to a TypeScript code base
- Dynamically generate region & gradient selections in both the standalone app and the Grafana plugin
- This means, less code duplication, so it will be much easier to add additional regions or gradients in the future
- Regions are now rendered in a blue gradient instead of a violet gradient
- Tooltips now follow the mouse instead of being in predefined calculated positions
- Regions, chart axes, and points are no longer rendered outside of chart boundaries
- Rebuild with
npx @grafana/create-plugin@1.0.0to make sure source files and dependencies are up-to-date - Better support for long and multi-frame time series (wide time series still not implemented)
- For now, if you are using a wide time series, use the Grafana transform to convert to the long or multi-frame format
- Standalone app now adds timestamps to data points by default
- Minor updates in
README.mdto explain new ASHRAE guidelines and to update badges - Add link to official Grafana blog post in
plugin.json - Add more relevant search keywords in
plugin.json
2.0.1
- Fixed broken badges in
README.md - Fixed link to copyright notice in
README.md - Removed references to plugin signing
- Minor improvements to build pipeline
2.0.0
- Use the new Grafana plugin builder from
npx @grafana/create-plugin - Added additional workflows for compatibility and testing the build
1.1.1
Minor updates in packaging.
- Fixed instances of incorrect package name.
- Updated website URL
- Added plugin download URL
1.1.0
First public release in Grafana. Click here to visit the plugin's page.
- Updated badges
- Updated screenshots
- Other small fixes in
README
1.0.2
Pre-release with a few minor non-code updates.
- Small edits in
READMEandCHANGELOG
1.0.1
Pre-release with data source bug fix.
- Psychart can now detect if a data source calls each series by its frame name, field name, or a concatenation of both (for example, the Static Datasource)
1.0.0
Initial release with base features.
- Visualization of one data series of psychrometric properties with various field options
- A robust chart editor with graph options and display options
- Interactivity via hovering over data points or parts of the graph with the mouse
