primo-optimizer 0.2.0rc1

PRIMO - The P&A Project Optimizer

PRIMO - The P&A Project Optimizer Toolkit

PRIMO - The P&A Project Optimizer Toolkit aims to provide multi-scale, simulation-based, open source computational tools and models to support the Methane Emissions Reduction Program (MERP) and the National Emissions Reduction Initiative (NEMRI).

Project Status

Getting Started

Our complete documentation is available on readthedocs, but here is a summarized set of steps to get started using the framework.

While not required, we encourage the installation of Anaconda or Miniconda and using the conda command to create a separate python environment in which to install the PRIMO Toolkit.

Regular users can use conda to create a new "primo" environment.

conda env create -f conda-env.yml

This creates a new conda environment with the name "primo" that comes installed with all required dependencies to solve PRIMO's optimization problems.

Developers can create a new "primo" environment by executing:

conda env create -f conda-env-dev.yml

Activate the new environment with:

conda activate primo

Additionally, developers should complete the installation of the playwright package which is required for running tests.

playwright install

To test the installation of the primo package, execute:

pytest primo\utils\tests\test_imports.py

The above test, if executed successfully, confirms that primo package is now installed and available in the "primo" package that was just created.

To use the utilities implemented in the PRIMO package that query the U.S. Census API and Bing Maps API, appropriate API keys must be obtained by signing up with the respective services. These keys must be configured in a .env file in the parent directory. For more details, please see: API Keys

Additionally, use of elevation based utilities requires the user to provide a GeoTIFF file that provides elevation data across the region of interest. Users can download this data from USGS Science Data Catalog. For more details, please see: Elevation Data

Users can also employ other commercial solvers, for example Gurobi, to solve the optimization problem. However, users are responsible for configuring and setting up these solvers themselves.

General, background and overview information is available at the NEMRI website.

Running PRIMO with Binder

You can run PRIMO with Binder: a public cloud service that provides a temporary and short-lived sandbox environment to run PRIMO without installing any software locally.

Quickstart

You can launch the Binder environment by clicking on the following badge:

Key Notes

• Binder environments are automatically destroyed after a few minutes of inactivity. To avoid lost work, please download the notebook file on your local machine periodically.
• The Binder provided environment is public and insecure. Please do not use this environment to work with sensitive data.

Funding acknowledgements

This work was conducted as part of the National Emissions Reduction Initiative with support through the Environmental Protection Agency - Methane Emissions Reduction Program within the U.S. Department of Energy’s Office of Fossil Energy and Carbon Management (FECM). As of 2023, additional support was provided by FECM’s Solid Oxide Fuel Cell Program, and Transformative Power Generation Program.

Contributing

By contributing to this repository, you are agreeing to all the terms set out in the LICENSE.md and COPYRIGHT.md files in this directory.