Minimal installation¶
To make it easier to use basic functionality and try the IDAES PSE Toolkit, we have compiled these “minimal” instructions, that only allow one to use the free IPOPT solver with MUMPS. This will not be appropriate for some models. We are working on an easy installer with better solvers, but for now you will need to use the full install instructions in the next sections if this is not sufficient for your needs.
Note
Miniconda is a product from Anaconda that contains their package manager, “Conda”. This is the package manager we will use here for setting up the software development environment and installing IDAES dependencies.
Minimal install with IPOPT/MUMPS for Windows¶
Install Miniconda
- Download: https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe
- Install anaconda from the downloaded file in (1).
- Open the Anaconda powershell (Start -> “Anaconda Powershell Prompt”).
- In the Anaconda Powershell, follow the Generic minimal install with IPOPT/MUMPS instructions.
Minimal install with IPOPT/MUMPS for Linux¶
Install Miniconda
- Download: https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
- For the next steps, open a terminal window
- Run the script you downloaded in (1).
- Follow the Generic minimal install with IPOPT/MUMPS instructions.
Minimal install with IPOPT/MUMPS for Mac/OSX¶
Install Miniconda
- Download: https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh
- For the next steps, open a terminal window
- Run the script you downloaded in (1).
- Follow the Generic minimal install with IPOPT/MUMPS instructions.
Generic minimal install with IPOPT/MUMPS¶
Once you have Conda installed, the remaining steps, performed in either the Anaconda Powershell (Prompt) or a Linux terminal, are the same.
If you are familiar with Python/Conda environments, you will probably
want to create a new environment for your IDAES installation before
starting to install Python and/or Conda packages,
e.g., conda create -n <env>
then conda activate <env>
.
If you are not familiar with these commands, don’t worry, this is
an optional step.
Install IPOPT
Install IPOPT from “conda-forge”:
conda install -c conda-forge ipopt
Check if the installation worked by checking for the ipopt version:
ipopt -v
Download IDAES source code and install required packages
Go to the idaes-pse releases page, https://github.com/IDAES/idaes-pse/releases/, and look at the most recent release. Under the section labeled “Assets” there will be a zip file. Download that file and extract the contents in any location of your choice.
In the Linux terminal or Anaconda Powershell, navigate to the folder you created in the previous step.
Install the packages required for IDAES using the following command:
pip install -r requirements.txt
Install IDAES
In the folder where the idaes source code was downloaded, run the setup.py file:
python setup.py develop
Run tests on unit models:
pytest idaes/unit_models
- You should see the tests run and all should pass to ensure the installation worked.
You can report problems on the Github issues page (Please try to be specific about the command and the offending output.)
Launch the Jupyter Notebook
Navigate to examples and run Jupyter notebook:
cd idaes/examples jupyter notebook
Open a web browser to the URL that is printed from the previous command.