Skip to main content

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()).

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 ;-)

Metadata

Release files for psychrochart 0.1.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for psychrochart 0.1.7
File Size Uploaded
psychrochart-0.1.7.tar.gz 20.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for psychrochart 0.1.7
File Interpreter ABI Platform
psychrochart-0.1.7-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 44.6 kB

Release files / psychrochart-0.1.7.tar.gz

Download URL psychrochart-0.1.7.tar.gz
Size 20.6 kB
Tags Source
SHA-256 checksum
How to use checksums
f4a4c35750dd3b0bbc49f6fd40105a9a8bff65d223db44a1c8c3eb8434ae8d68
BLAKE2b-256 checksum
How to use checksums
33950e31f14eda7146aa4a40587792b8e1783454d20728c4a6c932c3aa0e6661
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / psychrochart-0.1.7-py2.py3-none-any.whl

Download URL psychrochart-0.1.7-py2.py3-none-any.whl
Size 24.0 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
e876abea2216aee06d358c3767251fa3df582ab9903a4dc7f06f9e3ecd336984
BLAKE2b-256 checksum
How to use checksums
6678ec18e2359506b72cbe7f36b52e5e468427c661a0e8da80e146990f9f5946
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

0.11.1

2 release files

0.9.3

2 release files

0.9.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.13

2 release files

0.1.12

2 release files

0.1.11

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

This release

0.1.7 This release

2 release files

0.1.6

2 release files

0.1.5

3 release files

0.1.4

2 release files

0.1.3

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page