</para>
<itemizedlist mark="opencircle"><listitem>
<para>
-Uploading and downloading waypoints, tracks to/from GPS.
+Uploading and downloading waypoints, tracks and routes to/from GPS.
</para>
</listitem>
<listitem>
-<para>Preparing tracks and waypoints for trips using maps from services
-such as OpenStreetMap (OSM) and/or Terrasever. The data is only needed to be uploaded to
-your GPS before you leave. The maps together with your tracks and
-waypoints can also be printed and used during the trip.
+<para>Preparing tracks, routes and waypoints for trips using maps from services such as OpenStreetMap (OSM) and/or Terrasever.
+The data is only needed to be uploaded to your GPS before you leave.
+The maps together with your tracks, routes and waypoints can also be printed and used during the trip.
</para>
</listitem>
<listitem>
</para>
</listitem>
<listitem>
-<para>Making waypoints and tracks to follow to easily get someplace
+<para>Making waypoints, tracks and routes to follow to easily get someplace
you've never been before or don't have GPS data for but online
maps exist for it.
</para>
</listitem>
<listitem>
<para>
-Editing tracks and trackpoints, joining and splitting up tracks
+Editing routes or tracks and their trackpoints, joining and splitting up tracks and routes.
</para>
</listitem>
<listitem>
</listitem>
<listitem>
<para>
-Import track
+waypoint files of various types via <application>GPSBabel</application>
+Import track
, route and waypoint files of various types via <application>GPSBabel</application>
</para>
</listitem>
<listitem>
</para>
</section>
+<section><title>Tracks vs Routes</title>
+<para>
+In theory a route is path you are planning to follow and a track of where you have actually been. The GPX specification splits these into two separate catergories, although tracks contain everything route may have.
+</para>
+<para>
+Q. When planning a 'route' what difference does it make if it's a route or a track?
+</para>
+<para>
+A. One difference is in how a GPS device navigates following the route or track.
+Or you may want to consider interoperability with other software.
+Otherwise it is probably best to use tracks as they are a superset of the route functionality.
+</para>
+<para>
+For example on Garmin Etrex:
+</para>
+<itemizedlist>
+<listitem>
+<para>Route following: Uses navigation mode with compass and estimated time to next point.</para>
+<para>If following on road it can calculate a route on fly.</para>
+<para>I (RN) always use this mode to follow pre planned routes.</para>
+</listitem>
+<listitem>
+<para>Track following: Uses a <trademark>TracBack</trademark> mode</para>
+<para>I (RN) never use this so I can't comment on how it actually compares to the route mode.</para>
+</listitem>
+</itemizedlist>
+<note><para>
+There are often restrictions on the numbers of route points the GPS Device can handle - may be 250 or as little as 50.
+This generally not a problem for single day routes, but needs managing for multi-day events or for highly detailed routes.
+</para></note>
+</section>
+
</section><!--General Concepts End-->
<section><title>File Types and the Main Window</title>
<section><title>TrackWaypoint Layer</title>
<para>
-TrackWaypoint layers display GPS data (tracks and waypoints).
+TrackWaypoint layers display GPS data (tracks, routes and waypoints).
</para>
<para>One way to create new waypoints is to copy a
latitude/longitude coordinate pair, such as the one shown on most
automatically recognize several variations of the lat/lon format.
</para>
<para>
-By right-clicking tracks and waypoints in the layers panel, you can do
-many things with tracks and waypoints. You can easily find a specific
-track or waypoint by expanding the Tracks or Waypoints sublayers in the
-layers panel to show all tracks or waypoints, and typing the name of
-the track/waypoint.
+By right-clicking on tracks, routes or waypoints in the layers panel, you can access many commands on them.
+You can easily find a specific track, route or waypoint by expanding the appropriate containing Tracks, Routes or Waypoints sublayer in the
+layers panel to show all the individual items and then typing the name of the track, route or waypoint.
+</para>
+
+<para>
+The containing Tracks, Routes or Waypoints sublayers are only shown when items of that type exist.
+To start creating them enter into a create mode via either the <guibutton>Create</guibutton> toolbar commands or the <guimenuitem>New</guimenuitem> menu commands.
+</para>
+
+<para>
+By default routes are coloured red. Tracks are automatically assigned a spread of colours.
+</para>
+
+<para>
+Most operations are available on tracks are available on routes, except for functionality that relies on having timestamps - since routes by definition have no timing information. Thus for example, uploading a route to OpenStreetMap Traces is not available nor is Geotagging on a route.
+It is possible to convert between Tracks and Routes, although converting from a Track to a Route may involve a loss of information (hence you are required to confirm this operation before it happens).
</para>
<section><title>Layer Operations</title>
<section><title>View Layer</title>
<para>
-Version1.1+: This will automatically move the viewport and select the best zoom level to see the whole layer (i.e. tracks and waypoints).
+Version1.1+: This will automatically move the viewport and select the best zoom level to see the whole layer (i.e. all tracks, routes and waypoints).
</para>
</section>
+<section><title>View</title>
+
<section><title>View All Tracks</title>
<para>
-Version1.1+: This will automatically move the viewport and select the best zoom level to see the all the tracks in the layer (ignoring positions of any waypoints).
+Version1.1+: This will automatically move the viewport and select the best zoom level to see the all the tracks in the layer (ignoring positions of any routes or waypoints).
+</para>
+</section>
+
+<section><title>View All Routes</title>
+<para>
+Version1.4+: This will automatically move the viewport and select the best zoom level to see the all the routes in the layer (ignoring positions of any tracks or waypoints).
</para>
</section>
<section><title>View All Waypoints</title>
<para>
-Version1.1+: This will automatically move the viewport and select the best zoom level to see the all the waypoints in the layer (ignoring positions of any tracks).
+Version1.1+: This will automatically move the viewport and select the best zoom level to see the all the waypoints in the layer (ignoring positions of any tracks or routes).
</para>
</section>
+</section>
+
<section><title>Goto Center of Layer</title>
<para>
-This will automatically move the viewport to see the whole layer (i.e. tracks and waypoints). It does not adjust the zoom level.
+This will automatically move the viewport to see the whole layer (i.e. tracks, routes and waypoints). It does not adjust the zoom level.
</para>
</section>
<section><title>Export Layer</title>
<para>
-The layer (all tracks and waypoints) can be exported to a file GPX, GPSPoint, GPSMapper or Google's KML format.
+The layer (all tracks, routes and waypoints) can be exported to a file GPX, GPSPoint, GPSMapper or Google's KML format.
</para>
<para>
Version1.1+: An individual track can be exported to a GPX file via the track menu.
This opens a dialog to select the GPS Device and port to which the layer information will be transferred.
</para>
<para>
-The types of GPS information (tracks or waypoints) to be transferred can be selected.
+The types of GPS information (tracks, routes or waypoints) to be transferred can be selected.
</para>
<para>
-Tracks or Waypoints that are invisible will not be transferred.
+Tracks, Routes or Waypoints that are invisible will not be transferred.
</para>
</section>
</section><!-- End TRW Layer Options -->
-<section><title>Track Properties</title>
+<section><title>Track and Route Properties</title>
<para>
-Show many useful statistics about a track, including a
+Show many useful statistics about a track or a route, including a
elevation-distance graph and a speed-time graph (if data is available).
You can click these graphs to jump to the point in the track. You can
-also reverse a track, delete duplicates, and split a track from its
+also reverse it, delete duplicates, and split a track from its
component segments (discontinuous breaks in a track) into separate
tracks.
</para>
</section>
-<section><title>Track Operations</title>
+<section><title>Track and Route Operations</title>
<section><title>Goto</title>
<para>
<listitem><para>Endpoint</para></listitem>
<listitem><para>Version1.1+: Highest Altitude</para></listitem>
<listitem><para>Version1.1+: Lowest Altitude</para></listitem>
-<listitem><para>Version1.1+: Maximum Speed</para></listitem>
+<listitem><para>Version1.1+: Maximum Speed (Not Available on Routes)</para></listitem>
</itemizedlist>
</section>
segments (say, caused by turning the GPS on and off) you can merge them
easily into one track.
</para>
+<para>
+This is not available on routes as they have no timestamps.
+</para>
</section>
<section><title>Merge With Other Tracks</title>
</para>
</section>
-<section><title>Append Track</title>
+<section><title>Append Track or Route</title>
<para>
Enable joining of a single track to the end of the current track.
This opens a dialog listing the other tracks in the same TrackWaypoint layer from which one can make the selection.
threshold. This is useful when processing raw NMEA GPS data, especially
taken over a long time.
</para>
+<para>
+This is not available on routes as they have no timestamps.
+</para>
</section>
<section><title>Split By Number of Points</title>
<para>
Splits track segments into new tracks.
</para>
+<para>
+This is not available on routes as they do not have route segments.
+</para>
</section>
<section><title>Split at Trackpoint</title>
<para>
Deletes subsequent points that have the same time stamp (but may have different positions).
</para>
+<para>
+This is not available on routes as they have no timestamps.
+</para>
</section>
</section>
</para>
</section>
-<!--
<section><title>Extend Using Route Finder</title>
<para>
Enables the Route Finder tool. Thus on a subsequent left click in the viewport, a route is calculated from the end of track to that point using Google's route service and applied to the track.
</para>
</section>
--->
<section><title>Upload</title>
<para>
This selects the track to be used in the <link linkend="filter_with_track">Filter With <emphasis>Trackname</emphasis></link> feature.
</para>
+<para>
+This is not available on routes.
+</para>
</section>
-<!--
<section><title>View Google Directions</title>
<para>
This option is only available on a track created using the Route Finder tool.
</para>
</note>
</section>
--->
+
</section><!-- End Track Options -->
<section><title>Waypoint Properties</title>
<section><title>Upload</title>
<para>
To upload data to the GPS, first populate the GPS Upload child
-layer of the GPS layer (either by creating waypoints/tracks in it, or
-copying and pasting or dragging waypoints/tracks from another layer).
+layer of the GPS layer (either by creating waypoints/tracks/routes in it, or
+copying and pasting or dragging waypoints/tracks/routes from another layer).
Then right-click the GPS layer and click <guimenuitem>Upload to GPS</guimenuitem>.
</para>
</section>
</para>
</section>
-<!--
<section><title>Route Finder</title>
<para>
Enable this tool by clicking on the toolbar icon: <guiicon><inlinegraphic fileref="figures/route_finder_18.png"/></guiicon>
<keycap>Ctrl</keycap>: continue previous track
</para>
</section>
--->
+
</section>
<section><title>Georef Map Layer Tools</title>
<para>Use the GPS Layer or <menuchoice><guimenu>File</guimenu><guimenuitem>Acquire</guimenuitem><guimenuitem>From GPS</guimenuitem></menuchoice>
to load data directly from your GPS into &appname;.
</para>
-<para>You can specify the types of data to acquire: Tracks and/or Waypoints.
+<para>You can specify the types of data to acquire: Tracks, Routes and/or Waypoints.
</para>
<note>
<para>You must have write permission to the port used. For <trademark>Unix</trademark> like OS:</para>
<para>Ensure the new track layer is above the map layer.</para>
</step>
<step><para>Expand the TrackWaypoint layer, select <guimenuitem>Tracks</guimenuitem></para></step>
-<step><para>In the tools menu choose <guiicon><inlinegraphic fileref="figures/begintr_18.png"/></guiicon> <guibutton>Begin Track</guibutton>
+<step><para>In the tools menu choose <guiicon><inlinegraphic fileref="figures/addtr_18.png"/></guiicon> <guibutton>Create Track</guibutton>
</para></step>
<step><para>Leftclick in the map window, enter a name</para></step>
<step>
projects / andy / viking.git / blobdiff