Windows Installation Guide

Quickstart

The following commands should be sufficient to get you started with installing and using IDAES. For more information on these steps, see below.

 1# Set up & activate Conda new environment with IDAES-PSE
 2conda create --yes --name my-idaes-env -c conda-forge -c IDAES-PSE python=3.10 idaes-pse
 3conda activate my-idaes-env
 4
 5# Install IDAES Extensions
 6idaes get-extensions
 7
 8# Install IDAES Examples (optional)
 9idaes get-examples
10
11# Run Tests
12pytest --pyargs idaes -W ignore

Installing IDAES

To get IDAES fully set up on your machine, we’ll go through the steps to get idaes-pse package installed as well as setting up the IDAES extensions, which includes some extra solvers and function libraries, the IDAES example files, and the IDAES tests.

Install Prerequisites

Install Miniconda

  1. Download & install Miniconda.

  2. Install anaconda from the downloaded & open the Anaconda Prompt (Start -> “Anaconda Prompt”).

Install IDAES-PSE

We recommend using Conda to manage your environment & modules.

# Create a new Conda environment (Here named my-idaes-env, but this is up to you)
conda create --yes --name my-idaes-env python=3.10
conda activate my-idaes-env

# Install IDAES Conda package
conda install --yes -c IDAES-PSE -c conda-forge idaes-pse

Note

The command above will install the most recent stable (release) version of IDAES. To install other versions of IDAES, including pre-release versions, refer to the Versioned IDAES Installation guide

Install IDAES Extensions

Run the idaes get-extensions command to install the compiled binaries. These binaries include solvers and function libraries. See Binary Packages for more details

idaes get-extensions

Note

If you are not able to successfully run the idaes get-extensions command due to network security settings or another reason, you can download binary release files from https://github.com/IDAES/idaes-ext/releases, and extract them in the directory indicated by the idaes bin-directory command. You will need both the idaes-lib-* and idaes-solvers-* files appropriate for your operating system.

Install IDAES Examples

Run the idaes get-examples command to download and install the example files

idaes get-examples

By default this will install in a folder “examples” in the current directory. The command has many options, but an important one is --dir, which specifies the folder in which to install.

idaes get-examples --dir <PATH>

An example of the path formatting would look like C:\Users\MyName\IDAES\Examples

Run IDAES Tests

Run the IDAES test suite to verify that your installation has been successful.

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 ask questions using the Github Discussion Forum or report problems on the Github issues page (Please try to be specific about the command and the offending output.)