Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kLabUM/pystorms
Simulation Sandbox for the Design and Evaluation of Stormwater Control Algorithms
https://github.com/kLabUM/pystorms
Last synced: 3 months ago
JSON representation
Simulation Sandbox for the Design and Evaluation of Stormwater Control Algorithms
- Host: GitHub
- URL: https://github.com/kLabUM/pystorms
- Owner: kLabUM
- License: gpl-3.0
- Created: 2019-10-01T19:09:06.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-01-25T18:27:16.000Z (almost 2 years ago)
- Last Synced: 2024-03-22T07:12:08.598Z (8 months ago)
- Language: Jupyter Notebook
- Homepage: https://www.pystorms.org
- Size: 32.5 MB
- Stars: 24
- Watchers: 9
- Forks: 16
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- open-sustainable-technology - pystorms - Simulation Sandbox for the Design and Evaluation of Stormwater Control Algorithms. (Natural Resources / Water Supply and Quality)
README
# pystorms: simulation sandbox for the evaluation and design of stormwater control algorithms
[![pystorms](https://github.com/kLabUM/pystorms/actions/workflows/python-package.yml/badge.svg?branch=master&event=push)](https://github.com/kLabUM/pystorms/actions/workflows/python-package.yml)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/python/black)## Overview
This library has been developed in an effort to systematize quantitative analysis of stormwater control algorithms.
It is a natural extension of the Open-Storm's mission to open up and ease access into the technical world of smart stormwater systems.
Our initial efforts allowed us to develop open source and free tools for anyone to be able to deploy flood sensors, measure green infrastructure, or even control storm or sewer systems.
Now we have developed a tool to be able to test the performance of algorithms used to coordinate these different sensing and control technologies that have been deployed throughout urban water systems.For the motivation behind this effort, we refer the reader to our manuscript [*pystorms*](https://dl.acm.org/citation.cfm?id=3313336). In general, this repo provides a library of `scenarios` that are built to allow for systematic quantitative evaluation of stormwater control algorithms.
## Getting Started
### Installation
**Requirements**
- PyYAML >= 5.3
- numpy >= 18.4
- pyswmm```bash
pip install pystorms
```Please raise an issue on the repository or reach out if you run into any issues installing the package.
### Example
Here is an example implementation on how you would use this library for evaluating the ability of a rule based control in maintaining the flows in a network below a desired threshold.
```python
import pystorms
import numpy as np# Define your awesome controller
def controller(state):
actions = np.ones(len(state))
for i in range(0, len(state)):
if state[i] > 0.5:
actions[i] = 1.0
return actions
env = pystorms.scenarios.theta() # Initialize scenario
done = False
while not done:
state = env.state()
actions = controller(state)
done = env.step(actions)performance = env.performance()
```
Detailed documentation can be found on the [webpage](https://www.pystorms.org)