Skip to main content
Help us improve Python packaging – donate today!

A Python 3 library to make psychrometric charts and overlay information on them.

Project Description

It implements a useful collection of psychrometric equations for moisture and humid air calculations, and the generation of beautiful and high customizable psychrometric charts in SVG with matplotlib.

Calculations are made by implementing experimental equations extracted from recognized sources, such as the 2009 ASHRAE Handbook—Fundamentals (SI).

Install

Clone it from Github if you want to run the tests, or simply:

pip install psychrochart

Features

  • SI units (with temperatures in celsius for better readability).
  • Easy style customization with a JSON template (colors, line styles and line widths).
  • Psychrometric charts within temperature and humidity ratio ranges, for any pressure, with:
    • Saturation line
    • Constant RH lines
    • Constant enthalpy lines
    • Constant wet-bulb temperature lines
    • Constant specific volume lines
    • Constant dry-bulb temperature lines (internal orthogonal grid, vertical)
    • Constant humidity ratio lines (internal orthogonal grid, horizontal)
  • Plot legend for each family of lines
  • Specify labels for each family of lines
  • Overlay points and zones
  • Export SVG files
  • Tested against example tables from http://www.engineeringtoolbox.com
  • 100 % code coverage.

The ranges of temperature, humidity and pressure where this library should provide good results are within the normal environments for people to live in. Don’t expect right results if doing other type of thermodynamic calculations. Over saturated water vapor states are not implemented.

Changelog

  • v0.1.0: Initial version.
  • v0.1.1: Minor plotting fixes, set axis position, define P with altitude_m or pressure_kpa, reuse plot removing annotations (chart.remove_annotations). Axes as internal prop, lazy plotting, save to disk helper (chart.save).
  • v0.1.2: Add agg module to set that matplotlib backend.
  • v0.1.3: Add custom params for plotting styles, option to exclude first and last tick (constant_{humid/temp}_label_include_limits).
  • v0.1.4: Customize labels and its locations for families of psychrometric curves.
  • v0.1.5: Add Arrows, compatibility with the Home Assistant component psychrometrics.
  • v0.1.6: Some cleaning, better typing, flake8, added tox.ini.
  • v0.1.7: Methods to clean the plot (.close_fig()) and to remove the legend (.remove_legend()).
  • v0.1.8: Memleak with savefig.
  • v0.1.10: Fix plot limits, do not use pyplot, axes are not optional.

Usage

from psychrochart.chart import PsychroChart

# Load default style:
chart_default = PsychroChart()
axes = chart_default.plot()

Tests

To run the tests, clone the repository and run:

py.test --cov=psychrochart -v --cov-report html

to generate the coverage reports.

License

MIT license, so do with it as you like ;-)

Release history Release notifications

This version
History Node

0.1.10

History Node

0.1.9

History Node

0.1.8

History Node

0.1.7

History Node

0.1.6

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
psychrochart-0.1.10-py2.py3-none-any.whl (24.0 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Jul 29, 2017
psychrochart-0.1.10.tar.gz (20.9 kB) Copy SHA256 hash SHA256 Source None Jul 29, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page