Skip to content
forked from arfc/osier

Justice oriented energy system optimization framework

License

Notifications You must be signed in to change notification settings

samgdotson/osier

 
 

Repository files navigation

osier

/ˈōZHər/
Open source multi-objective energy system framework

status Build Status Documentation Status Binder

Installation

Method 1: PyPI

osier is available through PyPI. It may be installed with

python -m pip install osier

or by cloning this repository and building from source:

git clone [email protected]:arfc/osier.git  # requires ssh-keys
# or
git clone https://github.com/arfc/osier.git
cd osier
# for a basic installation
pip install .
# (Windows/Linux) to also install the documentation dependencies
pip install .[doc]
# (MacOS)
pip install .'[doc]'

Method 2: Conda/Mamba Environment

Although osier is not yet available on conda-forge, you may have a more consistent experience by installing osier via a conda environment.

git clone [email protected]:arfc/osier.git  # requires ssh-keys
mamba env create  # mamba and conda are interchangeable, here
mamba activate osier-env

Documentation

The documentation for osier can be viewed here. You can also build the docs locally with:

cd osier/docs
make html
cd build/html
# to serve the documentation
python -m http.server

Examples

The examples can be found in the docs/source/examples/ directory. Alternatively, users can run the notebooks and experiment with osier through the Binder app.

Binder

Tests

osier's tests can be run by executing pytest in the top-level directory of osier.

The test package assumes the user has `coin-or-cbc` installed as the default solver. For Windows machines,
this may require some additional steps to install the solver. [Here](https://stackoverflow.com/questions/58868054/how-to-install-coincbc-using-conda-in-windows) is a helpful place to start.

Contributing

Contributions to osier are welcome. For details on how to make bug reports, pull requests, and other information, check the contributing page.

Credits

Some of the documentation infrastructure was inspired by and borrowed from the watts documentation.

About

Justice oriented energy system optimization framework

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%