Oemof.solph

API changes

* Allow conversion factor of zero for `GenericTransformer`
* Python 3.6 is no longer officially supported. It may still work for a while though.


New components/constraints

* Custom component: oemof.solph.custom.PiecewiseLinearTransformer. A transformer model with one input and one output and an arbitrary piecewise linear conversion function. On how to use the component, refer to the `test script <https://github.com/oemof/oemof-solph/blob/dev/tests/test_scripts/test_solph/test_piecewiselineartransformer/test_piecewiselineartransformer.py>`_ and `example <https://github.com/oemof/oemof-examples/blob/master/oemof_examples/oemof.solph/v0.4.x/piecewise/piecewise_linear_transformer.py>`_.
* Enhanced custom SinkDSM:
* Renamed keyword argument `method` to `approach`
* Renamed approaches `interval` to `oemof` and `delay` to `DIW`
* Added modeling approach `DLR` (PhD thesis of Hans Christian Gils 2015)
* Included load shedding
* Introduced `recovery_time` in `DIW` approach
* Introduced `shift_time` and other parameters for `DLR` approach
* Included investments in DSM
* Normalized keyword arguments `demand`, `capapcity_up` and `capacity_down`


Bug fixes
* Check number of `Flow` s in `GenericStorage`


Other changes
* Split code into submodules
* Move CI-Tests from Travis to github (see `PR 746 <https://github.com/oemof/oemof-solph/pull/746>`_)


Contributors

* Jann Launer
* Johannes Kochems
* Patrik Schönfeldt
* Stefan Schirmeister
* Uwe Krien

Oemof-solph does not work with the latest version of Pyomo (5.7.3). In fact it does work but it takes hours.

If this problem affects you just downgrade Pyomo to 5.7.2 or lower.


pip install pyomo==5.7.2


This hotfix is released to allow installation without manually downgrading Pyomo. Instead of downgrading Pyomo you can just use:


pip install oemof.solph --upgrade

The latest release of Pyomo broke API compatibility, though it was only a point release. This hotfix is released to allow installation without manually selecting the versions of solph's dependencies.


pip install oemof.solph --upgrade

Even Corona could not stop the next major release of oemof.solph, which is now a separate package.

Use: pip install oemof.solph to get the new version.

Furthermore, a lot of interesting features and new constraints were added.

See the [changelog](https://oemof-solph.readthedocs.io/en/latest/changelog.html#v0-4-0-june-6-2020) for more information.

A new Demand Side Management component and some new features justify a new release.

See the [Whatsnew](https://oemof.readthedocs.io/en/stable/whats_new.html#what-s-new) section for more details.

Do not miss the [developer meeting](https://oemof.org/2019/11/21/anniversary-developer-meeting-final-agenda/) if you are interested in the developing process.

Stay tuned :smile:

This is not a real fix but the update from v0.2.x to v0.3.x is very error prune if you use the GenericStorage.

With this version an error will raised if you use the GenericStorage in the old v0.2.x way. So far it was just ignored, which might lead to an unwanted behavior. Please update to avoid errors if you use the `GenericStorage`:


pip install oemof --upgrade