Metadata-Version: 2.1
Name: bauwerk
Version: 0.3.0
Summary: Simple building control environments for reinforcement learning.
Home-page: https://github.com/rdnfn/bauwerk
Author: rdnfn
License: MIT license
Keywords: bauwerk
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.6
Provides-Extra: cvxpy
Provides-Extra: widget
Provides-Extra: exp
License-File: LICENSE
License-File: AUTHORS.rst




    **Warning**
    
    Bauwerk is in a very early stage of development, not stable at the moment and not recommended for general usage at this point. Use at your own risk.


=======
bauwerk
=======


.. image:: https://img.shields.io/pypi/v/bauwerk.svg
        :target: https://pypi.python.org/pypi/bauwerk

.. image:: https://img.shields.io/travis/rdnfn/bauwerk.svg
        :target: https://travis-ci.com/rdnfn/bauwerk

.. image:: https://readthedocs.org/projects/bauwerk/badge/?version=latest
        :target: https://bauwerk.readthedocs.io/en/latest/?version=latest
        :alt: Documentation Status




Super simple building control environments for reinforcement learning.


* Free software: MIT license
* Documentation: https://bauwerk.readthedocs.io.


Features
--------

* TODO

Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.2.2 (2022-10-26)
------------------

* Features

  * Add experiment script
  * Add extensive evaluation features
  * Add support for much slower speed in game widget
  * Add benchmarks
  * Add support for setting tasks in environment
  * Add wrappers:

    *  that add task parameters to observation space.
    *  that clip the reward
    *  that clip the action space
    *  that normalise observation space

* Improvements

  * Add clock and day to game widget
  * Design improvements for game widget
  * Action spaces dtype can now be set in env cfg


0.2.1 (2022-09-12)
------------------

* Features

  * Add ``time_of_day`` variable to observation space.

* Improvements

  * The ``solve`` function is now directly imported with ``bauwerk``, to simplify usage.
  * Additional sections added to documentation.
  * Add more grid parameters to ``SolarBatteryHouseEnv`` configuration.

* Fixes:

  * Ensure solver outputs actions that are valid in environment (i.e. normalised)

0.2.0 (2022-09-09)
------------------

* Features:

  * Add game widget based on ``SolarBatteryHouseEnv``.

    * Includes browser-based version of Bauwerk game that can be played by anybody without installing anything.

  * Add support for selling to the grid in ``SolarBatteryHouseEnv``.

* Improvements:

  * Add explicit CVXPY-based solver in ``bauwerk.envs.solvers`` for ``SolarBatteryHouseEnv`` that was missing earlier.
  * Update ``SolarBatteryHouseEnv`` to comply with new gym step API by returning ``truncated`` value.
  * Add automatic github-actions-based testing of package.


0.1.0 (2022-08-12)
------------------

* First release on PyPI.

* Features:

  * ``SolarBatteryHouseEnv``: a simple environment representing a single family home with a solar photovoltaic installations and a home battery that can be controlled.
  * Optional integration with CVXPY to compute optimal actions in Bauwerk environments.
