Waypoints and Courses - Manual

  1. 'Edit activity' Actions
    1. Apply GPS Track from - Activity
    2. Apply GPS Track from - Course
    3. Apply GPS Track from - Route
    4. Add/Fix Elevation
    5. Create course(s)
  2. 'Export' Actions
    1. Map - Send custom map to Garmin
  3. Mapping Extensions
  4. Views
    1. View "Courses"
      1. What is a course
      2. Creating Course Points
      3. Editing Course Points
      4. "Create Course(s)" Actions
      5. "Edit" Actions
      6. "Import" Actions
      7. "Export" Actions
      8. Miscellaneous Actions
    2. View "Waypoints"
      1. What is a waypoint
      2. "Create Waypoint" Actions
      3. "Edit" Actions
      4. "Import" Actions
      5. "Export" Actions
      6. Miscellaneous Actions
      7. Geocaching Support
  5. Settings Pages
    1. Waypoints and Courses
      1. "Add Course Points" Settings
      2. "Add/Fix Elevation" Settings
      3. "Export to Garmin" Settings
      4. Plugin Information

This plugin is very powerful and comprehensive - so the manual has become a bit lengthy.

'Edit activity' Actions

Maybe you've recorded activities with a non-GPS device, but a friend with a GPS device has joined you for the ride/run. So why not ask him for his GPS track and add it to your activities. Or create and manually edit a GPS route and use these actions to add it to your activities.
The "Apply GPS Track from ..." actions are available in the "Daily Activity" view and the "Reports" view of SportTracks, when you've selected at least one activity that does not have a GPS track.

Apply GPS Track from - Activity

When you select this action in the "Edit" menu, the plugin shows a dialog that lists all affected activities.


Select the activity that shall provide the GPS track

and click on .
The plugin adds this activity's GPS track to the selected activities.
Whenever an activity has a distance track (e.g. was recorded with a bike computer), the GPS track points are added according to distance.
When an activity has no distance information at all, speed of the GPS track is adjusted so that the duration of the activity is completely covered.

Apply GPS Track from - Course

This action is like the previous one, but the GPS track is taken from a course rather than an activity.

Apply GPS Track from - Route

This action is like the previous one, but the GPS track is taken from a route rather than an activity.

The next two actions are only available when at least one of the selected activities has a GPS track.

Add/Fix Elevation

This action can add elevation to activities that don't have elevation data ("add") and/or can fix elevation tracks that are of doubtful quality ("fix").
In both cases, applied elevation data are taken from data sources that can be configured on the plugin settings page.

When the activity already has elevation data, the plugin ask you - just to be sure:

There are two common reasons, why elevation data need to be corrected:
  1. they were recorded with a GPS device that does not have an inbuilt barometric altimeter and hence creates an elevation track from GPS elevation data - which are inherently unreliable and "noisy";
  2. they were recorded with a GPS device that has a barometric altimeter, but due to changes in atmospheric pressure this barometric altimeter shows incorrect values and is only gradually corrected by the GPS device.
The plugin tries to detect which of the two reasons has occured and suggests a type of compensation:

In order to correct elevation the plugin has to download elevation data ("DEM" = "digital elevation model") from servers in the Internet. This may take some time, because these data sets are large. During the dowload the plugin displays a progress indicator:

When the plugin has downloaded a DEM data set, it caches it on your lokal disk, so that the next elevation corrections in the same geographic area will be performed instantaneiously.

Create course(s)

This action lets you create courses from one or many activities and/or routes.

This action opens a window that lets you control the course creation:

There are options to:
Set the options and then click on .

'Export' Actions

The plugin adds a new action to the "Export" menu in the "Daily Activity" view of SportTracks:

Map - Send custom map to Garmin

This action sends the currently visible SportTracks map as a so-called "Custom Map" to a compatible Garmin GPS device.
So you can have maps on your Garmin device without having to use (and buy) Garmin's map products.
A list of compatible devices can be found here.

Mapping Extensions

The plugin displays waypoints and courses on the SportTracks maps in the "Daily Activity" view , the "Activity Reports" view and the "Routes" view of SportTracks.

It adds a new entry "Waypoints" to the so-called pointer control mode menu in the upper left of SportTracks' map window:

This is used to create new waypoints.


Views

Most of the plugin's functionality can be found in the two new views that the plugin adds to SportTracks:

View "Courses"

What is a course
A course is a GPS track with speed and elevation, a name, several Course Points and some more attributes.
Courses are available on Garmin GPS devices designed for sports usage (Forerunner, edge, ...).
These devices allow you to perform a training ride/run as a race against a "Virtual Partner".
There's a brief  training video for "Virtual Partner" on the Garmin web site that gives some more insight.

A course in the Waypoint and Courses plugin has:
The "Courses" view gives you access to all courses in your current logbook.

The view has 3 major parts:
  1. the Course List in the upper part: lists all courses in your logbook
    - you can sort the list by clicking on the column header of every column
    - right click on the list to open a context menu (see below)
  2. the Course Track Chart at the bottom: shows the tracks of this course: elevation, grade, speed/pace:
     
  3. the Course Editor on the right side: used to display and edit the properties of the course that is selected in the Course List

Right click on a course in the Course List in order to open a context menu:

The context menu has a caption that tells you the number of selected courses and several action items for frequently used edit actions. The actions are described below.

This view can be undocked with a click on "Undock". See here for details.

Creating Course Points
There are several ways to create course points:
  1. automatically: let the plugin add course point for turn, summits and valleys. See here for details.
  2. from waypoints: let the plugin add course points for nearby waypoints. See here for details.
  3. in the Course Track Chart: click on the x axis at the desired distance
  4. on the SportTracks map: click on the course track line on the map and select "Add course point"
Editing Course Points
When you select a course, the Course Editor on the right side will show the course properties and the Course Point List.
The Course Point List has a context menu with several actions - right click on the list to display this menu:

Some of the actions are described below.
Some actions are specific for course points:
  1. Autoroute from No ... To No ...
    You've created this course once but think that there MUST be a better way to come from course point A to B?
    Simply use this action to replace the existing GPS track by one created by a smart auto router.
    This uses the Autorouting action described below.
  2. Delete course between these points
    Deletes the GPS track between the two points and replaces it by a straight line.
    Note: this action has two siblings that show up, when you've selected a single course point:
    "Delete course up to this point" and "Delete course after this point"
  3. Save as new waypoint
    Creates a new waypoint for every of the selected course points.
  4. Toggle turn warning
    Use this to toggle the turn warning flag for multiple course points.
  5. List Settings and Copy
    the usual suspects.

The plugin provides several actions to create, edit, import and export waypoints. These can be found in the menu at the left side of the view:

"Create Course(s)" Actions
You can create new courses in several ways. Most of them however require to use the "Daily Activity" or "Routes" views of SportTracks, so the plugin takes there when appropriate.
  1. Create Course(s) ... manually
    Manual creation of a course means drawing its GPS track point by point - which is not the method of choice, if you can avoid it.
    SportTracks already provides a GPS track editor in the "Routes" view. So the plugin doesn't reinvent the wheel but asks you to use the Route editor.
    It switches to the "Routes" view, creates a new route and then shows this message to hand over control to you:
  2. Create Course(s) ... from activities
    Takes you to the "Daily Activity" view and shows this message to hand over control to you. Read on here.

  3. Create Course(s) ... from routes
    Takes you to the "Routes" view and shows a similar message like the previous action to hand over control to you. Read on here.

  4. Create Course(s) ... Autoroute
    This is the most elegant and powerful way to create a new route: by using a Google web service to create a route between a sequence of positions.
    The action opens the "Autoroute" window:

    You can enter either addresses or lat/lon coordinates as routing points.
    You can as weel:
    - change order of routing points (up and down arrows)
    - delete a via point
    - add new via points
    - set the type of routing: for cars or for pedestrians and a flag to avoid highways
    A click on starts calculation of a route. The route is then displayed on the map, accompanied by driving instructions.
    Click on to create a course for this route.
    You can as well save the map and driving instructions to a HTML file or print  it.
    Autorouting is based on a service provided by Google.

"Edit" Actions
  1. Add course points
    Automatically adds course points at turn, summits and valleys. This action can be fine tuned on the plugin settings page.
  2. Add waypoints to course
    This action searches for waypoints that are on or near the course's GPS track. It adds a course point to the course for every of these waypoints.
    So you can e.g. have waypoints for your shops, bars, ... where you can "refuel" and add them to all your courses, so that your GPS device can tell you the distance to your next drink.
  3. Add/Fix Elevation
    This is the equivalent of the same action for activities.
  4. Change speed/pace
    You typically use courses on your GPS device to race against a "Virtual Partner". So your course should have appropriate speed/pace.
    This action lets you adjust the speed/pace of your course very much like the "Create Course(s)" action.
  5. Create route(s)
    This lets you create a SportTracks route from a course.
  6. Delete
    Deletes the selected course(s). The plugin will ask you, if you're sure before actually deleting the courses.
  7. Duplicate
    Duplicates the selected course(s). You can use this to create a "backup copy" before modifying a course.
  8. Edit
    Opens an editor for the course properties. When you've selected more than one course the window is in turn opened for every selected course.
  9. Reduce track points
    When you create a course from an activity it will typically have a track that consists of much more points then necessary to guide you; especially when your recording interval is set to 1 second.
    This costs storage space on your disk and GPS device and slows down handling of courses on your GPS device considerably.
    Use this action to thin out the GPS track to a reasonable number of track points.
  10. Reverse
    Want to change your habits and ride/run the opposite direction? Here you go.

"Import" Actions
  1. Import from File
    The plugin can import courses in several different file formats:
    1. TCX files - Garmin Training Center Database files
    2. CRS files - identical to 1. but with a different file name extension
    3. Garmin FIT files - from the "X:\Garmin\Courses" folder of current Garmin GPS devices like the edge500 or edge800
    4. GPX files - only provide a GPS track, no course points or other properties
    5. Bryton GPX files - a special flavour of GPX file for courses recorded with Bryton GPS devices;
      you can find these courses on  Bryton's Sports Portal
    The plugin reads the file(s), checks if courses in the file already exist in SportTracks, adds the new courses and selects them in the waypoint list.
    Note: there's a short cut, you can simply drag a file with the appropriate extension onto the Waypoints view to import this file.
  2. Import from Garmin
    This action is similar to the previous one, but it directly imports courses from an attached GPS device.
    It tests for attached GPS devices and lets you select the device that you want to import from.
    The plugin supports both "mass storage devices" and USB devices that are accessed via Garmin Communicator Plugin.
"Export" Actions
  1. Export to File
    This is the counterpart of the "Import to File" action. However it supports only file formats "CRS" and "TCX".
    When no course is selected, all courses are exported. Otherwise just the selected courses are exported.
  2. Export to Garmin
    Similar to the previous action, but directly exports to an attached GPS device.
Miscellaneous Actions
  1. Show on Garmin
    Checks the attached Garmin GPS devices, lets you select a device and show all courses on this device.
    Select a course to show details, click on to close the window.
  2. Install Garmin Map
    This action lets you install Garmin compatible maps to Garmin devices that support mapping.
    It gives you access to maps provided by  maps.cloudmade.com - a map server based on maps of the OpenStreetMap project.
    Cloudmade maps typically even support routing on your GPS device.

    Select your Garmin device first,
    then navigate Cloudmade's catalog of maps to your desired map file "*.img.zip" and click on the link.
    The plugin then starts downloading the map file:

    Map files can be rather big, so this might take a while.
    The plugin then unzips the map and copies it to the selected Garmin device.

    When you remove your Garmin device from the USB connection and restart it, the new map should be available.

View "Waypoints"

What is a waypoint
A waypoint is a geographic position with a name and some more attributes.
Waypoints are available on nearly all GPS devices of all brands. You can use them in your GPS device to "navigate to" a certain point.
Let's have a look at the Waypoint Editor of this view (see screen shot below) for a deeper look.
A waypoint in the Waypoint and Courses plugin has:
The "Waypoints" view gives you access to all waypoints in your current logbook. So it's similar to the "Activity Reports" view for activities.

The view has 3 major parts:
  1. the Group Control in the upper part
  2. the Waypoint List: lists all waypoints in your logbook, grouped according to the setting of the Group Control
    - you can sort the list by clicking on the column header of every column
    - right click on the list to open a context menu (see below)
  3. the Waypoint Editor on the right side: used to display and edit the waypoint that is selected in the Waypoint List

This view can be undocked with a click on "Undock". See here for details.


Click on the "down arrow" button to the right of "Type" to select a waypoint type:

Click on to open an image or open a link in your browser.

Right click on a waypoint in the Waypoint List in order to open a context menu:

The context menu has a caption that tells you the number of selected waypoints and several action items for frequently used edit actions. The actions are described below.

There is a special type of waypoints - so-called geocaches - that have even more attributes. Read more about these below.

The plugin provides several actions to create, edit, import and export waypoints. These can be found in the menu at the left side of the view:

"Create Waypoint" Actions
You can create new waypoints in two different ways:
  1. Create Waypoint ... on the Map
    Switches to the "Daily Activity" view and creates a selected Waypoint symbol that follows your mouse cursor.
    Move the mouse to the point where you want to create the waypoint and click.
  2. Create Waypoint ... from Address
    Asks you for an address and creates a waypoint at the geographics position of this address:

    This action is based on a service provided by Google.

Note: both actions open a GPS editor window to let you adjust the properties of the newly created waypoint.
 
"Edit" Actions
  1. Add/Fix Elevation
    Sets the elevation of the waypoint from from data sources that can be configured on the plugin settings page.
  2. Autoroute
    This action is only available, when at least 2 waypoints have been selected.
    Creates a course from the first to the second waypoint. If more then 2 waypoints are selected, they are taken as via points.
    The action opens the "Autoroute" window:

    Before starting the route calculation, you can:
    - change order of routing waypoints (up and down arrows)
    - delete a routing waypoint
    - add new via points
    - set the type of routing: for cars or for pedestrians and a flag to avoid highways
    A click on starts calculation of a route. The route then displayed on the map, accompanied by driving instructions.
    Click on to create a course for this route.
    You can as well save the map and driving instructions to a HTML file or print  it.
  3. Delete
    Deletes the selected waypoints. The plugin will ask you, if you're sure before actually deleting the waypoints.
  4. Edit
    Opens an editor for the waypoint properties. When you've selected more than one waypoint, the window is in turn opened for every selected waypoint.
  5. Mass Edit
    In contrast to the previous action, "Mass Edit" lets you simultaneously set properties of many waypoints with just a few mouse clicks.
    Before actually modifying the waypoints, the plugin displays this window:
  6. Move
    Switches to the Daily Activity view and displays  icons for every moving waypoint. These icons follow the "hand" cursor.
    Click to reposition the waypoints at their current positions.
"Import" Actions
  1. Import from File
    The plugin can import waypoints in two different file formats:
    The plugin reads the file, checks if waypoints in the file already exist in SportTracks, adds the new waypoints and selects them in the waypoint list.
    Note: there's a short cut, you can simply drag a .gpx file of .fit file onto the Waypoints view to import this file.
  2. Import from Garmin
    This action is similar to the previous one, but it directly imports waypoints from an attached GPS device.
    It tests for attached GPS devices and lets you select the device that you want to import from.
    The plugin supports both "mass storage devices" and USB devices that are accessed via Garmin Communicator Plugin.
  3. Find geocaches nearby
    There's a special type of waypoints, so-called "Geocaches". Please see below.
    This action retrieves geocaches in the vicinity of the selected waypoint from an Internet data base of geocaches.
"Export" Actions
  1. Export to File
    This is the counterpart of the "Import to File" action. It supports the two file formats "GPX" and "FIT" as well.
    When no waypoint is selected, all waypoints are exported. Otherwise just the selected waypoints are exported.
    Note: Current Garmin GPS devices support so-called elevation points in order to automatically set GPS elevation to a fix value, when you start a workout near one of those positions. In order to upload elevation points, select the desired waypoints and export them to "X:\Garmin\NewFiles\Elevations.fit".
  2. Export to Garmin
    Similar to the previous action, but directly exports to an attached GPS device.
Miscellaneous Actions
  1. Show on Garmin
    Checks the attached Garmin GPS devices, lets you select a device and show all waypoints on this device.
    Select a waypoint to show details, click on to close the window.
  2. Install Garmin Map
    See above.

Geocaching Support
What is geocaching? Please see  here.

For now there's an action to search for geocaches in the vicinity of another waypoint.
Please see here.
When you select a waypoint that has been created by this action, the waypoint editor will show geocache specific properties - see screen shot to the right.

You can export these geocache waypoints to your GPS device. When your GPS device has geocaching support, these geocache properties are visible on your GPS as well.

Settings Pages

Waypoints and Courses

The plugin settings page lets you configure how some of the plugin's actions behave:
"Add Course Points" Settings
The plugin can automatically add so-called "course points" for turns, summits and valleys to courses. See here.
This part of the settings page lets you
  1. switch course point creations for turns and summits/valleys on and off
  2. configure the thresholds for detecting a turn, a summit or a valley

"Add/Fix Elevation" Settings
The plugin can use sources for elevation data that are available in the Internet to add elevation information to waypoints, courses and activites.
This part of the settings lets you
  1. switch automatic adding of elevation information to waypoints on and off
  2. same for courses
  3. configure the elevation data sources that the plugin uses:

"Export to Garmin" Settings
This section let you circumvent well-known weaknesses of some Garmin devices.
  1. a Garmin GPS device can beep in order to wake you up when a course point (turn, summit, valley, ...) is reached. Unfortunately many (if not all) Garmin devices beep at the very instant, when you are spot on the course point. Slightly too late to let your react.
    So the plugin can create so-called turn warnings, i.e. a 2nd course point that is placed several seconds before the real turn.
  2. a seconds weakness affects courses with sparse track points. When a course has a lengthy straight segment without any track point inbetween, the Garmin GPS will signal "Course lost" although you're spot on the course line.
    The plugin can ensure that track points are created at least every n meters in order to avoid this problem.


Plugin Information
The "Plugin Information" panel is standard for all my plugins. See the General Features page for details.

Last update: Apr 5, 2011