Skip to content
Adding more dimension to the psychrometric chart
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Design with Comfort: Enhancing the psychrometric chart with radiation and convection dimensions

See Live Demo

What is this chart?

An expansion to the classic pschrometric chart, including the effects of radiation heat exchange on human comfort.

About the Repo

  • The jupyter_notebook folder contains a .ipynb file in which you can play with the source code, and see how the app works
  • The app folder contains the python source code in its plain format, fully bundled as a responsive flask web app
    • within the app folder, the contains the algorithm, while serves the algorithm on the website via templates/graphs.html


A paper submitted by Eric Teitelbaum, Prageeth Jayathissa, Clayton Miller and Forrest Meggers to the journal Energy and Buildings

This paper presents a makeover of the psychrometric chart using a new color-shading method that allows the whole chart to be considered comfortable based on the variation of non-air temperature comfort parameters such as mean radiant temperature, air movement, and the transitional behavior of occupants. These representations allow for thinking outside the thermal comfort box with the use of innovative system types and comfort feedback for occupants. The new chart representations are then applied on several real-world scenario datasets to illustrate the value in practice. An open-source repository is available for other researchers to reproduce the charts and color-shading for their own projects using Python and the matplotlib visualization library. The chart is also served at

Run App Locally

  1. Pull the repo, and cd psychrometric-chart-makeover

  2. Start the virtual environment source v_env/bin/activate

  3. cd app: Here you can find three files, runs the flask web server, is the core calculation script, templates/graphs.html is the html template that renders the website.

  4. Run the app locally

From the route folder, in terminal, run

export flask run

You may need to pip3 install flask first

The app shoudld be locally hosted at

Deploy to AWS

  1. Install the Elastic Beanstalk CLI

  2. Run eb deploy

if it doesn't work, check out the wiki, talk to PJ or see the elastic beanstalk-flask documentaiton which is a buit sucky

You can’t perform that action at this time.