Example repository for the Power Laws: Optimizing Demand-side Strategies competition on DrivenData
Switch branches/tags
Nothing to show
Clone or download


Power Laws: Optimizing Demand-side Strategies

For more about this repository, see the competition page:


Flexibility can be defined as "the ability of a resource, whether any component or collection of components of the power system, to respond to the known and unknown changes of power system conditions at various operational timescales".1 The exploitation of flexibility is essential to avoid costly reinforcements of the power system and maintain security of supply while increasing the penetration of renewable (and intermittent) sources of energy.

Flexibility can be produced in different manners. It might come from generation options, from energy storage or from energy demand. In some cases, generation can also be proposed through alternative dispatchable assets such as Combined Heat and Power (CHP). Storage is valid for both electricity and heat. Energy storage is an easy way to increase building flexibility, provided there is a business case for such an investment. The present challenge is focused on making a good usage of an installed storage system.

Viewed from the demand side, in the case of smart buildings, time of use tariffs incite to use energy when it is the most available. Given such a tariff, the goal is to buy more energy when its price is the lowest, and buy less (or possibly sell) energy when its price is the highest.

The goal in this competition is to build an algorithm that controls a battery charging system and spends the least amount of money over a simulation period.

Final Results

Place Team or User Score Summary of Model
1 VietNam national ORlab -0.201322 We considered the problem as a dynamic optimization problem. The problem at each step was modeled as a linear programming (LP). We selected Ortools to solve LP model optimally because it seemed to be the fastest and easy to install on docker.
2 ironbar -0.199243 My solution is based on simplificatoin of the period, dynamic programming, and intelligent pruning of the actions.
3 Helios -0.198155 Formulate a linear programming model for the optimization problem at each step with forecast data and use an open-source tool, which can be installed by pip to solve it. Scatter the energy charged (or discharged) among steps to avoid buying superfluous energy due to the uncertainty of next forecasts.

Interview with winners


  • Docker
  • Python 3.6 (for local execution instead of on Docker)

This repository contains the example implementation for how the optimization challenge code will be executed at the end of the competition. Competitors are required to only implement a single method propose_state within the file battery_controller.py.

This code exists to make it easy for competitors to test their solutions.

Running the simulation

  1. Clone this repository
  2. Add the data from the competition to the data folder. The script expects a folder named submit and a file called metadata.csv in the data directory.
  3. Copy your implementation of battery_controller.py into simulate/battery_controller.py
  4. Execute the run script: ./run.sh
  5. Your results will be stored and timestamped in the all_results folder each time you execute run.sh (Note: results.csv in output will be overwritten on each subsequent run.)

Note for Windows Users: We will accept a pull request with a run.bat script that works on Windows machines.

The only supported execution is within Docker. However, if you want to run the Python code locally rather than in a Docker container, you can still use the entrypoint.sh script on unix based system. You may need to install coreutils on your system in order to use the timeout command. For OSX you can run brew install coreutils and then update entrypoint.sh to call gtimeout instead of timeout. Windows users will need to create their own script, although for basic purposes just running python simulate/simulate.py should be sufficient.

Making a submission

For the public leaderboard

The public leaderboard just presents the mean of your results so far. Simply submit the most recent results from the all_results folder.

Code submission

You are required to submit your code in order to be considered for a prize. To do so, you must create a zip archive containing ONLY the assets folder and the battery_controller.py file. These are the only components you may submit. Other folders and files will be ignored. Instructions for submitting are on the competition page.

Structure of this repo

File Description
├── data A directory that has all of the input data as .csvs that are provided by the competition. Competitors must add the data themselves after downloading it from the competition.
├── output A directory for storing the output of a single simulation run.
├── all_results This directory contains results from all of the runs executed.
├── simulate The Python code for the simulation.
· ├── battery.py Contains an object for storing information about the battery.
· ├── simulate.py Main entrypoint. Controls and executes the simulations.
├── Dockerfile The definition for the Docker container on which the simulation executes.
├── README.md About the project.
├── entrypoint.sh Called inside the container to execute the simulation. Can also be used locally.
├── requirements.txt The Python libraries that will be installed. Only the libraries in this official repo will be available.
└── run.sh The only command you need. Builds and runs simulations in the Docker container.