Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

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


Adding more dimension to the psychrometric chart




No releases published


No packages published