opyplus is a package allowing to work with EnergyPlus in Python.
More specifically, it allows to:
To install opyplus, run: pip install opyplus
or conda install -c conda-forge opyplus
Documentation is available at https://opyplus.readthedocs.io
opyplus is designed to work with python 3.8 and newer.
It is currently automatically tested against the following python versions:
opyplus is designed to work with any EnergyPlus version. Currently, it is automatically tested against the following versions (listed in TESTED_EPLUS_VERSIONS : oplus.tests.util):
Each test is therefore run multiple times : once per tested version. To automatically run a test on all versions, use eplus_tester function (oplus.tests.util).
opyplus is designed to work with any Operating System but is automatically tested against the latest versions of Ubuntu OS.
Install pytest and the packages listed in requirements.txt using pip or conda.
Install EnergyPlus v22.1.0.
At the root of the repository, run pytest: python -m pytest
.
We use flake8 for style enforcement, including docstrings.
To run it, install flake8 and flake8-docstrings using pip or conda.
At the root of the repository, run flake8: python -m flake8 opyplus/
To build the configuration:
install the requirements in docs/requirements.txt
run make html
in opyplus docs directory.
To ensure the examples in the documentation remain up to date, they are tested using the doctest extension: https://www.sphinx-doc.org/en/master/usage/extensions/doctest.html
run make doctest
in opyplus docs directory to test the documentation.
When adding code samples to the documentation, please use when possible the doctest extension, as it helps ensure your
samples will be kept up to date: use .. testcode::
and .. testoutput::
rather than .. code-block:: python
.