To install the IDAES PSE framework, follow the set of instructions below that are appropriate for your needs and operating system. If you get stuck, please contact idaes-support@idaes.org.
The OS specific instructions provide information about optionally installing Miniconda. If you already have a Python installation you prefer, you can skip the Miniconda install section.
Note
IDAES supports Python 3.6 and above.
System | Section |
---|---|
Linux | :ref:min_install_linux |
Windows | min_install_windows |
Mac OSX | min_install_osx |
Generic | min_install_generic |
Warning
If you are using Python for other complex projects, you may want to consider using environments of some sort to avoid conflicting dependencies. There are several good options including conda environments if you use Anaconda.
Install Miniconda (optional)
- Download: https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe
- Install anaconda from the downloaded file in (1).
- Open the Anaconda Prompt (Start -> "Anaconda Prompt").
- In the Anaconda Prompt, follow the
min_install_generic
instructions.
Install Miniconda (optional)
- Download: https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
- Open a terminal window
- Run the script you downloaded in (1).
Install Dependencies
The IPOPT solver depends on the GNU FORTRAN, GOMP, Blas, and Lapack libraries, If these libraries are not already installed on your Linux system, you or your system administrator can use the sample commands below to install them. If you have a Linux distribution that is not listed, IPOPT should still work, but you the commands to install the required libraries may differ. If these libraries are already installed, you can skip this and proceed with the next step.
Note
Depending on your distribution, you may need to prepend
sudo
to these commands or switch to the "root" user.apt-get (Current Ubuntu based distributions):
sudo apt-get install libgfortran4 libgomp1 liblapack3 libblas3
yum (Current RedHat based distributions, including CentOS):
yum install lapack blas libgfortran libgomp
Complete Generic Install
Follow the min_install_generic
instructions.
Install Miniconda (optional)
- 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).
Complete Generic Install
Follow the min_install_generic
instructions.
The remaining steps performed in either the Linux or OSX Terminal or Powershell. If you installed Miniconda on Windows use the Anaconda Prompt or Anaconda Powershell Prompt. Regardless of OS and shell, the following steps are the same.
Install IDAES
Install IDAES with pip:
pip install idaes-pse
Run the
idaes get-extensions command <../commands/get_extensions>
to install the compiled binaries:idaes get-extensions
Run the
idaes get-examples command <../commands/get_examples>
to download and install the example files:idaes get-examples
Run tests:
pytest --pyargs idaes -W ignore
- You should see the tests run and all should pass to ensure the installation worked. You may see some "Error" level log messages, but they are okay, and produced by tests for error handling. The number of tests that failed and succeeded is reported at the end of the pytest output. You can report problems on the Github issues page (Please try to be specific about the command and the offending output.)