Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Overview

A model generator for energy system modelling and optimisation.

Everybody is welcome to use and/or develop oemof.solph. Read our ‘Why should I contribute’ section.

Contribution is already possible on a low level by simply fixing typos in oemof’s documentation or rephrasing sections which are unclear. If you want to support us that way please fork the oemof repository to your own github account and make changes as described in the github guidelines: https://guides.github.com/activities/hello-world/

Installation

If you have a working Python3 environment, use pypi to install the latest oemof version. Python >= 3.5 is recommended. Lower versions may work but are not tested.

pip install oemof.solph

If you want to use the latest features, you might want to install the developer version. See section ‘Developing oemof’ for more information. The developer version is not recommended for productive use:

pip install https://github.com/oemof/oemof-solph/archive/dev.zip

For more details have a look at the ‘Installation and setup’ section.

Documentation

The oemof.solph documentation is powered by readthedocs. Use the project site of oemof.solph to choose the version of the documentation. Go to the download page to download different versions and formats (pdf, html, epub) of the documentation.

To get the latest news visit and follow our website.

If you have questions regarding the use of oemof you can visit the forum at: https://forum.openmod-initiative.org/tags/c/qa/oemof and open a new thread if your questions hasn’t been already answered.

Open energy modelling framework (oemof)

The oemof.solph package is part of the Open energy modelling framework (oemof). This an organisational framework to bundle tools for energy (system) modelling.

Examples

The linkage of specific modules of the various packages is called an application (app) and depicts for example a concrete energy system model. You can find a large variety of helpful examples in oemof’s example repository on github to download or clone. The examples show optimisations of different energy systems and are supposed to help new users to understand the framework’s structure. There is some elaboration on the examples in the respective repository.

You are welcome to contribute your own examples via a pull request or by sending us an e-mail (see here for contact information).

Join the developers!

A warm welcome to all who want to join the developers and contribute to oemof.solph. Information on the details and how to approach us can be found in the documentation .

Keep in touch

You can become a watcher at our github site, but this will bring you quite a few mails and might be more interesting for developers. If you just want to get the latest news you can follow our news-blog at oemof.org.

Citing oemof

The core ideas of oemof are described in DOI:10.1016/j.esr.2018.07.001 (preprint at arXiv:1808.0807). To allow citing specific versions of oemof, we use the zenodo project to get a DOI for each version.

Free software: MIT license

Copyright (c) 2019 oemof developer group

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Development

To run the all tests run:

tox

Note, to combine the coverage data from all the tox environments run:

Windows

set PYTEST_ADDOPTS=--cov-append
tox

Other

PYTEST_ADDOPTS=--cov-append tox

Changelog

0.4.0.b0 (2020-05-12)

  • First release of oemof.solph on PyPI.

Metadata

Release files for oemof.solph 0.4.0b0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for oemof.solph 0.4.0b0
File Size Uploaded Provenance Actions
oemof.solph-0.4.0b0.tar.gz 406.8 kB Without provenance Details for oemof.solph-0.4.0b0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for oemof.solph 0.4.0b0
File Interpreter ABI Platform Actions
oemof.solph-0.4.0b0-py2.py3-none-any.whl Python 2, Python 3 none any Details for oemof.solph-0.4.0b0-py2.py3-none-any.whl

Total release size: 470.7 kB

Release files / oemof.solph-0.4.0b0.tar.gz

Download URL oemof.solph-0.4.0b0.tar.gz
Size 406.8 kB
Tags Source
SHA-256 checksum
How to use checksums
27f053a9b351123833557e4c1eeb8dddf375ab9a7fde056686cbf5d33031a584
BLAKE2b-256 checksum
How to use checksums
7684e2c9ca7a995cd754023d0d6cd96843f40bfdaed32dbbf8bc1ee96b5fccec
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/46.2.0 requests-toolbelt/0.9.1 tqdm/4.38.0 CPython/3.7.3

Release files / oemof.solph-0.4.0b0-py2.py3-none-any.whl

Download URL oemof.solph-0.4.0b0-py2.py3-none-any.whl
Size 64.0 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
79c4b79ae6381cdfcce83053a7450c8394ab40c02dcd80587505909ef569141b
BLAKE2b-256 checksum
How to use checksums
e46f4471056a9b737e57321481ae0668c245b9dc12009a830781b221b3d8fb8b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/46.2.0 requests-toolbelt/0.9.1 tqdm/4.38.0 CPython/3.7.3

Security for oemof.solph 0.4.0b0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page