Getting started#
This page gets you started with the PrOMMiS Python package.
It depends on the IDAES and WaterTAP Python packages, which means that these will be automatically installed as part of its installation.
Install PrOMMiS#
PrOMMiS is distributed as a Python package, so can be installed through Python’s standard tool, pip. These instructions assume you can run commands from a Mac OSX, Linux, or Windows Powershell terminal.
Create Python environment (optional)#
Before installing the PrOMMiS software, we recommend you set up an “environment” that will let you install Python packages without affecting your default setup. Instructions are given below for doing this using Conda and Miniforge, but there are other methods such as pyenv and virtualenv that have similar effects.
Create Conda / Miniforge environment#
Conda is the name for the packaging environment created by the Anaconda corporation. Miniforge is software that installs Python packages, and sets up Python environments, without commercial and licensing concerns associated with the Anaconda software and package libraries.
Long story short, install miniforge from these links:
This will enable the conda command you can use to install a new Python
environment:
conda create -n prommis python=3.11 -y
Before you do any work you need to “activate” the environment:
conda activate prommis
Install PrOMMiS#
We will now install the PrOMMiS Python package into this environment.
pip install prommis
This will take a couple of minutes. Once it is done, you can continue to try an example.
Install IDAES “extensions”#
After installing PrOMMiS, you will need to install binary packages for the solvers. These “extensions”, as they are called, can be installed, after installing IDAES, using this command:
idaes get-extensions
Note
Depending on your operating system, additional steps might be needed. For more information, refer to the IDAES installation guide.
Try an example#
This section fetches and runs a Jupyter Notebook containing a PrOMMiS flowsheet.
We start by creating a working directory, then download the notebook from GitHub, then – after making sure the Jupyter Notebook code is installed – open that notebook in Jupyter.
Create subdirectory to work in#
mkdir prommis-work
cd prommis-work
Download the UKy flowsheet Jupyter Notebook#
Run the following commands using the curl command-line tool.
curl -o uky_flowsheet-solution.ipynb https://raw.githubusercontent.com/prommis/prommis/refs/heads/main/docs/tutorials/uky_flowsheet-solution.ipynb
curl -o uky_flowsheet.png https://raw.githubusercontent.com/prommis/prommis/refs/heads/main/docs/tutorials/uky_flowsheet.png
Navigate to the Jupyter notebook and hit Download () link in upper right of the file preview box.
Do the same with the flowsheet diagram
Install Jupyter Lab#
In order to run the Jupyter Notebook you’ll need the current web interface for Jupyter Notebooks, called Jupyter Lab, to be installed.
pip install jupyterlab
Open the notebook#
From here, all you need to do is run Jupyter Lab using the notebook you downloaded as input:
jupyter lab uky_flowsheet-solution.ipynb
This should open a new browser window or tab which shows the Jupyter Lab interface and the UKy notebook.
Tip
To hide the sidebar, and view just the notebook, hit “Control-B”.
Run the notebook#
For those unfamiliar with Jupyter Notebooks, the most common operation is to press Ctrl + Enter to execute the code in the current cell and advance to the next one. In this way you can execute a notebook step by step, pausing as needed to read and examine output. For more information see the JupyterLab documentation.
Next steps#
To use PrOMMiS libraries in your own Python code, you will need to create Python modules that create and build flowsheets, such as the module for the UKy flowsheet.
To understand how this and other examples work and start to create your own, please refer to documentation of the IDAES process systems engineering toolkit software.