QtVlm/en : Différence entre versions

De VlmWiki
 
(246 révisions intermédiaires par 6 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
[[Image:QtVlm.jpg|right]]
+
[[Image:QtVlm_bis.jpg]]
 
{{Languages|QtVlm}}
 
{{Languages|QtVlm}}
 +
 
= Project's goals=
 
= Project's goals=
  
 +
QtVlm is a routing and a navigation software for sailing boats. QtVlm can be used in two modes:
 +
* '''Virtual Racing''' designed to manage and pilot virtual boats from [http://www.virtual-loup-de-mer.org '''Virtual loup de mer'''] VLM virtual races.
 +
* '''Real Boats''' connected (or not) to a GPS device. A specific and '''complete documentation for real mode''' is available [http://download.meltemus.com/qtvlm/qtVlm_documentation_en.pdf '''here''']
  
This project is located at [http://www.sf.net/projects/qtvlm Sourceforge]
+
QtVlm uses boat polar diagrams and grib weather files, and includes
 +
* ''Routing'' module (isochrons method), 
 +
* ''Route'' module respectively allowing route optimization and waypoints management.  
  
QtVlm is a graphical interface for managing and piloting virtual boats [http://www.virtual-loup-de-mer.org Virtual loup de mer]. It can also be used for '''real boats''', connected to a GPS.
+
Last news and announcements are posted here [http://www.virtual-winds.org/forum/qtvlm qtVlm forum]
  
QtVlm includes a routing module (isochrons method), and a route module allowing an easy waypoint manipulation and optimization.  
+
English Discussion Thread on Cruiser's Forum
 +
[http://www.cruisersforum.com/forums/f121/free-routing-software-qtvlm-74738.html qtVlm Free Routing Software]
  
Last news and annoncements here (in french) [http://www.virtual-winds.com/forum/index.php?showtopic=6638&view=findpost&p=180191 qtVlm forum]
+
See installation notes below for Windows, MacOS, Linux and Raspberry. An Android and an iOS version are also available on the respective store.
  
 
= Installation =
 
= Installation =
Ligne 17 : Ligne 24 :
 
== Windows Installation==
 
== Windows Installation==
  
* Download last full version including maps [http://www.virtual-winds.com/~oxygen/win_exe-3.2-3-full.zip win_exe-3.2-3-full], unzip it where you want.
 
* Download last update [http://www.virtual-winds.com/~oxygen/win_exe-3.2-7_32bits.zip win_exe-3.2-7_32bits.zip] or depending on your hardware [http://www.virtual-winds.com/~oxygen/win_exe-3.2-7_64bits.zip win_exe-3.2-7_64bits.zip], then unzip it in the same place, replacing all files.
 
* You can then execute qtVlm with all its functionnalities.
 
* A message will be displayed at application startup if a new version is available.
 
  
* previous qtVlm versions are here: [http://www.virtual-winds.com/~oxygen/index.php qtVlm pour Windows]
+
* Download last stable release [https://www.meltemus.fr/index.php/en/download/category/2-windows qtVlm for Windows] and launch application.
 +
* The installer will ask your choice, if you do not know, you can keep the default settings.
 +
* For maps you must select 'download maps' if you do not have them, or wait until the first execution of the program will ask you to  download the maps or to specify the folder where they are if you have already.
 +
* After installing, you can launch qtVlm user interface with all functions. Default language is French when starting, language can be modified to english on options menu.
 +
* A message will be displayed at application start up if a new release is available.
 +
 
  
 
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en Back to summary]]
 
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en Back to summary]]
  
== Installation sur Mac ==
+
== Macintosh Installation ==
  
  
* Téléchargez la version complète contenant les cartes [http://www.virtual-winds.com/~oxygen/mac/qtVlm_app-3.2.3-full.zip qtVlm_app-3.2.3-full], dézippez à l'endroit de votre choix.
+
* Download the last release [https://www.meltemus.fr/index.php/en/download/category/3-mac-os qtVlm for MacOS]
* Téléchargez la nouvelle version [http://www.virtual-winds.com/~oxygen/mac/qtvlm_app-3.2.7.zip qtvlm_app-3.2.7.zip], puis extraire tout le contenu du fichier zip dans votre répertoire QtVlm et écraser ainsi les anciens.
+
* Copy the dmg content somewhere, and you can start using qtVlm from there. Do not run qtVlm directly from the dmg, it won't work because the dmg is readonly.
* Vous pouvez alors double cliquer sur qtVlm et avoir une application opérationnelle...
 
  
* Les anciennes versions de qtVlm sont ici: [http://www.virtual-winds.com/~oxygen/mac/ qtVlm pour Macintosh]
 
  
Merci a Farangfrog pour la compilation.
+
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en Back to summary]]
  
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm Retour au Sommaire]]
+
== Linux Installation ==
  
== Installation sous Linux ==
+
Download [https://www.meltemus.fr/index.php/en/download/category/4-linux qtVlm for Linux]
 +
Uncompress the file somewhere, and start qtVlm from there.
  
  
'''Debian / Ubuntu :'''
+
qtVlm n'est plus disponible dans un dépôt( avis aux amateurs ).
+
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en Back to Summary]]
 
 
 
 
 
 
'''Autres linux :'''
 
  
*Tout d'abord, si vous n'avez pas Qt (4.7.x ou 4.8.0), il vous faut installer le dernier environnement de développement Qt: [http://www.qtsoftware.com/downloads]. Depuis votre distribution, cela revient à installer la bibliothèque ''libqt4-dev'' (et ses dépendances).
+
== zyGrib POIs==
  
*Il n'y a pas pour l'instant de paquet avec un exécutable. Il est donc nécessaire de compiler à partir des sources disponible dans cette archive : [http://qtvlm.svn.sourceforge.net/viewvc/qtvlm/trunk.tar.gz?view=tar]
 
  
*Copiez cette archive dans votre /home. Clic droit et "extraire ici".
+
You can eventually import zyGrib POIs into qtVlm.
  
*Ouvrez un terminal ou console ou shell et rendez vous dans le répertoire trunk en tapant : ''cd trunk'', puis compilez en tapant ''make''. Cela peut prendre plusieurs minutes. Le terminal vous montre la progression de la compilation.
 
 
*Allez chercher les cartes et autres polaires ici ([http://sourceforge.net/svn/?group_id=247045 qtVlm SVN]) et téléchargez la dernière version.
 
  
*Après extraction, copiez ces dossiers dans le dossier trunk qui se trouve lui-même dans votre /home.
+
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en Back to Summary]]
  
Il manque des cartes et des polaires. Si vous lancer qtVLM maintenant, vous ne verrez pas les côtes et ne pourrez pas naviguer en 70 pieds.
+
= Main Functions =
  
*Pour les polaires du 70 pieds, télécharger le ici : [http://www.virtual-loup-de-mer.org/Polaires/boat_VO70.csv] et copier ce fichier dans /trunk/polar
 
  
*Pour les cartes, téléchargez cette archive : [http://www.virtual-winds.com/maitai/newGshhs.zip] . Après extraction, ne copiez pas le dossier newGshhs dans les maps ou le trunk, cela ne marchera pas. Ouvrez le dossier newGsHHs et copiez l'ensemble du contenu (ctrl+a puis ctrl+c). Allez dans le dossier maps et dans le dossier Gshhs et coller (ctrl+v) en acceptant de remplacer si on vous le demande.
 
  
C'est finit, il suffit de cliquer sur qtVlm et de s'amuser.
+
* qtVlm is a '''Grib Viewer''' (qtVlm is derived from zyGrib) and a '''routing software'''
   
+
* Download and load grib files from VLM (5 days), zyGrib (1 to 8 days) or SailDocs (1 to 16 days). QtVlm accepts many other grib sources.
 +
* Display meteo faxes
 +
* Two Modes:  [[QtVlm_Virtual_Race_Mode | ''Virtual Race Mode'']]: Configure VLM player account and boats, or [[Real_boat_management | ''Real Boat Management Mode'']]: Define a real boat connected or not to a GPS
 +
* Send GPS trace to a port, for other applications (Google Earth, routing software, ...)
 +
* Define routes (succession of waypoints) with many options (route from boat or from a fix point, starting time, navigation mode, coast collision, etc)
 +
* Calculate where you will be after a given time in several mode (fix TWA, fix heading, etc)
 +
* Move POIs and WPs (shift-click)
 +
* '''Create a routing''' and then convert it to a Route.
 +
* Display or not a Compass and the boat's polar on the map, with various options
 +
* Display/Hide various object on the map
 +
* Save 4 map positions/zooms via ctrl+F9/F12 et restore them via F9/12
 +
* and a lot more....
 
   
 
   
*Autre manière.
 
  
- (Étape facultative, mais néanmoins recommandée) Le code source intègre d’autres bibliothèques, cela dit il est préférable de s’appuyer sur les versions de ces bibliothèques fournies par votre distribution.
+
In case you use qtVlm to manage VLM virtual races, you can:
Les distributions linux intègrent notamment très fréquemment les bibliothèques ''libbz2'' (ou ''libbzip''), ''zlib1'' (ou ''zlib1g''), ''libqjson'' (ou ''libqjson0'')
 
Installez celles que vous pouvez ainsi que leur versions de développement (nommées *-dev ou *-devel).
 
  
- Ensuite, avec votre éditeur de texte préféré, commentez (avec un signe #) les lignes du fichier ''Makefile'' qui concernent les bibliothèques dont vous disposez.
+
* Visualize all your boats on the map
Par exemple, pour une distribution Ubuntu les bibliothèques ''libqjson'', ''zlib1g'' et ''libbz2'' sont disponibles dans les dépôts officiels. On peut donc modifier le ''Makefile'' de cette manière :
+
* Send orders to the selected boat
 +
* Manage auto pilot [[qtVlm_autopilot_VLM|VLM Autopilot management]]
 +
* Define your VLM current WP with a simple click [["Mon WP"/en|My WP]]
 +
* QtVlm will import and display automatically gates and race's WPs from VLM
 +
* Etc...
  
    #main makefile
 
    all:
 
    rm -f ./qtVlm
 
    # cd src/bzip2; qmake; make
 
    # cd src/zlib-1.2.3; qmake; make
 
        cd src/qextserialport; qmake; make
 
    # cd src/qjson; qmake; make
 
        cd src/c_lib; qmake; make
 
        cd src/nmealib/src; qmake; make
 
        cd src; qmake; make
 
  
- On peut maintenant lancer la compilation avec la commande ''make''.
+
* In order to preserve VLM servers, the refresh of the boat's position is not automatic, you need to press <VLM sync> or <F5> to update your VLM's position.
Si la compilation se termine bien, votre terminal doit afficher un message qui commence par ''make[1]'' et votre répertoire ''trunk'' contient désormais un exécutable nommé qtVlm.
 
  
*Il vous reste enfin à placer dans un même dossier cet exécutable et les répertoires contenus dans le l'archive "all_genTree".
 
  
*Vous pouvez maintenant utiliser qtVlm.
+
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en Back to Summary]]
  
 +
= Quick start up=
  
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm Retour au Sommaire]]
+
* First install the program
 +
* If you want to use qtVlm with VLM (Virtual Loop du Mer) Virtual Racing, you need to:
 +
** Register in VLM (free) http://www.virtual-loup-de-mer.org/
 +
** Join a race on VLM site (free): http://www.virtual-loup-de-mer.org/
 +
** Start QtVlm go to boat menu to define your account [[qtVlm_menus#Boat Menu|(more help)]]
 +
* In the toolbar select the boat you want to send order to (14) on [[qtVlm_toolBar|qtVlm toolbar]]
 +
* You then need to load a Grib file from the Grib menu. To start with something select VLM grib. After download the grib is displayed. In the toolbar you can click on the arrows (7) and (9) on [[qtVlm_toolBar|qtVlm toolbar]] to change the date/time displayed.
 +
* Create a route with menu Routes>Create a route ([[qtVlm_create_a_route|more help]])
 +
* Create 2 waypoints (POIs) by right-clicking somewhere on the map, call them POI_1 and POI_2 for instance. In the dialog assign them to the route you just created. ([[qtVlm_create_a_POI|more help]])
 +
* By default intermediary POIs are not displayed. You can change this behavior in the route's options.
 +
* The route takes WPs in alphabetical order, so it will first go from you boat to POI_1 and then from POI_1 to POI_2. If the option "Detect Coast Collision" is activated, the route will change color if crossing coasts.
 +
* You can then for instance move the last POI with <shift-click> and see the date of arrival (ETA) being recalculated.
 +
* To start, setup the boat in VBVMG mode (VBVMG button on the boat's panel [[qtVlm_componants|more help]]) to the first WP (POI_1) (Right click on it and select "mark->WP VLM")
 +
* This intermediary POI can be moved with <shift-click/drag> ([[qtVlm_do_route|more help]]).
 +
* You can also automatically optimize the POI position on the route (right-click, menu "Optimize").
 +
* QtVlm also has a routing module, available in the menu 'Routing->Create a routing' [[Routing with qtVlm|(more help)]]
  
== Les POI de zyGrib ==
 
  
 +
* '''For more details see:''' [[Tuto_video_pour_qtVlm|video tutorial]]
 +
  
Si vous utilisiez zyGrib, ses POI seront automatiquement copiés dans qtVlm et supprimés de zyGrib.
 
  
 +
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en Back to Summary]]
  
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm Retour au Sommaire]]
+
= qtVlm interface =
  
= Principales Fonctions =
 
  
 +
Main qtVlm components are visible in this image:
  
Interfacé directement avec VLM, le logiciel QtVlm fournit :
+
* [[qtVlm_title_bar|qtVlm title bar]]
 +
* [[qtVlm menus|qtVlm menus]]
 +
* [[qtVlm_toolBar|qtVlm toolbar]]
 +
* [[QtVlm_componants|qtVlm components]]
 +
* [[qtVlm_statusBar|qtVlm status bar]]
 +
* [[qtVlm_maps|qtVlm maps]]
 +
* [[qtVlm_compass_polar|qtVlm compass and polar]]
  
* Une '''visualisation des données météo''' contenues dans des fichiers GRIB sur 8 jours (merci à Zygrib)
 
* La possibilité de charger la météo globale de VLM sur 3 jours, 8 jours ou 16 jours (SailDocs)
 
* La possibilité de charger des météoFax
 
* Une déclaration des comptes et des bateaux rattachés à ce compte, ou d'un bateau réel connecté à un GPS
 
* La '''visualisation des bateaux''' sur la même carte et passage du contrôle d’un bateau à l’autre par simple clic de sélection
 
* Toutes les commandes existantes actuellement dans VLM permettant de '''contrôler la marche du bateau''' sélectionné
 
* L'interface permettant de '''suivre et programmer les ordres''' du  pour chacun des bateaux contrôlés [[http://wiki.virtual-loup-de-mer.org/index.php/Programmer_le_Pilototo_VLM_via_QtVlm|"Pilototo"]]
 
* Une interface GPS en sortie vers tout logiciel acceptant ces données en entrée (Google Earth, routeurs, ...)
 
* La '''gestion et l'affichage de multiples Way-Point''' (route à suivre) par bateau directement sur la carte avec un horodatage possible des WPs affichés sur la carte et '''détection de collision avec la cote'''
 
* La visualisation de la route prévue à allure constante (TWA) ou en cap fixe
 
* L'enregistrement dans VLM des informations [["Mon WP"]] pour les bateaux contrôlés par simple clic sur la carte
 
* La gestion de routes multiples pouvant démarrer à partir d'un boat ou d'un POI, et à une heure choisie, et qui se recalculent dynamiquement pendant le déplacement des POI
 
* La '''création d'un routage''' entre le bateau et un WP
 
* Un compas déplaçable accompagné ou non d'une polaire, avec centrage automatique sur le bateau ou le wp actif.
 
* Des infos best-Vmg vent théoriques dans le panel VLM
 
* L'import automatique des WPs et portes de la course.
 
* Une option de centrage auto ou non à chaque synchro VLM
 
* Une possibilité d'afficher/cacher les différents types d'objets affichés
 
* Une sauvegarde de 4 positions/zooms via ctrl+F9/F12 et restauration via F9/12
 
  
* Afin de préserver les serveurs de VLM, le rafraichissement des positions des bateaux sur la carte et des données affichées ne sont pas automatiques. Un bouton « Boat Sync » permet de récupérer les données VLM et de rafraichir les informations (positions des bateaux sur la carte et infos VLM1 et VLM2).
+
[[Image:Interface.jpg]]
* Toutes les fonctionnalités déjà existantes sur Zygrib ont été conservées (ex : téléchargement des données météo et options d’affichage)
 
 
 
 
 
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm Retour au Sommaire]]
 
 
 
= Prise en main rapide de QtVlm=
 
  
* D'abord installez le programme[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm#Installation_sous_Windows]]
 
* QtVlm ne peut créer ni un compte, ni un bateau, ni s'inscrire à une course. Le faire sur le site VLM: http://www.virtual-loup-de-mer.org/
 
* Démarrez QtVlm et cliquez sur le 'menu bateau' pour intégrer son compte.[[http://wiki.virtual-loup-de-mer.org/index.php/Barre_de_menu_de_QtVlm]]
 
* Cliquez dans la barre des outils et selectionnez le bateau à régler(14) [[http://wiki.virtual-loup-de-mer.org/index.php/Barre_d'outils_de_QtVlm]]
 
* Sur la carte centrée sur votre bateau, il vous faut maintenant charger le Fichier Méteo. Cliquez dans la barre des menus Fichier Grib>Téléchargement VLM. La méteo s'affiche avec code de couleur et fleche suivant le vent. Cliquez dans la barre d'outils les fleches (7) et (9) [[http://wiki.virtual-loup-de-mer.org/index.php/Barre_d'outils_de_QtVlm]]pour avancer ou reculer la date de la météo affichée.
 
* Créez un route avec le Menu Routes>Créer un route, vous lui donnez un nom évocateur (ROF pour Ring Of Fire p.e.) ([[Créer une route |Plus d'aide]])
 
* Créez deux Way-Points(WP) en cliquant bouton-droit sur la carte ( Positionner une nouvelle marque). Dans la Box sélectionnez dans la combobox le nom de la route que vous venez de créer. ([[Créer un point géographique POI |Plus d'aide]])
 
* Sur la route, l'ordre de passage des WP se fait suivant l'ordre alphabétique. La forme de la route est la prévision du parcours calculée, ce qui permet de vérifier si la route ne recontre pas la cote ... (si l'option détection des cotes est activée, la route change de couleur )
 
* Le dernier WP sera positionné (Maj+Clic Gauche+Glissée de souris) à l'endroit de passage désiré( par exemple une Porte). La date de passage indiquée dans l'étiquette est celle calculée par le programme suivant la météo actuelle.
 
* Pour débuter, réglez le bateau avec VBVMG (clic sur le bouton VBVMG de la barre latérale VLM[[http://wiki.virtual-loup-de-mer.org/index.php/Bandeau_de_composant_VLM]]) vers le second WP (clic droit sur le WP et sélectionnez Marque>WP)
 
* Le WP intermédiaire pourra être bougé avec un 'Maj+Clic Gauche et glissé de souris', la date du passage dans l'étiquette du WP suivant recalculé en direct. Lorsque la position vous parait satisfaisante, relachez le bouton de la souris le WP change de position.  ([[Faire sa route |Plus d'aide]])
 
* En cliquant droit sur un WP, un menu déroulant apparait. Sélectionnez 'Optimiser le placement de la marque'.... La recherche du meilleur placement est automatique.
 
* Votre optimisation de la route est faite. Réglez le premier WP comme nouvelle cible de VBVMG (Clic Droit sur le premier WP et sélectionnez Marque>WP). Cliquez sur VLM synchro [[http://wiki.virtual-loup-de-mer.org/index.php/Bandeau_de_composant_VLM]], si vous n'avez pas mis cette option en automatique, et chaque fois après avoir modifié un réglage.
 
* QtVlm a un module de routage. On peut l'activer avec le menu 'Routage>Créer un nouveau Routage' [[Le routage avec qtVlm]]
 
  
 +
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en Back to Summary]]
  
** '''Pour plus de précisions voir:''' [[Tuto_video_pour_qtVlm]]
+
= Tutorials =
 
  
 +
* [[qtVlm_Importing_a_grib|Loading a grib]]
 +
* [[qtVlm_zoom_on_map|Zooming/Unzooming]], [[qtVlm_center_map|Center map]]
 +
* [[qtVlm_poi_mngt|POIs management]], [[qtVlm_create_a_POI|POI creation]], [[qtVlm_make_my_wp|make a POI the active WP]], [[qtvlm_assign_poi_to_route|Assign a POI to a route]], [[qtVlm_add_POIs_to_route|POIs and route]]
 +
* [[qtVlm_create_a_route|Route creation]]
 +
* [[qtVlm_do_route|Manipulating routes]]
 +
* [[qtVlm_autopilot_VLM|VLM Autopilot management]]
 +
* '''[[Routing with qtVlm]]'''
 +
* [[qtVlm_grib_esteem|Drawing a grib Esteem]]
 +
* '''[[Real boat management]]'''
 +
* [[qtVlm_meteo_faxes|Meteo faxes]]
 +
<!--* [[Router dans le passé (à postériori) avec des gribs anciens (archives)]]-->
 +
* [[Tuto video pour qtVlm|video tutorial for qtVlm]]
  
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm Retour au Sommaire]]
+
* [[QtVlm Virtual Race Mode]] - Learning Mode
 +
** Refer to Quick Startup above. Install qtVlm
 +
** Register for a free account at the [[http://www.virtual-loup-de-mer.org/index.php?&lang=en Vlm Virtual Loop du Mer website]]. [http://www.cruisersforum.com/forums/f121/vend-e-globe-round-the-world-race-92406.html#post1078328 Post Describing the process]- Create a page later.
 +
** On VLM also sign up for a race that will start soon.
 +
** Sign up for a race on the VLM website, then it will appear in qtVlm after you sign in using your VLM name and pass.
 +
** [[QtVlm_account_management]] Once you've signed up for a race log into VLM through qtVlm using your name (email) and pass.
 +
** [[QtVlm_boat_config]]  Name and configure your boat.
 +
** [[QtVlm_boat_parameters]] Learn about and set your boat parameters. (Polars will be assigned when you join a virtual race.
 +
** [[QtVlm_Virtual_Race_Mode#Menus_and_Shortcuts_Reference |Menus and Shortcuts]]
 +
** [[QtVlm_Virtual_Race_Mode#Download_a_Grib_File_first_-_Grib_Files_and_Use |Download a Grib File first - Grib Files and Use]]
 +
** [[QtVlm_Virtual_Race_Mode#Make_a_Mark_or_POI_to_head_towards_and_Make_a_Barrier |Make a Mark or POI to head towards, or Make a Barrier]]
 +
** [[QtVlm_Virtual_Race_Mode#Learn_about_the_Difference_between_a_Routing_and_a_Route |Learn about the Difference between a Routing and a Route]]
 +
** [[QtVlm_Virtual_Race_Mode#Next_Create_a_Routing_-_Use_of_Routing_Create |Next Create a Routing - Use of Routing Create]]
 +
** [[QtVlm_Virtual_Race_Mode#Convert_a_Routing_to_a_Route |Convert a Routing to a Route]]
 +
** [[QtVlm_Virtual_Race_Mode#Simplify_and_Optimize_the_Route_-_Use_of_Route_Edit |Simplify and Optimize the Route - Use of Route Edit]]
 +
** [[Les_modes_de_pilotage/en | Pilot Mode]] To begin learn routing & routes, use VBVMG, Very Best VMG.
 +
** [[QtVlm_Virtual_Race_Mode#Send_the_Route_to_the_server_-_Use_of_Routes_Edit_Autopilot_Tab |Send the Route to the Autopilot server - Use of Routes Edit Autopilot Tab]]
 +
** [[QtVlm_Virtual_Race_Mode#Other_use_of_Routes |Other use of Routes]]
 +
** [[QtVlm_Virtual_Race_Mode#Long_Race_Techniques_-_Virtual_Racing |Long Race Techniques - Virtual Racing]]
  
= L'interface de QtVlm =
+
----
  
  
Les composants graphiques majeurs de QtVlm sont visibles dans la capture ci-dessous :
+
== List of English Pages ==
  
* La [[barre de titre de QtVlm]]
+
* [[Welcome]]
* La [[barre de menu de QtVlm]]
 
* La [[barre d'outils de QtVlm]]
 
* Le [[bandeau de composant VLM]]
 
* La [[barre d'état]]
 
* La [[carte]]
 
* Le [[compas et la polaire QtVlm]]
 
  
 +
Two Modes
 +
* [[QtVlm_Virtual_Race_Mode]]
 +
* [[Real_boat_management]]
  
[[Image:Interface.jpg]]
+
Menu
 +
* [[QtVlm_menus]]
 +
* [[Menu_Display]]
 +
* [[Menu_Information]]  Translate
 +
* [[Menu_Action]]    Translate
 +
* [[Menu_Meteo]]    Translate
  
 +
Setup
 +
* [[QtVlm_account_management]]
 +
* [[QtVlm_boat_config]]
 +
* [[QtVlm_boat_parameters]]
 +
* [[QtVlm_study_polar]]
 +
* [[QtVlm_Polar_Diagram]] Describes Polar Diagram Format and gives Polar sources
 +
* [[Polaires]] Explanation of How Polar Diagrams work. Translate
 +
* [[QtVlm_Boat_Polars]] Polars used in VLM Virtual Races, all players use same assigned polar.
 +
* [[QtVlm_graphic_parameters]]
 +
* [[QtVlm_VLM_parameters]]
  
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm Retour au Sommaire]]
+
Interface
 +
* [[QtVlm_title_bar]]
 +
* [[QtVlm_toolBar]]
 +
* [[QtVlm_componants]]
 +
* [[QtVlm_statusBar]]
 +
* [[QtVlm_maps]]
 +
* [[QtVlm_compass_polar]]
 +
* [[QtVlm_componants]]
  
= Quelques tutoriels en images =
+
Moving Around
 +
* [[QtVlm_center_map]]
 +
* [[QtVlm_zoom_on_map]]
  
* [[Importer un grib]]
+
Gribs, Weather and Weather tools
* [[Zoomer sur la carte]],[[Recentrer la carte]]
+
* [[QtVlm_Importing_a_grib]]
* [[Gestion des Way-point:WP]],[[Créer un point géographique POI]],[[Transformer un POI en WP-VLM]],[[Transformer un POI en point-route]],[[Supprimer un POI]],[[Créer un waypoint et le valider sur VLM]],[[Ajouter des waypoints sur une route]]
+
* [[QtVlm_grib_date]]
* [[Créer une route]]
+
* [[QtVlm_Draw_grib_estimated_road]] How to advance or delay Grib timing, for advanced users.
* [[Faire sa route]]
+
* [[SailDocs_qtvlm]]     How to email for a grib.  Translate
* [[Programmer le Pilototo VLM via QtVlm]]
+
* [[QtVlm_meteo_faxes]] Describes how to overlay a Meteo Fax in qtVlm, useful.
* [[Le routage avec qtVlm]]
+
* [[QtVlm_Weather_Tools]] More extensive list of weather gribs, advisories and sources
* [[Traçer une estime grib de la route]]
 
* [[Visualiser les 60° Sud ou une porte de glace]]
 
* [[Régler QtVlm pour gérer un 'vrai' bateau]]
 
* [[Afficher un MétéoFax et le comparer avec un grib]]
 
* [[Router dans le passé (à postériori) avec des gribs anciens (archives)]]
 
* [[Tuto video pour qtVlm]]
 
  
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm Retour au Sommaire]]
+
Marks, POI, Waypoints, Routes
 +
* [[QtVlm_create_a_POI]]
 +
* [[QtVlm_poi_mngt]]
 +
* [[QtVlm_create_a_route]]
 +
* [[QtVlm_add_POIs_to_route]]
 +
* [[Qtvlm_assign_poi_to_route]]
 +
* [[QtVlm_do_route]]
 +
* [[Routing_with_qtVlm]]
 +
* [[QtVlm_make_my_wp]]
 +
* [[%22Mon_WP%22/en]] from VLM, qtVLM is the same, very comprehensive explanation.
  
= Fichiers météo '*.grb' =
+
Autopilot
 +
* [[QtVlm_autopilot_VLM]]
 +
* [[Pilot_mode]]
 +
* [[Les_modes_de_pilotage/en]] Basic Explanation Concepts of VMG, Orthodronic, Best VMG etc.
  
== Fichiers VLM à 4 jours ==
+
FAQ
 +
* [[Faq_QtVlm/en | FAQ QtVlm]]
 +
* [[En:FAQ | FAQ VLM]]
  
Récupérables directement à partir de la barre d'outils de QtVlm
+
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en Back to Summary]]
  
Couvrent le monde entier
+
= Grib files '*.grb' =
  
4 mises à jour / jour
+
== VLM gribs (5 days) ==
  
Heures de référence : 00 h, 06 h, 12 h, 18 h TU
+
Can be downloaded directly from qtVlm toolbar
  
Fichiers disponibles environ 4h10 plus tard, soit à : 04h10, 10h10, 16h10, 22h10 TU (suivant disponibilite de NOAA)
+
All world coverage
  
Fichier 'interim' disponible 35' plus tot
+
Updated 4 times a day
  
== Fichiers zyGrib-VLM à 7 jours ==
+
Reference time : 00h, 06h, 12h, 18h UTC
  
Récupérables directement à partir de la barre des menus de QtVlm (chemin: Fichier GRIB\Téléchargement)
+
Files are available around 4h20 later, i.e. 04h20, 10h20, 16h20, 22h20 UTC (depends also on NOAA availability)
  
Avant de télécharger le fichier météo '*.grb', il faut définir une zone de navigation à l'aide de la souris (faire glisser la souris, clic gauche enfoncé)
+
An interim file is available 35mn before, containing only 12h of forecast.
  
 +
== Zygrib grib files (up to 8 days) ==
  
 +
Can be downloaded directly from qtVlm toolbar
  
4 mises à jour / jour
+
before you can download such a grib file, you must first select a zone on the map.
  
Heures de référence : 00 h, 06 h, 12 h, 18 h TU
 
  
Fichiers disponibles environ 5h05 plus tard, soit à : 05h05, 11h05, 17h05, 23h05 TU
+
Updated 4 times a day
  
(actuellement, le 24/08/2010, disponibles environ 5h00 plus tard, soit à : 05h00, 11h00, 17h00 23h00 TU)
+
Reference time : 00h, 06h, 12h, 18h UTC
  
Pour savoir l'heure de référence du fichier téléchargé: depuis la barre des menus de QtVlm : Fichier GRIB\Informations sur le fichier
+
Files are available around 5h05 later, i.e. 05h05, 11h05, 17h05, 23h05 UTC
  
  
 +
== UGrib grib files (up to 7 days) ==
  
== Fichiers Ugrib à 7 jours ==
+
Available here: [http://grib.us grib.us]
  
Récupérables sur le site : [http://grib.us grib.us]
+
You must register and give an email address. Free.
  
Pratique pour la sélection de zones de navigation et obtenir des fichiers partiels plus légers
 
  
Il faut donner son adresse e-mail pour s'inscrire (gratuit)
 
  
 +
4 mises à jour / jour
  
 +
Updated 4 times a day
  
4 mises à jour / jour
+
Reference time : 00h, 06h, 12h, 18h UTC
 
 
Heures de référence : 00 h, 06 h, 12 h, 18 h TU
 
  
Fichiers disponibles environ 5h25mn plus tard, soit à : 05h25, 11h25, 17h25, 23h25 TU
+
Files are available around 5h25 later, i.e. 05h25, 11h25, 17h25, 23h25 UTC
  
Ces fichiers peuvent être légèrement différents de ceux de VLM
+
These files can be slightly different from the ones from VLM
  
  
  
== Fichiers Saildocs à 16 jours ==
+
== Saildocs grib files
 +
(up to 16 days) ==
  
Récupérables par courriel (gratuit). Attention votre logiciel de messagerie peut le considérer comme un spam et le traiter comme indésirable. Faites les réglages de votre logiciel en conséquence.
+
Avalaible through email (free of charge). Make sure that your email will not considerer this as spam.
  
Modalités pour se faire envoyer les prévisions météo:
+
To receive a sailDocs grib file:
  
Envoyer sa demande à : query@saildocs.com, la réponse est rapide par messagerie
+
* Select a zone on the map in qtVlm
 +
* Click on the sailDocs icon (or Grib File->Download from SailDocs)
 +
* If you have selected a client-mail software in the option, qtVlm will generate the message and you just have to send it. Otherwise:
 +
* Select the text in the text box containing the query and copy in the clipboaard (CTRL-C)
 +
* Open your mail software
 +
* Create a new message to 'query@saildocs.com'
 +
* Give it a subject (can be whatever you want, but cannot be empty)
 +
* Paste the query in the message's body
 +
* Send the mail
  
    * Mettre ce que l'on veut en 'sujet' du message (le nom de la zone sélectionnée, par exemple)   
+
All informations on the request syntax are here: [http://www.saildocs.com/gribinfo saildocs.com]
    * Libeller le message de la façon suivante: send gfs:xxS,xxS,xxW,xxW|0.5,0.5|0,3..72|wind
 
    * Bien faire attention à la ponctuation + pas d'espace entre les données
 
    * xxS,xxS,xxW,xxW : la zone demandée (peut être xxN,xxS,xxW,xxE...)
 
    * Par exemple : gfs:41S,55S,140W,179W|0.5,0.5|0,3..72|wind (= 41°S limite Nord, 55°S limite Sud, 179°W limite Ouest, 140°W limite Est)
 
    * 0.5 : la grille = une info 'vent' par maille de 0.5° de côté (possible jusqu'à 180h, au-delà et jusqu'à 384h: mailles de 2.5° de côté)
 
    * 0,3..72 : les prévisions de 0 à 72 h avec une donnée toutes les 3 h (possible jusqu'à 180 h, au-delà et jusqu'à 384 h: toutes les 12 h)
 
    * Pour les fichiers au-delà de 180h, le libellé du message sera donc: send gfs:xxS,xxS,xxW,xxW|2.5,2.5|180,192..384|wind
 
    * Si vous récupérez un petit fichier (quelques ko), il est probable que cela soit dû à une zone demandée trop importante
 
    * Info complète (en anglais) sur : [http://www.saildocs.com/gribinfo saildocs.com]
 
  
* N.B.: Vous pouvez vous servir des chiffres de votre zone Ugrib ou zyGrib-VLM (sans décimale) pour votre demande de fichier Saildocs !
 
  
== Autres sites où l'on peut avoir des infos météo ==
+
== Other sites ==
  
 
Voir: [http://wiki.virtual-loup-de-mer.org/index.php/Outils_m%C3%A9t%C3%A9os Wiki-VLM]
 
Voir: [http://wiki.virtual-loup-de-mer.org/index.php/Outils_m%C3%A9t%C3%A9os Wiki-VLM]
  
  
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm Retour au Sommaire]]
+
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en Back to Summary]]
 
 
= FAQ =
 
 
 
 
 
Vos questions concernant l'installation ou l'utilisation de QtVlm ont peut-être leur réponse dans les [[Faq_QtVlm|FAQ QtVlm]]
 
 
 
 
 
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm Retour au Sommaire]]
 
 
 
= Bugs et features =
 
 
 
  
Si vous trouvez un bug merci de le poster ici: [http://sourceforge.net/tracker2/?func=add&group_id=247045&atid=1126171 bugs]
+
= FAQ, Bugs and Features =
  
Pour avoir de nouvelle fonctionnalités merci de poster vos demandes ici: [http://sourceforge.net/tracker2/?func=add&group_id=247045&atid=1126170 features]
 
  
 +
[[Faq_QtVlm/en |FAQ QtVlm]]
  
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm Retour au Sommaire]]
+
[http://www.virtual-winds.org/forum/index.php?showtopic=6638&view=getnewpost|Official qtVlm forum] (don't hesitate to post in English). Registration is compulsory and free.
  
  
= Développement en cours =
 
  
[[Dev_QtVlm|Page des developpeurs]]
+
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en Back to Summary]]
  
[[http://wiki.virtual-loup-de-mer.org/index.php/QtVlm Retour au Sommaire]]
 
  
 
[[Catégorie:qtVlm]]
 
[[Catégorie:qtVlm]]

Version actuelle datée du 12 février 2020 à 15:38

QtVlm bis.jpg

Project's goals

QtVlm is a routing and a navigation software for sailing boats. QtVlm can be used in two modes:

  • Virtual Racing designed to manage and pilot virtual boats from Virtual loup de mer VLM virtual races.
  • Real Boats connected (or not) to a GPS device. A specific and complete documentation for real mode is available here

QtVlm uses boat polar diagrams and grib weather files, and includes

  • Routing module (isochrons method),
  • Route module respectively allowing route optimization and waypoints management.

Last news and announcements are posted here qtVlm forum

English Discussion Thread on Cruiser's Forum qtVlm Free Routing Software

See installation notes below for Windows, MacOS, Linux and Raspberry. An Android and an iOS version are also available on the respective store.

Installation

Windows Installation

  • Download last stable release qtVlm for Windows and launch application.
  • The installer will ask your choice, if you do not know, you can keep the default settings.
  • For maps you must select 'download maps' if you do not have them, or wait until the first execution of the program will ask you to download the maps or to specify the folder where they are if you have already.
  • After installing, you can launch qtVlm user interface with all functions. Default language is French when starting, language can be modified to english on options menu.
  • A message will be displayed at application start up if a new release is available.


[Back to summary]

Macintosh Installation

  • Download the last release qtVlm for MacOS
  • Copy the dmg content somewhere, and you can start using qtVlm from there. Do not run qtVlm directly from the dmg, it won't work because the dmg is readonly.


[Back to summary]

Linux Installation

Download qtVlm for Linux Uncompress the file somewhere, and start qtVlm from there.


[Back to Summary]

zyGrib POIs

You can eventually import zyGrib POIs into qtVlm.


[Back to Summary]

Main Functions

  • qtVlm is a Grib Viewer (qtVlm is derived from zyGrib) and a routing software
  • Download and load grib files from VLM (5 days), zyGrib (1 to 8 days) or SailDocs (1 to 16 days). QtVlm accepts many other grib sources.
  • Display meteo faxes
  • Two Modes: Virtual Race Mode: Configure VLM player account and boats, or Real Boat Management Mode: Define a real boat connected or not to a GPS
  • Send GPS trace to a port, for other applications (Google Earth, routing software, ...)
  • Define routes (succession of waypoints) with many options (route from boat or from a fix point, starting time, navigation mode, coast collision, etc)
  • Calculate where you will be after a given time in several mode (fix TWA, fix heading, etc)
  • Move POIs and WPs (shift-click)
  • Create a routing and then convert it to a Route.
  • Display or not a Compass and the boat's polar on the map, with various options
  • Display/Hide various object on the map
  • Save 4 map positions/zooms via ctrl+F9/F12 et restore them via F9/12
  • and a lot more....


In case you use qtVlm to manage VLM virtual races, you can:

  • Visualize all your boats on the map
  • Send orders to the selected boat
  • Manage auto pilot VLM Autopilot management
  • Define your VLM current WP with a simple click My WP
  • QtVlm will import and display automatically gates and race's WPs from VLM
  • Etc...


  • In order to preserve VLM servers, the refresh of the boat's position is not automatic, you need to press <VLM sync> or <F5> to update your VLM's position.


[Back to Summary]

Quick start up

  • First install the program
  • If you want to use qtVlm with VLM (Virtual Loop du Mer) Virtual Racing, you need to:
  • In the toolbar select the boat you want to send order to (14) on qtVlm toolbar
  • You then need to load a Grib file from the Grib menu. To start with something select VLM grib. After download the grib is displayed. In the toolbar you can click on the arrows (7) and (9) on qtVlm toolbar to change the date/time displayed.
  • Create a route with menu Routes>Create a route (more help)
  • Create 2 waypoints (POIs) by right-clicking somewhere on the map, call them POI_1 and POI_2 for instance. In the dialog assign them to the route you just created. (more help)
  • By default intermediary POIs are not displayed. You can change this behavior in the route's options.
  • The route takes WPs in alphabetical order, so it will first go from you boat to POI_1 and then from POI_1 to POI_2. If the option "Detect Coast Collision" is activated, the route will change color if crossing coasts.
  • You can then for instance move the last POI with <shift-click> and see the date of arrival (ETA) being recalculated.
  • To start, setup the boat in VBVMG mode (VBVMG button on the boat's panel more help) to the first WP (POI_1) (Right click on it and select "mark->WP VLM")
  • This intermediary POI can be moved with <shift-click/drag> (more help).
  • You can also automatically optimize the POI position on the route (right-click, menu "Optimize").
  • QtVlm also has a routing module, available in the menu 'Routing->Create a routing' (more help)



[Back to Summary]

qtVlm interface

Main qtVlm components are visible in this image:


Interface.jpg


[Back to Summary]

Tutorials



List of English Pages

Two Modes

Menu

Setup

Interface

Moving Around

Gribs, Weather and Weather tools

Marks, POI, Waypoints, Routes

Autopilot

FAQ

[Back to Summary]

Grib files '*.grb'

VLM gribs (5 days)

Can be downloaded directly from qtVlm toolbar

All world coverage

Updated 4 times a day

Reference time : 00h, 06h, 12h, 18h UTC

Files are available around 4h20 later, i.e. 04h20, 10h20, 16h20, 22h20 UTC (depends also on NOAA availability)

An interim file is available 35mn before, containing only 12h of forecast.

Zygrib grib files (up to 8 days)

Can be downloaded directly from qtVlm toolbar

before you can download such a grib file, you must first select a zone on the map.


Updated 4 times a day

Reference time : 00h, 06h, 12h, 18h UTC

Files are available around 5h05 later, i.e. 05h05, 11h05, 17h05, 23h05 UTC


UGrib grib files (up to 7 days)

Available here: grib.us

You must register and give an email address. Free.


4 mises à jour / jour

Updated 4 times a day

Reference time : 00h, 06h, 12h, 18h UTC

Files are available around 5h25 later, i.e. 05h25, 11h25, 17h25, 23h25 UTC

These files can be slightly different from the ones from VLM


== Saildocs grib files

(up to 16 days) ==

Avalaible through email (free of charge). Make sure that your email will not considerer this as spam.

To receive a sailDocs grib file:

  • Select a zone on the map in qtVlm
  • Click on the sailDocs icon (or Grib File->Download from SailDocs)
  • If you have selected a client-mail software in the option, qtVlm will generate the message and you just have to send it. Otherwise:
  • Select the text in the text box containing the query and copy in the clipboaard (CTRL-C)
  • Open your mail software
  • Create a new message to 'query@saildocs.com'
  • Give it a subject (can be whatever you want, but cannot be empty)
  • Paste the query in the message's body
  • Send the mail

All informations on the request syntax are here: saildocs.com


Other sites

Voir: Wiki-VLM


[Back to Summary]

FAQ, Bugs and Features

FAQ QtVlm

qtVlm forum (don't hesitate to post in English). Registration is compulsory and free.


[Back to Summary]