Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ignf/route-graph-generator
Script collection used to generate routing data for Road2 (https://github.com/IGNF/road2)
https://github.com/ignf/route-graph-generator
generation-algorithms isochrone osrm pgrouting road2 routing valhalla
Last synced: about 1 month ago
JSON representation
Script collection used to generate routing data for Road2 (https://github.com/IGNF/road2)
- Host: GitHub
- URL: https://github.com/ignf/route-graph-generator
- Owner: IGNF
- License: gpl-3.0
- Created: 2021-12-15T16:01:19.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-10-14T08:12:20.000Z (2 months ago)
- Last Synced: 2024-10-21T15:39:04.414Z (2 months ago)
- Topics: generation-algorithms, isochrone, osrm, pgrouting, road2, routing, valhalla
- Language: Python
- Homepage: https://ignf.github.io/route-graph-generator/
- Size: 760 KB
- Stars: 7
- Watchers: 6
- Forks: 3
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Route Graph Generator
## Présentation
Route Graph Generator (r2gg) est un script Python qui permet la génération de graphes pour des moteurs de calcul d'itinéraire. Il a été développé pour générer les données directement utilisable par [Road2](https://github.com/IGNF/road2).
Actuellement, il y a trois formats de sortie : OSRM, pgRouting et Valhalla.
La conversion se fait via les fonctions de la bibliothèque r2gg développée dans ce but. Une documentation plus détaillée de r2gg est consultable [ici](https://ignf.github.io/route-graph-generator/).
## Prérequis
Les prérequis au fonctionnement des scripts de génération sont décrits dans le [readme](https://ignf.github.io/route-graph-generator/docker/readme.html) de l'image docker.
Les extensions SQL `postgres_fdw` et `PostGIS` doivent être installées sur la base de données `pivot` :
```sql
pivot=# CREATE EXTENSION postgres_fdw;
pivot=# CREATE EXTENSION PostGIS;
```
Dans le cas d'une convertion vers une base de données pgRouting, les extensions SQL `postgres_fdw`, `PostGIS` et `pgRouting` doivent être installées sur la base de données de destination, `pgrouting` par exemple :
```sql
pgrouting=# CREATE EXTENSION postgres_fdw;
pgrouting=# CREATE EXTENSION PostGIS;
pgrouting=# CREATE EXTENSION pgRouting;
```
Les procédures du projet [pgrouting-procedures](https://github.com/IGNF/pgrouting-procedures) doivent également être installées sur la base de données de destination, sur le bon schema
## Installation
Pour installer les commandes de génération de données, lancer la commande suivante à la racine du projet :
```
pip3 install --user -e .
```
## Utilisation
### Fichier de configuration
Pour pouvoir lancer les scripts de génération, il faut définir une configuration (au format JSON) par ressource à générer. Ce fichier de configuration fait références à d'autres fichiers de configuration : pour la gestion des logs, la gestion des connexions aux bases de données, et pour le calcul des coûts.
Des exemples de tous ces fichiers sont présents dans le dépôt dans le dossier `io`.
La documentation de ces fichiers de configuration est consultable [ici](https://github.com/IGNF/route-graph-generator/tree/master/io).
Un exemple de ces fichiers est disponible dans la partie [docker](https://github.com/IGNF/route-graph-generator/tree/master/docker/config).
### Exécution
Les scripts de génération sont divisés en trois processus distincts : l'extraction des données d'une base de données vers une base de données dite "pivot", et, en fonction de la ressource, la conversion depuis la base "pivot" vers une base pgRouting, ou vers des fichiers `.osrm`, ou encore vers des fichiers `valhalla`.
Ces trois processus se lancent à l'aide de commandes différentes, prenant toutes le même fichier de configuration.
Pour extraire les données vers la base pivot
```
r2gg-sql2pivot config.json
```
Pour convertir les données au fromat pgRouting (le type de ressource dans config.json doit être `pgr`)
```
r2gg-pivot2pgrouting config.json
```
Pour convertir les données au format osrm (le type de ressource dans config.json doit être `osrm`)
```
r2gg-pivot2osm config.json
r2gg-osm2osrm config.json
```
Pour convertir les données au format valhalla (le type de ressource dans config.json doit être `valhalla`)
```
r2gg-pivot2osm config.json
r2gg-osm2valhalla config.json
```
Enfin, si on souhaite générer la configuration pour Road2, il y a une dernière commande
```
r2gg-road2config config.json
```
## Version
Elle est indiquée dans le `__about__.py`.
## Licence
Route-graph-generator est diffusé sous la licence GPL v3.
## Participer aux développements
Les participations à ce projet sont encouragées (votre notre [charte](./CODE_OF_CONDUCT.md) à ce sujet). Nous avons mis en place un [guide](./CONTRIBUTING.md) des contributions pour vous accompagner dans cette démarche.