S2G is a project aimed at simplifying the workflow of estimating pollutant concentrations in urban areas by automating the simulation process in GRAL (Graz Lagrangian Model). By providing geographic area specifications or an Open Street Map (OSM) file, SUMO (Simulation of Urban MObility) emissions files, and weather data for the desired area, users can effortlessly perform GRAL simulations and obtain pollutant concentrations for the studied area. The weather data format aligns with the format provided by the monitor stations of Valencian Environmental Agency.
- Automated Data Processing: Simplifies the preparation of input files for GRAL by automatically processing building, weather, highway, and map data.
- Georeferenced Map Generation: Creates georeferenced maps based on specified geographic bounds.
- Shapefile Generation: Generates shapefiles for buildings and highways which are essential for GRAL simulations.
- Weather Data Processing: Processes weather data to match the requirements of GRAL simulations.
- GRAL Files Generation: Automates the creation of required GRAL simulation files through a dedicated module.
- GRAL Simulation: Executes the GRAL simulation and outputs the reuslts in a .txt file.
- Pollutant Concentration Analysis: Provides a module for analyzing pollutant concentrations in the studied area.
You must have installed the Dotnet >= 6.0 SDK installed. Please visit the Windows .NET 8.0 downloading page.
If you are a Linux user you can simply do:
sudo apt-get install -y dotnet-sdk-8.0- pandas
- osmnx
- sumolib
- numpy
- geopandas
- cartopy
- pyproj
- osmium
Clone the repository:
git clone https://github.com/seniel98/SUMO2GRAL.git
cd SUMO2GRALInstall the required dependencies:
pip install -r requirements.txtRun the command line interface (CLI) script with the desired arguments to process the data and generate the required files:
Offline mode (default):
-
Parameters mode
python cli.py --base-directory /path/to/base/directory --process all --osm-file /path/to/osm/file/file.osm --net-file /path/to/net/file/file.net.xml --emissions-file /path/to/edge/emissions/file/edges-emissions-file.xml --gral-dll /path/to/gral/dll/file/GRAL.dll
-
Configuration file mode (here you can take a look at the structure of the config file)
python cli.py -c configuration.sumo2gral.cfg --process all
Online mode (This is in case you want to retrieve the data using the osmnx library):
python cli.py --base-directory /path/to/base/directory --north 39.49 --south 39.47 --east -0.37 --west -0.39 --process all --net-file /path/to/net/file/file.net.xml --emissions-file /path/to/edge/emissions/file/edges-emissions-file.xml --online --gral-dll /path/to/gral/dll/file/GRAL.dllAfter the data processing is complete, you can display the pollutant concentrations in the studied area:
python cli.py --process results --display-geo-map -r /path/to/results/file/results.txt --mapbox-api-key your_mapbox_api_keyThis command displays the pollutant concentration map using Mapbox. Replace your_mapbox_api_key with your API key (see how to create your API KEY).
For a comprehensive guide to S2G's architecture and modules, refer to the in-depth documentation here.
This tutorial provides a step-by-step guide on using SUMO2GRAL with data from Wildau, Germany. It covers everything from setting up your environment and running SUMO simulations to executing GRAL simulations and analyzing the results. This example serves as a practical illustration of how SUMO2GRAL can be applied to real-world scenarios.
For more detailed examples and use cases, please check our documentation.
Your contributions are welcome! Please refer to the contributing guidelines for more information.
S2G is made available under the MIT License.