README.md

rivus

rivus is a mixed integer linear programming optimisation model for capacity planning for energy infrastructure networks. Its name, latin for stream or canal, stems from its origin as a companion model for urbs, an optimisation model for urban energy systems. This model shares the same structure as urbs, so please refer to its introduction/tutorial for now or dive directly into the code.

Features

• rivus is a mixed integer linear programming model for multi-commodity energy infrastructure networks systems with a focus on high spatial resolution.
• It finds the minimum cost energy infrastructure networks to satisfy a given energy distribution for possibly multiple commodities (e.g. electricity, heating, cooling, ...).
• Time is represented by a (small) set of weighted time steps that represent peak or typical loads
• Spatial data can be provided in form of shapefiles, while technical parameters can be edited in a spreadsheet.
• The model itself is written using Pyomo and includes reporting and plotting functionality.

Screenshots

Electricity network capacities	Heat network capacities	Gas network capacities

Installation

Windows

1. Anaconda (Python 3.6). Choose the 64-bit installer if possible.

2. Pyomo and GLPK

   1. Launch a new command prompt (Win+R, type "cmd", Enter)
   2. Type conda install -c conda-forge pyomo glpk, hit Enter.

3. Add shapefile support:

   conda install -c conda-forge pyshp shapely basemap
   

4. Get geopandas and its dependencies:

   conda install -c conda-forge pyproj fiona geopy geopandas
   

5. For interactive, 3-D plots with plotly:

   conda install -c conda-forge plotly
   

6. For Postgres + PostGIS integration:

   conda install -c conda-forge psycopg2 sqlalchemy
   

7. For graph-theoretical analysis:

   conda install -c conda-forge networkx
   

Documentation / Tutorials

• Official documentation
• List of helpful IPython notebooks on handling geographic input data:
  • join data from building.shp and edge.shp
  • OSM street data to vertex.shp and edge.shp
  • Square grid to vertex.shp and edge.shp
• See repository-wiki for archive of interesting conversations, tips, and troubleshooting.

Copyright

Copyright (C) 2015-2017 Johannes Dorfner

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/