Installationsanleitung

Diese Anleitung beschreibt die Installation des Projekts mit Conda. Die Conda-Umgebung heisst vprouting und basiert auf Python 3.12.

Nach der Installation kann der Server gemäss Startup gestartet werden.

Voraussetzungen

Empfohlen wird eine Installation unter Linux oder Windows mit WSL2. Das Projekt verwendet mehrere GIS- und Geo-Bibliotheken, die unter Windows ohne Conda oft aufwendig zu installieren sind.

Voraussetzungen:

• Git
• Miniconda, Anaconda oder Miniforge
• Internetverbindung für Paketinstallation, OpenStreetMap-/OSMnx-Abfragen und Wetterdaten

Miniconda / Conda

Falls Conda noch nicht installiert ist, wird Miniconda empfohlen:

https://docs.conda.io/projects/miniconda/en/latest/

Nach der Installation sollte Conda im Terminal verfügbar sein:

conda --version

Optional kann Conda aktualisiert werden:

conda update -n base -c defaults conda

Repository klonen

git clone https://github.com/VPGIS/VPRouting
cd VPRouting

Conda-Umgebung erstellen

Die Standardumgebung wird aus der Datei environment.yml erstellt:

conda env create -f environment.yml

Dabei werden die wichtigsten Pakete über conda-forge installiert. Zusätzliche Python-Abhängigkeiten werden über pip aus requirements.txt installiert, sofern diese in der Conda-Umgebung eingebunden sind.

Umgebung aktivieren

conda activate vprouting

Umgebung aktualisieren

Wenn environment.yml oder requirements.txt geändert wurde, kann die bestehende Umgebung aktualisiert werden:

conda env update -f environment.yml --prune

Umgebung entfernen

Falls die Umgebung neu erstellt oder gelöscht werden soll:

conda deactivate
conda env remove -n vprouting

Anschliessend kann sie bei Bedarf erneut erstellt werden:

conda env create -f environment.yml

Nächster Schritt

Nach der Installation wird der API-Server mit dem Startup-Skript gestartet. Siehe Startup.