Skip to main content

Power cycle sizing and analysis package

Project description





Momar Hughes



Thermodynamic power cycle sizing and analysis


Apache License 2.0


numpy, scipy, matplotlib, CoolProp

MCycle is a Python3 module for 1-dimensional analysis and sizing of thermodynamic heat cycles, particularly the organic Rankine cycle. Sizing methods are based on empirical and theoretical correlations. Users may analyse cycles consisting of components including heaters, coolers, compressors, expanders and heat exchangers. The two main modes for analysing cycles or components are:

  • size : calculates a component characteristic/dimension required to satisfy a desired component outlet flow state/cycle flow states. This mode is used for sizing components.

  • run : calculates working fluid cycle flow states/ component outlet flow state based on user-defined characteristics/dimensions of the components.

The Github project page can be found at The documentation is hosted at or can be built using Sphinx (using Python3).



sudo apt install build-essential python3 python3-dev python3-pip python3-tk cython3 git
pip3 install numpy
pip3 install scipy
pip3 install matplotlib

MCycle also requires CoolProp, a free and open-source thermodynamic properties library. It is recommended to manually install the latest version of CoolProp before installing MCycle (rather than installing from pip which is not the latest version). Refer to their guide on manual installation, summarised below.:

git clone --recursive
cd wrappers/Python
sudo python3 install

MCycle should now be ready to be installed. For the latest updates, clone/download the source code from the Github page and run:

python3 install

For the latest stable release, MCycle is available from pip by running:

pip3 install mcycle

Contributions towards the project source code will be gratefully received. Feel free to contact the author via email or GitHub with any queries.

Quick start

Have a look through mcycle/examples to get a feel for how to use the module (link to documentaion). These examples can be easily copied to your local directory and modified to get you started.

Notes on installing CoolProp from source for Python3

Once, the installation failed because /usr/local/lib/python3.6/dist-packages did not exist, thus I ran:

sudo mkdir -p /usr/local/lib/python3.6/dist-packages

Another time, I had to rename the original cloned CoolProp folder to stop Python3 finding it when importing:


Project details

Download files

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

Source Distribution

mcycle-0.1.3.tar.gz (55.0 kB view hashes)

Uploaded source

Built Distribution

mcycle-0.1.3-py3-none-any.whl (88.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page