/ˈōZHər/
Open source multi-objective energy system framework
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 .
# to also install the documentation dependencies
pip install .[doc]
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
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.
Contributions to osier
are welcome. For details on how to make bug reports, pull requests, and other information, check the contributing page.
Some of the documentation infrastructure was inspired by and borrowed from the watts
documentation.