QtVlm Virtual Race Mode

De VlmWiki


QtVlm Virtual Race Mode - Learning Notes

Menus and Shortcuts Reference

Wiki Menu and Keyboard Shortcuts

  • B - Center screen on your boat.
  • E - Show/hide labels
  • 0 - Show/hide opponents
  • P - Show/hide POI
  • R - Show/hide Routes

See See Wiki Menu page for other key shortcuts.

Center Chart To center chart at any point (use cursor, left click on the point, then right click and pick "Center here"


Download a Grib File first - Grib Files and Use

Download Grib

1. To download Saildocs Grib first Select an area with the cursor by picking opposite corners.

2. Pick "Gribfile > Download" or Download from VLM (easiest way). Follow prompts.

3. Pick "Gribfile > Open" and pick the most current grib file.

4. A grib file must be downloaded before a Routing can be done.

5. After you download and update to new grib files you should "Optimize" and "Simplify" your Route to update the optimal path with the new weather files. See notes below.

Grib Update Schedule and accuracy

VLM 5 days 04h20, 10h20, 16h20, 22h20 UTC; Intrm-35mn before(12h).....[23h20, 5h20, 11h20, 17h20 EST]

Zygrib 8 days 05h05, 11h05, 17h05, 23h05 UTC..........................................[0h05, 7h05, 12h05, 18h05 EST]

UGrib 7 days 05h25, 11h25, 17h25, 23h25 UTC..........................................[0h25, 6h25, 12h25, 18h25 EST]

Saildocs Up to 16 days, large files, File from NOAA, via Email

Accuracy and Route Information

VLM Files take the form "gfs_NOAA-2012121506.grb". The four daily VLM gribs begin with gfs_NOAA-[date] and end in "00", 06", "12", "18". The VLM 5 day grib file is used by the server to calculate all positions, for all virtual races and is the best one to use for preparation of 5 day, shorter more accurate "Routings" and "Routes" for the boat to follow during the race. For longer course planning the Saildocs grib recieved via email is useful. The Saildocs grib files differ slightly from VLM grib for the first 5 days, but offer up to 16 days and are good for approximation of longer routes which will change. Keep in mind that your boat's autopilot must be following a "Route" for as long as your next update interval, otherwise it will not progress and go off course. It is best to download a fresh grib shortly after it has become available. After selecting "GribFile/Download from VLM", you should "GribFile/Open" the file.

Also, each time there is an update of grib in the VLM Server (see schedule above) your route is not precise anymore. Since this it occurs every 6 hours there is a big chance you were sleeping at one point. When a new grib has been issued, it is very possible that your boat will no longer be following the optimized route. During this time, depending on the nature of the weather, the difference between the optimized route and the course your boat's autopilot is following may be larger or small (experience helps). In practice, if you know you will miss a [grib] meteo update (during sleep for example), prepare the route a bit differently, and don't sail too close to the rocks, or leave an adequately safe distance from the gates.

If you don't miss a meteo update and download a fresh grib each time, then the route is 100% accurate (maybe not the best, but what it shows is what the boat will do). Using qtVlm together with VLM you get exactly the same grib, interpolation algo for winds and polars, etc. Which is quite normal since it's made by the same team, and VLM/qtVLM are openSource anyway.

Once the skills for downloading gribs, using them appropriately, creating "Routings", converting to "Routes" and "Sending" to the Autopilot are mastered, you will have the challenge of predicting how the new grib file predictions will change between updates, in order to gain positions in the virtual race.

Make a Mark or POI to head towards and Make a Barrier

Create a POI Locate cursor, right click and select "Place a new Mark". A POI is Point of Interest.

Edit a POI right click on it and pick "Edit mark".

Drag a POI or Mark Push shift down and left mouse button while highlighting the POI. Then drag the POI and release the mouse button. Then release the shift key.

Delete multiple POI select a rectangular area with the cursor and mouse, right click and pick "Delete".

Barriers are created using two POI or Beacons to prevent the "Routing" algorythm from considering certain areas. Locate the two POI or Beacons, then right click and Pick "Draw/edit a line to another POI" At the present time, POI/Beacons can only accept one line (in pairs of POI).

It is a good idea to keep your POI list simple by deleting ones that are not needed to avoid confusion with selection of POI with the same name.

Learn about the Difference between a Routing and a Route

The two primary tools for optimizing routes are "Routing" and "Routes". Normally, after download of a current Grib file, you "Routing > Create a Routing" from your boat to a "Mark" or "POI" that you have created previously. Then from the "Routing > Edit" Route Settings dialogue box you can check "Convert to a Route" to do more "Simplification" and "Optimization".

Routing When learning, start first with a "Routing" which will calculate the best path from the boat or a start POI to the destination POI based on your boats polars and the weather grib, using the isochrons method. Avoid certain areas by putting "Barriers" on the map (see POI), but this is normally not needed. To create alternative child routes using "Right click - Create a Pivot" see notes below.

A "Routing" optimizes ETA using predicted wind from a Grib file, from the boat (or Mark) to a selected POI-Mark. Routings show "isochrones" which indicate lines of identical sailing time or ETA. These are similar to isobars (which show lines of the same pressure) but for sailing time or ETA. You will see "isochrones" that are close together, this means that sailing there is very slow (often caused by no or little wind). Conversely, if the isochrone lines are far apart then you are sailing faster in heavier winds. A "Routing" creates a good route optimization and shows the isochrones from the boat or the starting location. It is very important to select good destination points, by thinking about what the winds and weather is likely to do during the plotting and afterwards. It is helpful to study multiple "Routing"s. Once you have a "Routing" you like, it is time to convert it into a "Route". See "Convert to routing" below.

Convert to a Route Then to "Simplify" and "Optimize" the path to a POI that you created, the "Routing" must be converted to a "Route" by checking "Convert to a Route" in the "Edit Routing" Route Setting dialogue box.

Route Simplification: (Check in Edit Route dialogue box) Routings have one Intermediate POI at each isochrone crossing which requires "Simplification" in order to Send a short list of 6 POI to the Autopilot and not overburden the server. The Simplification process will remove all POIs that do not improve the ETA, (typically aligned POIs are often not needed). Optimization: (Check in Edit Route dialogue Box) Then eventually you can "Optimize" the "Route". Basically this process will try to reposition the POIs in better locations, because the routing process only looks at fix step (one hour), so it is understandable that a point might be better placed in between 2 isochrones. This is perfectionism, and IRL (in real life - actually sailing) not really useful, because the grib is not precise enough, however it is very useful in Virtual Racing (VLM), because the grib is of course 100% accurate in that case.

Next Create a Routing - Use of Routing Create

1. Routing > Create a Routing Start by Creating a Routing from the your boat to a particular POI that you have placed on the current grib. to create a POI, put the cursor at a destination location, use right mouse button and select "Place new mark". Then pick Routing > Create new Routing. Change the destination using the dropdown box to pick the new POI you created. Select "Apply" and let the isochrones and Routing be created. If you check "Convert to a Route" while creating the "Routing" the conversion to a Route will occur automatically with a prompt to "Simplify and Optimize" or to "Cancel conversion to a Route". When learning "Routing > Create a Routing" I suggest that you don't check "Convert to a Route" for awhile, but this is a nice feature to speed up operations.

2. Alternative Routing or Pivot Points Before a "Routing" is converted in a "Route", you can also generate "child-routings" or "Alternative Routes", by "Creating a Pivot" after you have dragged out a highlighted alternative routing which follows the isochrone routings (Right click and select "Create a Pivot". The program then creates a companion "Routing" from the Pivot point and realigns the original "Routing" which will be named sequentially "Route1, Route2," etc depending on how many alternative routings you create with "Right click - Create a Pivot". Don't delete any of the child "Routings" if you wish to Convert the entire path to a Route because the Routes are dependent on one another. Pick the last Routing created (named "Route1, Route2, etc." )to convert the entire Routing to a Route

3. Reasons to Convert a Routing to a Route - The Route Details Tab and Autopilot Tab are not availalbe in "Routing". There are many control options under the Route Settings dialogue box, and POI information, control, editing and deletion is possible. Additionally under a Route the Autopilot Tab is accessible, which is essential to Send "Route Information" (a series of up to six waypoints) to direct your boat.

Convert a Routing to a Route

1. Routing > Edit > Convert a Routing to a Route Use the Edit Routing Dialogue box and Check the "Convert to Route" box. Hit "Apply" the program will prompt "Is route from Boat?" If you select "No", the "Route" can then be "Frozen" (see below). If you select "Yes" the route will start be from the boat and will follow the boat around as it moves with each grib update, and you will continue to be able to "Optimize" and "Simplify" that "Route".

2. Route > Edit The "Routing" will be converted to a "Route" which you will find by going to "Edit > Route" under the same Routing name that you had before.

Simplify and Optimize the Route - Use of Route Edit

1. Route > Edit Name, size and color, start point, start date and time (good for sequential routes), Options, etc. see below

2. Route > Edit > Simplify a Route Check the box in the Route Dialogue after you have optimized the route, to simplify and reduce the number of Intermediate POI's used. Why is this necessary? Because at some point you will be sending the list of waypoints to the "Autopilot" and the Autopilot only accepts six or seven intermediate waypoint instructions. Also it is often better to let the optimization between intermediate POI or waypoints occur in accord with how the actual winds blow. Fewer waypoints allow this to happen.

3. Route > Edit > Optimize a Route Check the box in the Route Dialogue and watch the program cycle through an optimization.

4. Route from your Boat to POI can be re-run multiple times, and "Simplified", "Optimized" with newly download and up-to-date grib files. This is a shortcut if you are keeping the destination point the same. Sometimes the weather has changed enough that it is wise to review weather and set a new destination POI and create a new Routing and then convert that to a Route. But re-running an existing Route is good way to save time. After you download and update new grib files you should "Optimize" and "Simplify" to update the optimal path with the new weather files. Uncheck VLM-VMG box first and afterwards rechck and Send the updated Route waypoints to the Autopilot.

5. Route from POI to POI can be Frozen and unfrozen, but cannot be used on a fresh or new grib file to update the optimization of a route.

6. Intermediate POI -Moving, Deleting and Editing From the Route Settings box uncheck "Hide Intermediat POI" and Close. Now the Route will have Intermediate POI with light green boxes containing the POI name. Move the POI by hovering over the POI and press Shift + Left Click, move the POI and drop it by releasing the Left mouse button. Then release the Shift. Delete the POI by hovering the POI box Right Click > Pick Delete. Edit the POI in a similar manner.

7. Intermediate POI > Edit > Option Simplifiable and Not Simplifiable **An Important Concept** From the Route Settings box uncheck "Hide Intermediat POI" and Close. Hover over the green POI box Right Click and pick "Edit". Checking "Not Simplifiable" will freeze the position of the POI so that Simplification of the Route will not delete the POI, and Optimization will not move the POI position. This feature is used by the "Routing" Function "Create Pivot Point", which creates a new POI with "Not simplifiable" checkde, followed by rerunning the last part of the Routing. The user can move these "Not Simplifiable" POI using Hover, Shift + Left Click or can create Not simplifiable POI to force the Route to honor Racing Gates and Ice Gates simply by checking this box and locating the POI properly.

Send the Route to the server - Use of Routes Edit Autopilot Tab

5. Route Details Tab "Route Details Tab" shows lat/longs, courses, boat speed, & winds along the "Route"

6. Route > Edit > AutoPilot Tab

Other use of Routes

1. Route > Edit > Option to Freeze a Route- The Route must start from a POI (and end at a POI) and not be on VB-VLM. Routes from point to point can be frozen. Freezing the route stores all time and waypoint information for the last optimization. As you cycle through time the position will be shown, but it is for a previous (not current) grib file. If you uncheck a frozen route, and try to optimize it, it will complain and the route will probably disappear. Don't do this. You can hide and unhide frozen routes or export them.

2. Route > Edit > Option to Hide and Unhide a Route - Useful to identify a Route (you can also use hover) or to clean up the screen. Often I find myself eventually deleting hidden routes. It would be helpful to have the delete route option show if a route is (hidden).

3. Route > Edit > Option to Export/Import a Route - Simply save a route to a file (csv, txt, etc) Asks for POI or Detail. Or Import or retrieve an older route.

3. Route > Edit > Option to display wind's strength along the routing -edit routing, uncheck "see Isochrons", and check "Color TWS between isos" instead.

4 Route > Edit > Option to Display data from roadbook at grib date To see all this while you change the grib's date.

7. Route > Create Route You may create a "Route" from scratch and then assign POI to the route in alphanumeric or numeric sequence by Hovering over the Mark Right Click and Pick "Edit" then assign the Mark to the Route.

Long Race Techniques - Virtual Racing

  • Long Route using Saildocs Grib, Color Black 4.0 width. On Saildocs grib updates re-optimize.
  • Shorter Route using VLM Grib, Color White 2.5 width. On VLM grib updates re-optimize.
  • Adjust the VLM Route POI's by turning off Intermediate POI, moving points, and send to Autopilot OR
  • Copy the shorter VLM Route and paste Turn to Yellow, adjust that and send to Autopilot.
  • Compare Competition - Set a POI at competition and run a route. Then check positions over time.
  • Spectator VLM website - Check on the progress of the race and to select boats to show in qtVLM.
  • Babysitting -If you don't like missing midnight grib updates, find a partner and use the "Babysitting" feature.