Metadata-Version: 1.2
Name: mcycle
Version: 0.1.1
Summary: Power cycle sizing analysis package
Home-page: https://github.com/momargoh/MCycle
Author: Momar Hughes
Author-email: momar.hughes@unsw.edu.au
License: MIT
Description: =================
        MCycle README
        =================
        
        .. contents::
        
        About
        =========
        
        :Version:
           0.1
        :Author:
           Momar Hughes
        :Contact:
           momar.hughes@unsw.edu.au
        :Topic:
           Thermodynamic power cycle sizing and analysis
        :Licence:
           MIT
        :Requires:
           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:
          
        * *solve* : 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 `https://github.com/momargoh/MCycle <https://github.com/momargoh/MCycle>`_. The documentation is hosted at `https://mcycle.readthedocs.io <https://mcycle.readthedocs.io>`_
        
        
        Installation
        ============
        
        Requirements::
          
          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  <http://www.coolprop.org>`_, 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 <http://www.coolprop.org/coolprop/wrappers/Python/index.html#manual-installation>`_, summarised below.::
          
          cd PATH/TO/CLONE/FOLDER
          git clone https://github.com/CoolProp/CoolProp.git --recursive  
          cd wrappers/Python
          sudo python3 setup.py install
        
        MCycle should now be ready to be installed. For the latest updates, clone/download the source code from the `Github page <https://github.com/momargoh/MCycle>`_ and run::
        
          python3 setup.py install
          
        For the latest stable release, MCycle is available from pip by running:: 
        
          pip3 install mcycle
        
        MCycle is available under the MIT licence, hence free for everybody to use and edit. 
          
        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 <https://mcycle.readthedocs.io/en/latest/examples/contents.html>`_). 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::
          
          sudo mv PATH/TO/CLONE/FOLDER/CoolProp PATH/TO/CLONE/FOLDER/_CoolProp-master
        
        
Keywords: thermodynamics organic Rankine cycle power cycle evaporator expander condenser compressor heat exchanger heater cooler
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Education
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3
