🧠 SANEVEC Wiki

SUMO-based simulation, analysis, and infrastructure modeling docs for the SANEVEC research project

⚖️ License¶

This project is distributed under the GNU General Public License v3. See the LICENSE file for full terms.

🌍 Project Overview¶

SANEVEC (University of Seville, I3US) develops simulation-driven tooling to plan urban electric vehicle charging networks. The initiative studies how different deployment strategies impact traffic congestion, grid usage, emissions, and overall mobility. This MkDocs site centralises workflows, datasets, modelling artefacts, and operational guides used by the team.

🔄 Stay Updated¶

Pushes to the main branch automatically rebuild and publish the GitHub Pages site through .github/workflows/gh-pages.yml. For publishing guidance, see Documentation Workflow.

🧭 How the Docs Are Organised¶

Below is a quick tour of the navigation entries with a short description and link for each page.

Core Orientation¶

Project Overview – Home page with project summary and links.
Directory Structure – Repository layout, automation, and supporting artefacts.
Architecture – Diagrams and component descriptions for SANEVEC tooling.

SUMO Tooling¶

Create SUMO AppImage – Steps to package SUMO with linuxdeploy.
Create SUMO Docker image – Docker-based environment build instructions.
SUMO Output Files – Key XML outputs and configuration tips.
SUMO study on vehicle density – Acceleration/occupation analysis results.
Use of SUMO on the HPC – HPC build, module setup, and execution guide.
Simulation Workflow – End-to-end process for generating routes and running experiments.

Scenario & Data¶

Sevilla Traffic Overview – Study area description and modelling assumptions.
Traffic Data – Source datasets, preprocessing, and validation notes.
Trips Generator – Tools and parameters for generating SUMO routes.
SUMO Output Files – Field-by-field explanation of exported artefacts.

Analysis & Optimisation¶

Analysis Scripts – Python utilities for aggregating simulation metrics.
Genetic Algorithm for Charging Stations – Placeholder for optimisation strategies (TBD).
Vehicle Contaminations Study – Planned emissions comparison write-up (TBD).

Charging Infrastructure & Visuals¶

Charging Station Integration Guide – SUMO charging infrastructure workflow.
Mermaid & Draw.io Diagrams – Diagramming conventions and assets; see also utils/mdd_drawio.md.

Contributor Utilities & Support¶

GitHub SSH Key – Guide to add a SSH key to GitHub
GitHub Useful Commands – Common Git operations cheat sheet.
Documentation Workflow – How to edit, preview, and publish the site.
Troubleshooting & FAQ – Common issues and fixes.
References – Literature and resource links.