Routeur : Différence entre versions

De VlmWiki
 
(47 révisions intermédiaires par 3 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
 
= Routeur =
 
= Routeur =
 +
 +
{{Languages}}
  
 
== Installation ==
 
== Installation ==
  
L'installation se fait simplement en exécutant le Setup à télécharger depuis Virtual-Winds.com : [http://www.virtual-winds.com/~sbs/Routeur/Routeur.zip  Routeur]
+
L'installation se fait simplement en exécutant le Setup à télécharger depuis le fil du routeur sur le forum  : [[http://www.virtual-winds.org/forum/index.php?/topic/6388-sbs-routeur-pour-vlm/] sbsRouteur pour VLM]
  
 
Le Setup installera les dossiers et fichiers suivants :
 
Le Setup installera les dossiers et fichiers suivants :
Ligne 13 : Ligne 15 :
 
== Configuration ==
 
== Configuration ==
  
=== 1er Lancement ===
 
  
Lors du premier lancement, le programme va copier le fichier routeur.ini dans le dossier %APPDATA%\sbs\Routeur, puis l'ouvrir pour vous afin que vous puissiez y saisir les informations de login de votre bateau, ainsi que la course en cours. Une fois ces modifications terminées (cf § suivant pour le contenu du fichier de configuration) vous pouvez relancer le routeur qui vous demandera votre mot de passe VLM pour pouvoir se connecter au site et récupérer les informations concernant votre bateau.
 
  
=== Fichier de configuration ===
 
  
L'application n'a pas encore d'interface pour la configuration. Il faut donc mettre à jour le fichier de configuration Routeur.ini à la main.
 
  
Les paramètres sont les suivants:
+
== Utilisation ==
<pre>
+
=== Introduction ===
[INFO]
+
==== Lancement sélection d'un bateau ====
Nick= ''Mettre ici votre nom d'utilisateur vlm''
+
Au lancement de l'application, l'écran suivant vous demande de choisir un boat pour naviguer:<BR>
NumBoat=''Mettre ici le numéro de bateau vlm''
+
<table>
StartLat=''Mettre ici la latitude de départ de la course''
+
<tr><td>
StartLon=''Mettre ici la longitude de départ''
+
[[Image:SelectUser.jpg]]
; Map Level
+
</td>
; c crude
+
<td>
; l low
+
Mettre dans login et password votre nom utilisateur vlm et mot de passe VLM. <BR>Lorsque le mot de passe VLM est validé, le petit écusson vert apparait. <BR>Quand le bateau est en course, l'icône voilier est affichée, sinon c'est l'icône ponton.<BR><BR>
; i intermediate
+
La poubelle permet de supprimer un boat.<BR><BR>
; h high
+
La table à carte permet de modifier les préférences de routage de la course.
; f Full
+
</td>
Maplevel=l ''Mettre le niveau adéquat en fonction des fichiers que vous avez''
+
</tr>
;
+
</table>
; Grid Grain (How far the routing points are from each other)
+
 
;
+
Pour ajouter un nouveau bateau cliquer sur le bouton AddNew.
;
+
 
GridGrain=0.01  ''Niveau de détail du routage''
+
==== Ajout d'un bateau à la liste des bateaux enregistrés ====
  
 +
Pour ajouter un nouveau bateau saisir un nom de joueur (c'est une adresse email), ainsi que le mot de passe correspondant. La liste des bateaux (incluant ceux en boatsitting) est affichée:<BR>
 +
[[Image:FrmNewBoat.jpg]]<BR>
  
[Route]
+
Sélectionner le bateau à ajouter dans la liste, puis cliquer sur OK pour l'ajouter à la liste des bateaux enregistrés
WP1 19.000 -80.750 19.250 -81.750 Classement WP1
 
WP2 22.000 -82.000 22.333 -83.000 Classement WP2
 
WP3 22.058 -83.950 22.041 -83.950 Finish Cortés
 
  
[RaceZoneOffset]
+
==== Modification des paramètres de routage de la course ====
south=0
 
north=0
 
west=0
 
south=0
 
</pre>
 
  
Si vous copiez le tableau des WP depuis la page des instructions de course, vous pouvez les coller directement dans le fichier. Vous n'avez ensuite qu'à supprimer le WP0 et mettre les coordonnées dans StartLat et StartLon.
+
La fenêtre de paramétrage de la course se présente comme ceci:<BR>
 +
<table><tr><td>
 +
[[Image:RacePrefs.jpg]]</td>
 +
<td>
 +
*'''GridGrain''' : Finesse de routage
 +
*'''MapLevel''' : Niveau de détail de la carte pour le calcul des collisions (intermediate est un bon compromis en général)
 +
*'''EllipseExtensionFactor''' : Paramètre qui détermine quelle surface est à prendre en compte pour calculer le routage entre le point de départ et l'arrivée. (En gros l'excentricité de l'éllipse dont le grand axe va de la position courante à l'arrivée, et dont l'exentricité est cette valeur). Laisser 1.3, si vous ne savez pas quoi mettre la dedans, surtout pas de valeur inférieure à 1, sinon pas de routage....
 +
*'''Race Zone Extension''' : Le routeur calcule tout seul la surface de la carte en fonction de la course. Mais parfois, cela ne suffit pas. Saisir en degrés, l'extension requise dans chaque direction.
 +
*'''NO 60°S Exclusion''' : Lorsque cette case est cochée, le routeur n'arrête pas le routage à 60°S, qui est la zone d'exclusion standard pour les tours du monde.
 +
</td></tr></table>
  
Le paramètre GridGrain détermine la finesse de la grille sur laquelle le programme calcule la route. Plus le nombre est petit, plus le routage est précis, mais plus il prend de temps. Je vous conseille donc de ne pas descendre en dessous de .01, à moins d'avoir beaucoup de temps et un pc avec énormément de mémoire vive.
+
==== Routage ====
  
Pour les course du week-end et les permanentes courtes, utiliser ''maplevel f'' et ''gridgrain 0.01''. Pour les grandes courses, genre tour du monde ou Route du thé : ''maplevel l'' et ''gridgrain 0.1'' vous éviterons des erreurs de type "out of memory".
 
  
La section [RaceZoneOffset] permet d'étendre la zone de la carte qui est calculée à partir des WP et de la position courante du bateau. Pour chaque direction, indiquer de combien de degrés il faut agrandir la zone de la carte.
+
Le routeur dispose de deux modes de routage:<BR>
 +
* [[Routage par Grille]]
 +
* [[Routage par Isochrone]]
  
== Utilisation ==
+
Le premier, plus précis est beaucoup plus long. Le second qui utilise une heuristique étudie beaucoup moins de routes, et donc produit un résultat plus rapidement. Les deux évitent les cotes, et iles (dans la limite de la résolution GridGrain donnée en paramètre de la course)
=== Introduction ===
 
Au lancement de l'application, il faut attendre un peu, le temps de charger les cartes, cela prend plus ou moins de temps en fonction de la course et du niveau de détail retenu (ajouter une splash et une fenêtre de progression serait probablement du meilleur effet).
 
  
La fenêtre de l'application se présente comme ceci :
+
La fenêtre de l'application se présente comme ceci :<BR>
[[Image:Ecran1.jpg]]
+
[[Image:Ecran1.jpg|thumb]]
  
 
L'application a 3 onglets :
 
L'application a 3 onglets :
* Position / Vitesse : Donne les infos de position/vitesse et angle et force du vent depuis la dernière communication avec le serveur
 
 
* 2DViewer : La vue de l'image :
 
* 2DViewer : La vue de l'image :
 
**Rose des vents avec Cap du bateau, sens du vent et force du vent
 
**Rose des vents avec Cap du bateau, sens du vent et force du vent
Ligne 77 : Ligne 76 :
 
*** Distance de cette position au prochaine WP
 
*** Distance de cette position au prochaine WP
 
*** Liste des dernières variations de classement
 
*** Liste des dernières variations de classement
** Zone Best Route
 
*** Affichage rapide de la meilleure route calculée (une fois qu'un cycle complet de routage est terminé)
 
** Zone Route to Mouse
 
*** Affichage de la meilleure route vers la position de la souris
 
 
** Classement actuel et chrono de vacation
 
** Classement actuel et chrono de vacation
 
** Zone d'information du moteur du routeur
 
** Zone d'information du moteur du routeur
Ligne 87 : Ligne 82 :
 
** Carte
 
** Carte
 
*** Déplacement de la carte avec click-drag de la souris
 
*** Déplacement de la carte avec click-drag de la souris
*** Zoom avant/arrière avec la roulette (attention, le centre de zoom n'est pas celui de l'image c'est un bug pénible, qui oblige à zoomer et recentrer au fur et à mesure)
+
*** Zoom avant/arrière avec la roulette  
* Autorouteur
+
* Speed / Position : Donne les infos de position/vitesse et angle et force du vent depuis la dernière communication avec le serveur
 +
* Route Tables
 
** Grille du haut : meilleure route temporaire en cours de calcul
 
** Grille du haut : meilleure route temporaire en cours de calcul
 
** Grille du bas : meilleure route lors du cycle de calcul précédent
 
** Grille du bas : meilleure route lors du cycle de calcul précédent
  
=== Les contrôles ===
+
=== La barre de menu et de contrôles ===
  
En haut de la fenêtre se trouvent les controles suivants :
+
En haut de la fenêtre se trouvent les menus suivants :
 
[[Image:Controles.jpg]]
 
[[Image:Controles.jpg]]
  
#Nick : Nom du boat suivi, pour lequel on effectue le routage
+
#[[Menu Action]] : Pour faire faire quelque chose au programme
#Draw Boat Map : Affiche la carte de position des autres bateaux en course à partir de la page classement de VLM
+
#[[Menu Information]] : Donne des information sur le routage, la carto...
#gridroute : Lance le calcul de la route
+
#[[Menu Display]] : Pour configurer l'affichage
#Combo des WP : Liste des WP définis dans le fichier routeur.ini, choisir le WP de routage ''avant'' de lancer le calcul
+
#[[Menu Meteo]] : Pour afficher la météo
#ShowStats : Statistiques de calcul en cours (utiles pour le debug)
+
#[[Menu Routes]] : Pour configurer la route du Pilototo
#redraw : force le re-dessin
+
#Combo des WP : Liste des WP de la course en cours. Choisir le WP de routage ''avant'' de lancer le calcul
#ignoreobstacle : calcule la route sans prendre en compte les îles et continents (forcément beaucoup plus rapide ;)
 
 
#Estime allure : Saisir une allure dans la première zone, et une durée en minute, puis cliquer sur redraw, pour voir s'afficher la route correspondante à allure constante depuis la position actuelle du bateau
 
#Estime allure : Saisir une allure dans la première zone, et une durée en minute, puis cliquer sur redraw, pour voir s'afficher la route correspondante à allure constante depuis la position actuelle du bateau
#Hide Boat & Wind arrow : permet d'afficher ou de masquer la fleche de vent et le cap du bateau à un point de routage calculé
+
 
 +
=== Envoyer des ordres de pilotage ===
 +
 
 +
Le routeur permet de contrôler le bateau pour envoyer des ordres au serveur VLM et définir la route à suivre. Il permet aussi de programmer le Pilote Automatique.
 +
<BR>
 +
#[[Conduire le bateau depuis le routeur]]
 +
#[[Menu Routes]]
 +
#[[Pilotage Simple du bateau]]
  
 
=== Exemple de routage ===
 
=== Exemple de routage ===
Ligne 130 : Ligne 132 :
 
[[Image:PageRoutage.jpg]]
 
[[Image:PageRoutage.jpg]]
  
Le tableau du bas indique les étapes avec pour chacune :
+
Les deux tableaux indiquent:
 +
* La meilleure route temporaire pour le cycle de calcul en cours
 +
* La meilleure route calculée lors du cycle de calcul précédent
 +
<BR>
 +
Chaque route est décrite comme un liste d'étapes à cap constant:
 
* Le cap à suivre
 
* Le cap à suivre
 
* La vitesse (à la fin du segment)
 
* La vitesse (à la fin du segment)
* L'heure d'arrivée au bout de ce segment
+
* L'heure d'arrivée au bout de cette étape
* Le point d'arrivée du segment
+
* Le point d'arrivée de l'étape
* La voile (mais dans VLM on en utilise qu'une donc on peut oublier cette colonne)
+
* La voile ''(mais dans VLM on en utilise qu'une donc on peut oublier cette colonne)''
* La force et la direction du vent à la fin du segment
+
* La force et la direction du vent à la fin de l'étape
* La distance au point de fin du segment (mis à jour à chaque vac)
+
* La distance au point de fin du segment ''(mis à jour à chaque vac)''
* Le cap vrai pour atteindre le point de fin du segment (mis à jour à chaque vac)
+
* Le cap vrai pour atteindre le point de fin du segment ''(mis à jour à chaque vac)''
 
* La distance du point de fin du segment à l'arrivée
 
* La distance du point de fin du segment à l'arrivée
 
  
 
== Les fichiers générés ==
 
== Les fichiers générés ==
  
Lors de son exécution, le routeur génère des fichiers que vous pouvez supprimer s'il vous gênent. Ces fichiers sont :
+
Lors de son exécution, le routeur génère des fichiers que vous pouvez supprimer s'il vous gênent (bien entendu, losque le programme n'est pas en cours d'exécution).<BR>
* Track_''numéro de course''.dat : la trace du bateau.
+
Ces fichiers sont :
 +
Dans %APPDATA%\sbs:
 +
* RouteurRI_xxx.ini : Fichier d'information de course, avec les information de course fournies par le serveur
 +
<br><br>
 +
Dans %APPDATA%\sbs\Routeur:
 +
* Track_''xxx''_''yyy''.dat : la trace du bateau y sur la course x.
 
* BestRoutex.csv : La meilleure route calculée est sauvée dans ce fichier
 
* BestRoutex.csv : La meilleure route calculée est sauvée dans ce fichier
 
* TempRoutex.csv : la route temporaire en cours
 
* TempRoutex.csv : la route temporaire en cours
 +
* fgrib''xxxxx'' : fichier temporaire méteo
 +
* ri_''xxx''.xml : Préférences de course
 +
* Tiles : Dossier qui contient les bouts de carte
  
 
Les fichiers bestroute et temproute sont là pour permettre de ne pas devoir attendre trop longtemps en cas de plantage du programme au mauvais moment. Le dernier fichier non vide contient les infos affichées à l'écran peu avant le plantage.
 
Les fichiers bestroute et temproute sont là pour permettre de ne pas devoir attendre trop longtemps en cas de plantage du programme au mauvais moment. Le dernier fichier non vide contient les infos affichées à l'écran peu avant le plantage.

Version actuelle datée du 16 novembre 2016 à 05:54

Routeur

Installation

L'installation se fait simplement en exécutant le Setup à télécharger depuis le fil du routeur sur le forum : [[1] sbsRouteur pour VLM]

Le Setup installera les dossiers et fichiers suivants :

  • Routeur : Dossier de base de l'application
    • Grib2 : Dossier pour la récupération et le traitement des données météo
    • Gshhs : Dossier de stockage des fichiers des côtes des îles et continents
    • Routeur : Dossier de stockage de l'application

Configuration

Utilisation

Introduction

Lancement sélection d'un bateau

Au lancement de l'application, l'écran suivant vous demande de choisir un boat pour naviguer:

SelectUser.jpg

Mettre dans login et password votre nom utilisateur vlm et mot de passe VLM.
Lorsque le mot de passe VLM est validé, le petit écusson vert apparait.
Quand le bateau est en course, l'icône voilier est affichée, sinon c'est l'icône ponton.

La poubelle permet de supprimer un boat.

La table à carte permet de modifier les préférences de routage de la course.

Pour ajouter un nouveau bateau cliquer sur le bouton AddNew.

Ajout d'un bateau à la liste des bateaux enregistrés

Pour ajouter un nouveau bateau saisir un nom de joueur (c'est une adresse email), ainsi que le mot de passe correspondant. La liste des bateaux (incluant ceux en boatsitting) est affichée:
FrmNewBoat.jpg

Sélectionner le bateau à ajouter dans la liste, puis cliquer sur OK pour l'ajouter à la liste des bateaux enregistrés

Modification des paramètres de routage de la course

La fenêtre de paramétrage de la course se présente comme ceci:

RacePrefs.jpg
  • GridGrain : Finesse de routage
  • MapLevel : Niveau de détail de la carte pour le calcul des collisions (intermediate est un bon compromis en général)
  • EllipseExtensionFactor : Paramètre qui détermine quelle surface est à prendre en compte pour calculer le routage entre le point de départ et l'arrivée. (En gros l'excentricité de l'éllipse dont le grand axe va de la position courante à l'arrivée, et dont l'exentricité est cette valeur). Laisser 1.3, si vous ne savez pas quoi mettre la dedans, surtout pas de valeur inférieure à 1, sinon pas de routage....
  • Race Zone Extension : Le routeur calcule tout seul la surface de la carte en fonction de la course. Mais parfois, cela ne suffit pas. Saisir en degrés, l'extension requise dans chaque direction.
  • NO 60°S Exclusion : Lorsque cette case est cochée, le routeur n'arrête pas le routage à 60°S, qui est la zone d'exclusion standard pour les tours du monde.

Routage

Le routeur dispose de deux modes de routage:

Le premier, plus précis est beaucoup plus long. Le second qui utilise une heuristique étudie beaucoup moins de routes, et donc produit un résultat plus rapidement. Les deux évitent les cotes, et iles (dans la limite de la résolution GridGrain donnée en paramètre de la course)

La fenêtre de l'application se présente comme ceci :

Ecran1.jpg

L'application a 3 onglets :

  • 2DViewer : La vue de l'image :
    • Rose des vents avec Cap du bateau, sens du vent et force du vent
    • Zone d'infos position de la souris
      • Position courante de la souris sur la carte
      • Distance de cette position au prochaine WP
      • Liste des dernières variations de classement
    • Classement actuel et chrono de vacation
    • Zone d'information du moteur du routeur
      • Indique à chaque vacation les direction et la force du vent
      • Indique en cours de routage la progression du routage, toutes les minutes
    • Carte
      • Déplacement de la carte avec click-drag de la souris
      • Zoom avant/arrière avec la roulette
  • Speed / Position : Donne les infos de position/vitesse et angle et force du vent depuis la dernière communication avec le serveur
  • Route Tables
    • Grille du haut : meilleure route temporaire en cours de calcul
    • Grille du bas : meilleure route lors du cycle de calcul précédent

La barre de menu et de contrôles

En haut de la fenêtre se trouvent les menus suivants : Controles.jpg

  1. Menu Action : Pour faire faire quelque chose au programme
  2. Menu Information : Donne des information sur le routage, la carto...
  3. Menu Display : Pour configurer l'affichage
  4. Menu Meteo : Pour afficher la météo
  5. Menu Routes : Pour configurer la route du Pilototo
  6. Combo des WP : Liste des WP de la course en cours. Choisir le WP de routage avant de lancer le calcul
  7. Estime allure : Saisir une allure dans la première zone, et une durée en minute, puis cliquer sur redraw, pour voir s'afficher la route correspondante à allure constante depuis la position actuelle du bateau

Envoyer des ordres de pilotage

Le routeur permet de contrôler le bateau pour envoyer des ordres au serveur VLM et définir la route à suivre. Il permet aussi de programmer le Pilote Automatique.

  1. Conduire le bateau depuis le routeur
  2. Menu Routes
  3. Pilotage Simple du bateau

Exemple de routage

Par exemple sur la route du thé, voici un exemple de ce que donne le routeur : Exroutage.jpg

On ne voit pas la souris, mais elle était au bout de la route rouge
Donc on voit:

  1. la route qui passe par les WP
  2. la meilleur route temporaire du calcul en cours
  3. la meilleure route du point de départ du routage vers le point ou se trouve la souris.
  4. la route en suivant l'allure demandée (ici 50° pendant 1000 minutes)
  5. récapitulatif de la route sous la souris et de la meilleur route (si elle a été calculée)
  6. Indicateur de progression du calcul de routage

Les tableaux indiquent les points de parcours de la route sous la forme : Jusqu'à telle heure ; tenir tel cap ; ce qui amènera à telle distance du but

Table de résultat de routage

Une fois le routage terminé, on peut voir le routage dans page autorouteur : PageRoutage.jpg

Les deux tableaux indiquent:

  • La meilleure route temporaire pour le cycle de calcul en cours
  • La meilleure route calculée lors du cycle de calcul précédent


Chaque route est décrite comme un liste d'étapes à cap constant:

  • Le cap à suivre
  • La vitesse (à la fin du segment)
  • L'heure d'arrivée au bout de cette étape
  • Le point d'arrivée de l'étape
  • La voile (mais dans VLM on en utilise qu'une donc on peut oublier cette colonne)
  • La force et la direction du vent à la fin de l'étape
  • La distance au point de fin du segment (mis à jour à chaque vac)
  • Le cap vrai pour atteindre le point de fin du segment (mis à jour à chaque vac)
  • La distance du point de fin du segment à l'arrivée

Les fichiers générés

Lors de son exécution, le routeur génère des fichiers que vous pouvez supprimer s'il vous gênent (bien entendu, losque le programme n'est pas en cours d'exécution).
Ces fichiers sont : Dans %APPDATA%\sbs:

  • RouteurRI_xxx.ini : Fichier d'information de course, avec les information de course fournies par le serveur



Dans %APPDATA%\sbs\Routeur:

  • Track_xxx_yyy.dat : la trace du bateau y sur la course x.
  • BestRoutex.csv : La meilleure route calculée est sauvée dans ce fichier
  • TempRoutex.csv : la route temporaire en cours
  • fgribxxxxx : fichier temporaire méteo
  • ri_xxx.xml : Préférences de course
  • Tiles : Dossier qui contient les bouts de carte

Les fichiers bestroute et temproute sont là pour permettre de ne pas devoir attendre trop longtemps en cas de plantage du programme au mauvais moment. Le dernier fichier non vide contient les infos affichées à l'écran peu avant le plantage.

Il n'est pas indispensable d'effacer ces fichiers avant de lancer un calcul.

Ces fichiers sont stockés dans le répertoire %APPDATA%\sbs\Routeur. (sisi, vous pouvez taper ça dans l'explorateur windows et ça fonctionne)