Changeset 69 for trunk/workshop-routing-foss4g

Timestamp:

01/04/2012 21:39:01 (13 years ago)

Author:

djay

Message:

Add chapter 4

Location:

trunk/workshop-routing-foss4g

Files:

• chapters/osm2pgrouting.rst (modified) (4 diffs)
• conf.py (modified) (2 diffs)

trunk/workshop-routing-foss4g/chapters/osm2pgrouting.rst

@@ -1 +1 @@
 ==============================================================================================================
-osm2pgrouting Import Tool
+Outils d'import osm2pgrouting
 ==============================================================================================================
 
-**osm2pgrouting** is a command line tool that makes it very easy to import OpenStreetMap data into a pgRouting database. It builds the routing network topology automatically and creates tables for feature types and road classes. osm2pgrouting was primarily written by Daniel Wendt and is currently hosted on the pgRouting project site: http://www.pgrouting.org/docs/tools/osm2pgrouting.html
+**osm2pgrouting** est un outils en ligne de commande qui rend simple l'importation de données OpenStreetMap dans une base de données pgRouting. Il contruit le réseau routier automatiquement et crée les tables pour les types de données et les classes de routes. osm2pgrouting a été écrit initialement par Daniel Wendt et est maintenant disponible sur le site du projet pgRouting : http://www.pgrouting.org/docs/tools/osm2pgrouting.html
 
 .. note::
 
-        There are some limitations, especially regarding the network size. The current version of osm2pgrouting needs to load all data into memory, which makes it fast but also requires a lot or memory for large datasets. An alternative tool to osm2pgrouting without the network size limitation is **osm2po** (http://osm2po.de). It's available under "Freeware License".
+        Il y a quelques limitations, particuliÚrement par rapport à la taille du réseay. La version actuelle nécessite le chargement en mémoire de l'ensemble des données, ce qui le rend rapide mais consome aussi beaucoup de mémoire pour les gros enesemble d'objets. Un outils alternatif n'ayant pas de limitation sur la taille du réseauest **osm2po** (http://osm2po.de). Il est disponible sous licence "Freeware License".
         
 
-Raw OpenStreetMap data contains much more features and information than need for routing. Also the format is not suitable for pgRouting out-of-the-box. An ``.osm`` XML file consists of three major feature types:
+Les données brutres d'OpenStreetMap contiennent bien plus d'éléments et d'informations qu'il est nécessaire pour du routage. Ainsi le format n'est pas utilisable tel-quel avec pgRouting. Un fichier XML ``.osm`` contient trois types de données majeurs :
 
-* nodes
-* ways
+* noeuds
+* chemins
 * relations
 
-The data of sampledata.osm for example looks like this:
+Les données de sampledata.osm par exemple ressemble à ce qui suit :
 
 .. literalinclude:: code/osm_sample.osm
         :language: xml
 
-Detailed description of all possible OpenStretMap types and classes can be found here:  http://wiki.openstreetmap.org/index.php/Map_features.
+Une description détaillée de tout les types et classes possibles d'OpenStreetMap peuvent-être trouvé ici : http://wiki.openstreetmap.org/index.php/Map_features.
 
-When using osm2pgrouting, we take only nodes and ways of types and classes specified in ``mapconfig.xml`` file that will be imported into the routing database:
+Lorsuqe vous utilisez osm2pgrouting, nous devons conserver uniquement les noeuds et les chemin ayant pour types et classes celles stipulée dans le fichier ``mapconfig.xml`` qui seront improtés dans notre base de données routing :
 
 .. literalinclude:: code/mapconfig_sample.xml
         :language: xml
 
-The default ``mapconfig.xml`` is installed in ``/usr/share/osm2pgrouting/``.
+Le fichier ``mapconfig.xml``par défaut est installé dans le répertoire : ``/usr/share/osm2pgrouting/``.
 
 
 -------------------------------------------------------------------------------------------------------------
-Create routing database
+Création de la base de données routing
 -------------------------------------------------------------------------------------------------------------
 
-Before we can run osm2pgrouting we have to create a database and load PostGIS and pgRouting functions into this database. 
-If you have installed the template databases as described in the previous chapter, creating a pgRouting-ready database is done with a single command. Open a terminal window and run:
+Avant de lancer osm2pgrouting nous devons créer la base de données et y charger les fonctionalités de PostGIS et pgRouting .
+Si vous avez installé le modÚle de base de données comme décrit dans le chapitre précédent, créer une base de données prête à utiliser pgRouting est fait par une simple commande. Ouvrez une fenêtre de terminal et utiliser la commande suivante : 
 
 .. code-block:: bash
@@ -42 +42 @@
         createdb -U postgres -T template_routing routing
         
-... and you're done.
+... vous avez terminé.
 
-Alternativly you can use **PgAdmin III** and SQL commands. Start PgAdmin III (available on the LiveDVD), connect to any database and open the SQL Editor and then run the following SQL command:
+Une alternative consiste à  utiliser l'outil **PgAdmin III** et des requêtes SQL. Démarrez  PgAdmin III (disponible sur le LiveDVD), connectez vous à une base de données eyt ouvrez l'éditeur de requêtes afin d'y saisir les requêtes SQL suivantes :
 
 .. code-block:: sql
 
-        -- create routing database
+        -- Créationde la base routing
         CREATE DATABASE "routing" TEMPLATE "template_routing";
 
 
-Otherwise you need to manually load several files into your database. See :ref:`previous chapter <installation_load_functions>`.
+Sinon, vous devez manuellement charger différents fichier dans la base de données. Voir : :ref:`previous chapter <installation_load_functions>`.
 
         
 -------------------------------------------------------------------------------------------------------------
-Run osm2pgrouting
+Utiliser osm2pgrouting
 -------------------------------------------------------------------------------------------------------------
 
-The next step is to run ``osm2pgrouting`` converter, which is a command line tool, so you need to open a terminal window.
+La prochaine étape c'est de lancer l'outil ``osm2pgrouting``, qui est un outil en ligne de commande, donc vous devrez l'utiliser depuis une fenêtre de terminal.
 
-We take the default ``mapconfig.xml`` configuration file and the ``routing`` database we created before. Furthermore we take ``~/Desktop/pgrouting-workshop/data/sampledata.osm`` as raw data. This file contains only OSM data from downtown Denver to speed up  data processing time.
+Nous prendrons par défaut le fichier de configuration ``mapconfig.xml`` et la base de données ``routing`` que nous avons créer précédemment. De plus nous prendrons le fichier ``~/Desktop/pgrouting-workshop/data/sampledata.osm`` comme données brutes. Ce fichier contient seulement les données OSM du centre ville de Denver afin d'accélérer le processus de chargement des données.
 
-The workshop data is available as compressed file, which needs to be extracted first either using file manager or with this command:
+Les données sont disponibles au format compressé, qui doit donc être décompressé soit en utlisant un navigateur de fichier soit en utilisant la commande suivante :
 
 .. code-block:: bash
@@ -70 +70 @@
         tar -xvzf data.tar.gz
 
-Then run the converter:
+Lancer ensuite l'outil :
         
 .. code-block:: bash
@@ -80 +80 @@
                                   -clean
                                         
-List of all possible parameters:
+List des paramÚtres possible :
 
 .. list-table::
    :widths: 15 15 60 10
 
-   * - **Parameter**
-     - **Value**
-     - **Description**
-     - **Required**
+   * - **ParamÚtre**
+     - **Valeur**
+     - **Déscription**
+     - **Requis**
    * - -file
-     - <file>
-     - name of your osm xml file
+     - <fichier>
+     - le nom du fichier XML .osm
      - yes
    * - -dbname
-     - <dbname>
-     - name of your database
+     - <nom_de_base>
+     - le nom de votre base de données
      - yes
    * - -user
-     - <user>
-     - name of the user, which have write access to the database
+     - <utilisateur>
+     - le nom de l'utilisateur, qui a le droit d'accÚs en écriture sur la base de données
      - yes
    * - -conf
-     - <file>
-     - name of your configuration xml file
+     - <fichier>
+     - le nom du fichier XML de configuration
      - yes
    * - -host
-     - <host>
-     - host of your postgresql database (default: 127.0.0.1)
+     - <hÃŽte>
+     - l'hÎte de votre base de données postgresql (par défaut : 127.0.0.1)
      - no
    * - -port
      - <port>
-     - port of your database (default: 5432)
+     - le numéro de port de votre serveur de base de données(par défaut: 5432)
      - no
    * - -passwd
-     - <passwd>
-     - password for database access
+     - <mot_de_passe>
+     - le mot de passe pour se connecter à la base de données
      - no
    * - -clean
      - 
-     - drop peviously created tables
+     - Suprrimer les tables précédemment créées
      - no
 
 .. note::
 
-        If you get permission denied error for postgres users you can set connection method to ``trust`` in ``/etc/postgresql/8.4/main/pg_hba.conf`` and restart PostgreSQL server with ``sudo service postgresql-8.4 restart``.
+        Si vous obtenez un message d'erreur relatif aux droits de l'utilisateur postgres, vous pouvez définir la méthode comme ``trust`` dans le fichier  ``/etc/postgresql/8.4/main/pg_hba.conf`` et redémarrer le serveur PostgreSQL avec la commande ``sudo service postgresql-8.4 restart``.
 
 
-Depending on the size of your network the calculation and import may take a while. After it's finished connect to your database and check the tables that should have been created:
+Suivant la taille de votre réseau le temps de cacul et d'importation de données peut être long. Une fois terminé, connectez à votre base de données et vérifiez les tables qui aurait du être créées :
 
-.. rubric:: Run: ``psql -U postgres -d routing -c "\d"``        
+.. rubric:: Lancer: ``psql -U postgres -d routing -c "\d"``     
 
-If everything went well the result should look like this:
+Si tout se passe bien, le résultat devrait ressembler à ceci :
         
 .. code-block:: sql

trunk/workshop-routing-foss4g/conf.py

@@ -38 +38 @@
 
 # General information about the project.
-project = u'Travaux pratiques - Routage FOSS4G avec les outils de pgRouting, le réseau routier d\'OpenStreetMap et GeoExt'
+project = u'Travaux pratiques - Routage FOSS4G avec les outils de pgRouting, le réseau routier d''OpenStreetMap et GeoExt'
 copyright = u'2010-2011 Daniel Kastl, Frédéric Junod'
 
@@ -125 +125 @@
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
-html_title = "Travaux pratiques - Routage FOSS4G avec les outils de pgRouting, le réseau routier d'OpenStreetMap et GeoExt"
+html_title = "Travaux pratiques - Routage FOSS4G avec les outils de pgRouting, le reseau routier d'OpenStreetMap et GeoExt"
 
 # A shorter title for the navigation bar.  Default is the same as html_title.
-html_short_title = "Travaux pratiques - Routage FOSS4G avec les outils de pgRouting, le réseau routier d'OpenStreetMap et GeoExt"
+html_short_title = "Travaux pratiques - Routage FOSS4G avec les outils de pgRouting, le reseau routier d'OpenStreetMap et GeoExt"
 
 # The name of an image file (relative to this directory) to place at the top