This training toolkit describes the WaterStrategy user interface and how to use it to build and use water resource system simulation models.


  • Understanding water allocation penalties
  • Practice with generic examples
  • Channel losses, flow routing, and return flows
  • Creating a reservoir node with basic Pywr nodes and parameters
  • Creating a turbine node using basic Pywr nodes, parameters, and recorders
  • Adding new attributes in the interface
  • Visualizing metrics in a parallel axes plot
  • Importing and exporting Pywr models in the website interface


  • Introduction to the structure of Pywr
  • Tutorials with the Nile River Basin
    • Using JSON format in the interface
    • Custom parameters and recorders
    • Using external data with Amazon Buckets
  • Practice with case studies: London’s water resource system (UK)
    • Introduction of the Thames network
    • Daily and annual advanced abstraction licenses
    • Minimum environmental flows, monthly demand profile and reservoir control rules
    • Activating drought options (desalination)
    • Turning on and off a new supply option (reservoir) and comparing performance in both scenarios.