Blame | Last modification | View Log | RSS feed
#LyX 1.6.3 created this file. For more info see http://www.lyx.org/
\lyxformat 345
\begin_document
\begin_header
\textclass docbook-book
\begin_preamble
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY sportwatcher "<application>SportWatcher 0.6</application>">
<!ENTITY kappname "&sportwatcher;"><!-- Do *not* replace kappname-->
<!ENTITY package "kde-module"><!-- kdebase, kdeadmin, etc -->
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE"><!-- change language only here -->
]>
<!-- XML file was created by LyX 1.6.3
See http://www.lyx.org/ for more information -->
<book lang="&language;">
<bookinfo>
<title>The user manual for &sportwatcher;</title>
<authorgroup>
<author>
<firstname>Andreas</firstname>
<othername></othername>
<surname>Theofilu</surname>
<affiliation>
<address><email>andreas@theosys.at</email></address>
</affiliation>
</author>
</authorgroup>
<copyright>
<year>2007</year>
<year>2008</year>
<year>2009</year>
<holder>Andreas Theofilu</holder>
</copyright>
<!-- Translators: put here the copyright notice of the translation -->
<!-- Put here the FDL notice. Read the explanation in fdl-notice.docbook
and in the FDL itself on how to use it. -->
<legalnotice>&FDLNotice;</legalnotice>
<date>2009-07-30</date>
<releaseinfo>0.6</releaseinfo>
<abstract>
<para>&sportwatcher; is program to read out aktivities from a Garmin Forerunner. It support all sport watches connected over the USB port, like Garmin Forerunner305.</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>SportWatcher</keyword>
<keyword>Garmin</keyword>
<keyword>GDAL</keyword>
</keywordset>
</bookinfo>
\end_preamble
\use_default_options true
\begin_modules
logicalmkup
minimalistic
\end_modules
\language english
\inputencoding auto
\font_roman default
\font_sans default
\font_typewriter default
\font_default_family default
\font_sc false
\font_osf false
\font_sf_scale 100
\font_tt_scale 100
\graphics default
\paperfontsize default
\spacing single
\use_hyperref true
\pdf_title "Benutzerhandbuch für SportWatcher 0.6"
\pdf_author "Andreas Theofilu <andreas@theosys.at>"
\pdf_subject "Benutzerhandbuch"
\pdf_keywords "SportWatcher KDE Qt"
\pdf_bookmarks true
\pdf_bookmarksnumbered false
\pdf_bookmarksopen false
\pdf_bookmarksopenlevel 1
\pdf_breaklinks true
\pdf_pdfborder false
\pdf_colorlinks false
\pdf_backref false
\pdf_pdfusetitle true
\papersize default
\use_geometry false
\use_amsmath 1
\use_esint 1
\cite_engine basic
\use_bibtopic false
\paperorientation portrait
\secnumdepth 4
\tocdepth 4
\paragraph_separation indent
\defskip medskip
\quotes_language english
\papercolumns 1
\papersides 1
\paperpagestyle default
\tracking_changes false
\output_changes false
\author ""
\author ""
\end_header
\begin_body
\begin_layout Chapter
Introduction
\begin_inset CommandInset label
LatexCommand label
name "cha:Introduction"
\end_inset
\end_layout
\begin_layout Standard
In the first place, SportWatcher is a program to get out some GPS data from
a GPS receiver.
I started developing this program when I realized, that there was no support
for my new Garmin Forerunner305 under Linux.
Because I use Linux only, I was not able to use the software who came with
the watch, because it was for Windows only.
So I looked closer to this GPS receiver, made for sport and training.
Like most GPS receivers from Garmin, this one uses also the NMEA protocol
to transfer data.
By accident I found the garmintools, written by "Dave Bailey" (<dave <at>
daveb <dot> net>).
This tools contain a library to read out the data over the USB port.
I used the source by courtesy of Dave as the basic of SportWatcher and
used it to get out everything of my Forerunner 305 and hopefully every
compatible GPS receiver.
\end_layout
\begin_layout Section
Supported GPS receiver
\begin_inset CommandInset label
LatexCommand label
name "sec:Supported-GPS-receiver"
\end_inset
\end_layout
\begin_layout Standard
Basically every GPS receiver, who uses the NMEA protocol and has an USB
port, should be supported.
However.
Only the following receivers are tested:
\end_layout
\begin_layout Itemize
Garmin Forerunner305
\end_layout
\begin_layout Itemize
Garmin Forerunner205
\end_layout
\begin_layout Standard
If you own another type of GPS receiver and when it works with SportWatcher,
please send an e−mail to
\emph on
andreas <at> theosys <dot> at
\emph default
.
\end_layout
\begin_layout Chapter
Installation
\begin_inset CommandInset label
LatexCommand label
name "cha.Installation"
\end_inset
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
was written in C++ and is made for the desktop
\begin_inset CommandInset href
LatexCommand href
name "KDE"
target "http://www.kde.org"
\end_inset
.
The program was developed exclusive under Linux.
SportWatcher is open source! This means, that the whole source is available
to you and you are allowed to use it for your own.
The source code, and with it the whole program, is licensed under the
\begin_inset CommandInset href
LatexCommand href
name "GNU General Public License version 3"
target "http://www.gnu.org/licenses/gpl.html"
\end_inset
.
\end_layout
\begin_layout Section
Download
\begin_inset CommandInset label
LatexCommand label
name "sec.Download"
\end_inset
\end_layout
\begin_layout Standard
SportWatcher is available as a binary package for some Linux distributions.
Of course, ther is also the source code available.
Get the stable source code or the package for your distribution from one
of the following sources:
\end_layout
\begin_layout Itemize
Sourceforge:
\begin_inset CommandInset href
LatexCommand href
name "Sourceforge"
target "http://sourceforge.net/projects/sportwatcher/"
\end_inset
\end_layout
\begin_layout Itemize
TheoSys:
\begin_inset CommandInset href
LatexCommand href
name "TheoSys"
target "http://www.theosys.at/download"
\end_inset
\end_layout
\begin_layout Standard
If you like to help develop SportWatcher, or simply want to have the latest,
untested code, with all available bells and whistles, then you can get
the code out of one of the subversion archives.
The source code in the subversion archives, is for developers and is not
tested! There is no garanty, that this code will even compile!
\end_layout
\begin_layout Standard
Type on the command line (shell), one of the following commands, dependig
from what archive you want to download the code:
\end_layout
\begin_layout Code
# svn checkout https://sportwatcher.svn.sourceforge.net/svnroot/sportwatcher
\end_layout
\begin_layout Standard
or
\end_layout
\begin_layout Code
# svn checkout svn://www.theosys.at/sportwatcher/trunk
\end_layout
\begin_layout Standard
It is possible to access the
\begin_inset CommandInset href
LatexCommand href
name "Repository"
target "http://www.theosys.at/websvn/listing.php?repname=repos+1&path=/sportwatcher/trunk/&rev=0&sc=0"
\end_inset
, containing the latest code, with your WEB browser too.
\end_layout
\begin_layout Subsection
Necessary components
\begin_inset CommandInset label
LatexCommand label
name "sec.Necessary-components"
\end_inset
\end_layout
\begin_layout Standard
To be able to compile SportWatcher you need the following components:
\end_layout
\begin_layout Itemize
\begin_inset CommandInset href
LatexCommand href
name "KDE 4.1.x"
target "http://www.kde.org"
\end_inset
\end_layout
\begin_layout Itemize
\begin_inset CommandInset href
LatexCommand href
name "GDAL 1.5.x"
target "http://www.gdal.org"
\end_inset
(optional)
\end_layout
\begin_layout Subsubsection
KDE 4.1.x
\begin_inset CommandInset label
LatexCommand label
name "sec.KDE-4.1.x"
\end_inset
\end_layout
\begin_layout Standard
Since version 0.6 SportWatcher needs at least version 4.1.0 of KDE.
It will not compile with older versions of it!
\end_layout
\begin_layout Subsubsection
GDAL 1.5.x
\begin_inset CommandInset label
LatexCommand label
name "sec.GDAL-1.5.x"
\end_inset
\end_layout
\begin_layout Standard
SportWatcher is able to display a map underneath a track.
This is made with the help of the GDAL library.
But this library is optional.
It is possible, to compile SportWatcher even without GDAL installed.
Though the ability to display maps is missing then.
\end_layout
\begin_layout Standard
Debian testing (Squeeze) supports currently version 1.5.4 of GDAL.
Up to version 8.04 TLS of Ubuntu (Hardy Heron), only version 1.4.x of GDAL
is supported.
This version of GDAL is not appropriate for SportWatcher.
It is no problem to use the newer version 1.6.0 of GDAL.
SportWatcher will compile and function very well with the newest version.
\end_layout
\begin_layout Standard
openSUSE 11.0 doesn't support GDAL out of the box.
There are some easy to find places, where you can download GDAL for openSUSE,
but it's not easy to satisfy the dependencies, GDAL needs.
Therefore I've forgone to include GDAL.
This means, that version 0.5 of SportWatcher does not support maps on openSUSE
11.0.
\end_layout
\begin_layout Standard
Also openSUSE 11.1 does not support GDAL.
I decided to compile the binary version with it.
To make it simple to compile SprortWatcher yourself, you can download GDAL
for openSUSE 11.1 from here:
\end_layout
\begin_layout Itemize
\begin_inset CommandInset href
LatexCommand href
name "gdal-1.6.1-0.pm.1.i586.rpm"
target "http://www.theosys.at/download/gdal-1.6.1-0.pm.1.i586.rpm"
\end_inset
\end_layout
\begin_layout Itemize
\begin_inset CommandInset href
LatexCommand href
name "geotiff-1.2.5-0.pm.1.i586.rpm"
target "http://www.theosys.at/download/geotiff-1.2.5-0.pm.1.i586.rpm"
\end_inset
\end_layout
\begin_layout Itemize
\begin_inset CommandInset href
LatexCommand href
name "libgdal1-1.6.1-0.pm.1.i586.rpm"
target "http://www.theosys.at/download/libgdal1-1.6.1-0.pm.1.i586.rpm"
\end_inset
\end_layout
\begin_layout Itemize
\begin_inset CommandInset href
LatexCommand href
name "libgdal-devel-1.6.1-0.pm.1.i586.rpm"
target "http://www.theosys.at/download/libgdal-devel-1.6.1-0.pm.1.i586.rpm"
\end_inset
\end_layout
\begin_layout Itemize
\begin_inset CommandInset href
LatexCommand href
name "libgeos1-3.1.0-0.pm.1.i586.rpm"
target "http://www.theosys.at/download/libgeos1-3.1.0-0.pm.1.i586.rpm"
\end_inset
\end_layout
\begin_layout Itemize
\begin_inset CommandInset href
LatexCommand href
name "libgeos-devel-3.1.0-0.pm.1.i586.rpm"
target "http://www.theosys.at/download/libgeos-devel-3.1.0-0.pm.1.i586.rpm"
\end_inset
\end_layout
\begin_layout Itemize
\begin_inset CommandInset href
LatexCommand href
name "libgeotiff1-1.2.5-0.pm.1.i586.rpm"
target "http://www.theosys.at/download/libgeotiff1-1.2.5-0.pm.1.i586.rpm"
\end_inset
\end_layout
\begin_layout Itemize
\begin_inset CommandInset href
LatexCommand href
name "libgeotiff-devel-1.2.5-0.pm.1.i586.rpm"
target "http://www.theosys.at/download/libgeotiff-devel-1.2.5-0.pm.1.i586.rpm"
\end_inset
\end_layout
\begin_layout Section
Compile / Install
\begin_inset CommandInset label
LatexCommand label
name "sec.Compile-Install"
\end_inset
\end_layout
\begin_layout Subsection
Install the binary pakage
\begin_inset CommandInset label
LatexCommand label
name "sec.Install-the-binary"
\end_inset
\end_layout
\begin_layout Standard
After downloading the pakage, open a shell and become root.
Then type in the following command:
\end_layout
\begin_layout Code
# dpkg -i sportwatcher_
\emph on
X.X-x
\emph default
.i386.deb
\end_layout
\begin_layout Standard
or
\end_layout
\begin_layout Code
# dpkg -i sportwatcher_
\emph on
X.X-x
\emph default
.amd64.deb
\end_layout
\begin_layout Standard
or
\end_layout
\begin_layout Code
# dpkg -i sportwatcher_
\emph on
X.X-x
\emph default
_ubuntu_i386.deb
\end_layout
\begin_layout Standard
or
\end_layout
\begin_layout Code
# rpm -ivh sportwatcher-
\emph on
X.X-x
\emph default
.i586.rpm
\end_layout
\begin_layout Standard
Where X.X-x represents the version and may look like 0.6-1, or the like.
After successfull installation you can use the program immediately.
\end_layout
\begin_layout Subsection
Compile
\begin_inset CommandInset label
LatexCommand label
name "sec.Compile"
\end_inset
\end_layout
\begin_layout Standard
After downloading the source, and after it was uncompressed into a directory,
change to this new directory.
On a command line, type the following commands:
\end_layout
\begin_layout Code
$ mkdir build
\end_layout
\begin_layout Code
$ cmake ..
-DCMAKE_INSTALL_PREFIX=/usr/local
\end_layout
\begin_layout Standard
This program checks now for all necessary components.
In case something is missing, the script stops and displays an error message.
Common reason for errors are, that something is not installed.
In most cases, this is the developer version of a package.
With Debian, the name of the developer packages ends with
\emph on
dev
\emph default
.
Install the missing packages, if necessary.
\end_layout
\begin_layout Standard
With the following command, you start the compiler:
\end_layout
\begin_layout Code
$ make
\end_layout
\begin_layout Standard
In case it stops and display an error message, it is mostly because something
is not installed, or there is a wrong version installed.
Check out what version Debian supports, and install it.
\end_layout
\begin_layout Subsubsection
Installation
\begin_inset CommandInset label
LatexCommand label
name "sec.Installation"
\end_inset
\end_layout
\begin_layout Standard
To install
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
for all users on your system, you need root priviledges.
Otherwise you can install the program into your home directory too.
With SportWatcher you got a file called INSTALL.
It contains a detailed description of how to install the program.
If you've troubles installing SportWatcher, read this file first! To install
SportWatcher for all users on your system, become root and type in the
following command:
\end_layout
\begin_layout Code
# make install
\end_layout
\begin_layout Standard
After successfull installation of the program, you can start it with the
command sportwatcher directly from the command line, or you can open the
menu "
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenu>
\end_layout
\end_inset
Utilities
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenu>
\end_layout
\end_inset
-->
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenuitem>
\end_layout
\end_inset
Sportwatcher
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenuitem>
\end_layout
\end_inset
" and start it from there (this is for KDE only!).
\end_layout
\begin_layout Section
Settings for Linux
\begin_inset CommandInset label
LatexCommand label
name "sec.Settings-for-Linux"
\end_inset
\end_layout
\begin_layout Standard
SportWatcher tries to find out the USB port, where you've connected your
GPS device itself and then it accesses this port directly.
Unfortunately this is often forbidden for normal users.
To grant access to the USB port for SportWatcher, you've to tell the UDEV
system, that it should set the access rights of the USB port in a way,
that a normal user is allowed to read and write.
While it's possible to run SportWatcher with root priviledges, what is
not recomended, you can add some lines to a configuration file of UDEV.
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
greift direkt auf das USB-Port zu, an dem Sie Ihren
\begin_inset ERT
status open
\begin_layout Plain Layout
<hardware>
\end_layout
\end_inset
Forerunner 305
\begin_inset ERT
status open
\begin_layout Plain Layout
</hardware>
\end_layout
\end_inset
angeschlossen haben.
Allerdings fehlen einem normalen Anwender daf
\begin_inset ERT
status open
\begin_layout Plain Layout
ü
\end_layout
\end_inset
r in der Regel die Berechtigungen, so das beim Versuch die Daten aus der
Uhr auszulesen, eine Fehlermeldung erscheint.
Startet man das Programm jedoch als Benutzer root, funktioniert das Auslesen
von Daten einwandfrei.
Diesem Problem kann man nun auf zwei Arten begegnen.
Man kann
\noun on
SportWatcher
\noun default
immer als
\emph on
root
\emph default
ausf
\begin_inset ERT
status open
\begin_layout Plain Layout
ü
\end_layout
\end_inset
hren, wovon ich jedoch dringend abrate, oder man manipuliert einmal die
Einstellungen von
\emph on
udev
\emph default
und vergibt die notwendigen Berechtigungen.
Im Folgenden wird Schritt f
\begin_inset ERT
status open
\begin_layout Plain Layout
ü
\end_layout
\end_inset
r Schritt erkl
\begin_inset ERT
status open
\begin_layout Plain Layout
ä
\end_layout
\end_inset
rt, wie man die ben
\begin_inset ERT
status open
\begin_layout Plain Layout
ö
\end_layout
\end_inset
tigten Berechtigungen einstellt.
\end_layout
\begin_layout Subsection
For Debian and (K)Ubuntu
\begin_inset CommandInset label
LatexCommand label
name "sec.For-Debian-and"
\end_inset
\end_layout
\begin_layout Standard
Open a shell and become root.
Then type in the following commands:
\end_layout
\begin_layout Code
# cd /etc/udev/rules.d
\end_layout
\begin_layout Code
# vi z60-garmin.rules
\end_layout
\begin_layout Standard
Instead of
\begin_inset ERT
status open
\begin_layout Plain Layout
<command>
\end_layout
\end_inset
vi
\begin_inset ERT
status open
\begin_layout Plain Layout
</command>
\end_layout
\end_inset
you can use any other text editor, of course.
Enter the following lines into the new created file:
\end_layout
\begin_layout Code
SYSFS{idVendor}=="091e", SYSFS{idProduct}=="0003", MODE="0666"
\end_layout
\begin_layout Code
ATTRS{idVendor}=="091e", ATTRS{idProduct}=="0003", MODE="0666"
\end_layout
\begin_layout Standard
Save the file and restart UDEV by typing the following command on the command
line:
\end_layout
\begin_layout Code
# /etc/init.d/udev restart
\end_layout
\begin_layout Standard
From now on, the access to the USB port - only for your Garmin Forerunner,
regardless on which of the connectors you conected it - should be granted.
\end_layout
\begin_layout Subsection
Other distributions
\begin_inset CommandInset label
LatexCommand label
name "sec.Other-distributions"
\end_inset
\end_layout
\begin_layout Standard
As long as your Linux distribution uses UDEV, the description above should
work.
In case your distribution uses something else, ask your system administrator,
or read the documentation of your system.
Especialy the chapter about setting rights on USB ports.
\end_layout
\begin_layout Subsection
It still doesn't work
\begin_inset CommandInset label
LatexCommand label
name "sec.It-still-doesn"
\end_inset
\end_layout
\begin_layout Standard
In case of troubles, if the above instruction doesn't work, you should check
the vendor and product number of your GPS device.
If they differ from the ones above, type in the correct ones.
You can find out this numbers with the command:
\end_layout
\begin_layout Code
$ lsusb
\end_layout
\begin_layout Chapter
Working with
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "cha.Working-with"
\end_inset
\end_layout
\begin_layout Section
The menu
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenu>
\end_layout
\end_inset
File
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenu>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.The-menu-File"
\end_inset
\end_layout
\begin_layout Subsection
Read in aktivities
\begin_inset CommandInset label
LatexCommand label
name "sec.Read-in-aktivities"
\end_inset
\end_layout
\begin_layout Standard
To visualize anything, SportWatcher must read some informations from a GPS
receiver.
To do this, SportWatcher offers a menu point:
\end_layout
\begin_layout Standard
\align center
\begin_inset ERT
status open
\begin_layout Plain Layout
<screenshot>
\end_layout
\begin_layout Plain Layout
<screeninfo>The menu "File"</screeninfo>
\end_layout
\begin_layout Plain Layout
<mediaobject>
\end_layout
\begin_layout Plain Layout
<imageobject>
\end_layout
\begin_layout Plain Layout
<imagedata fileref="menuFile.png" format="PNG"></imagedata>
\end_layout
\begin_layout Plain Layout
</imageobject>
\end_layout
\begin_layout Plain Layout
<textobject>
\end_layout
\begin_layout Plain Layout
<phrase>Menu File</phrase>
\end_layout
\begin_layout Plain Layout
</textobject>
\end_layout
\begin_layout Plain Layout
</mediaobject>
\end_layout
\begin_layout Plain Layout
</screenshot>
\end_layout
\end_inset
\end_layout
\begin_layout Subsubsection
Der Menu item
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenuitem>
\end_layout
\end_inset
Read data
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenuitem>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.Der-Menu-Read"
\end_inset
\end_layout
\begin_layout Standard
With the menu item
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenuitem>
\end_layout
\end_inset
Read data
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenuitem>
\end_layout
\end_inset
, it reads out all aktivities currently stored on the watch.
After clicking on this menu point, a window appears, showing the progress
of the read process.
\end_layout
\begin_layout Standard
\align center
\begin_inset ERT
status open
\begin_layout Plain Layout
<screenshot>
\end_layout
\begin_layout Plain Layout
<screeninfo>Progress dialog</screeninfo>
\end_layout
\begin_layout Plain Layout
<mediaobject>
\end_layout
\begin_layout Plain Layout
<imageobject>
\end_layout
\begin_layout Plain Layout
<imagedata fileref="Progress.png" format="PNG"></imagedata>
\end_layout
\begin_layout Plain Layout
</imageobject>
\end_layout
\begin_layout Plain Layout
<textobject>
\end_layout
\begin_layout Plain Layout
<phrase>Progress dialog</phrase>
\end_layout
\begin_layout Plain Layout
</textobject>
\end_layout
\begin_layout Plain Layout
</mediaobject>
\end_layout
\begin_layout Plain Layout
</screenshot>
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Depending on the set of data in the watch, this may take up to several minutes.
As soon as everything was read successful, the progress dialog disappears,
and one or more new entries appear at the left of the program window.
Everything is saved in files on your disk at this time.
SportWatcher allways reads the complete memory of the watch, but it saves
only new aktivities.
Existent activities are never overwritten.
\end_layout
\begin_layout Standard
At least the Garmin Forerunner305 reorganizes the aktivities, if memory
is nearly full.
It deletes messure points and leaves only the laps.
If SportWatcher would overwrite already saved activities, the meassure
point would be lost.
\end_layout
\begin_layout Standard
In case you've trouble getting the activities out of the watch, read the
section
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.Settings-for-Linux"
\end_inset
.
\end_layout
\begin_layout Subsubsection
The menu item
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenu>
\end_layout
\end_inset
Open
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenu>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.The-menu-Open"
\end_inset
\end_layout
\begin_layout Standard
After clicking on this item, a dialog window appears.
There is a filter installed, showing only files with the extension
\begin_inset ERT
status open
\begin_layout Plain Layout
<literal role="extension">
\end_layout
\end_inset
.gmn
\begin_inset ERT
status open
\begin_layout Plain Layout
</literal>
\end_layout
\end_inset
.
This files are in the format,
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
uses internal.
In case you've files in this format, you can read them in here.
If you selected a valid file,
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
reads the file and saves it in it own directory structure.
Then the activity appear in the list of activities on the left side of
the main window.
\end_layout
\begin_layout Subsubsection
The Menu item
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenuitem>
\end_layout
\end_inset
Import
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenuitem>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.The-Menu-Import"
\end_inset
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
is able to read files created from Garmin
\begin_inset ERT
status open
\begin_layout Plain Layout
<command>
\end_layout
\end_inset
Trainingcenter
\begin_inset ERT
status open
\begin_layout Plain Layout
</command>
\end_layout
\end_inset
.
This files have usually the file extension
\begin_inset ERT
status open
\begin_layout Plain Layout
<literal role="extension">
\end_layout
\end_inset
.tcx
\begin_inset ERT
status open
\begin_layout Plain Layout
</literal>
\end_layout
\end_inset
and are simple XML files.
There is also other software who can output activities in this format.
\end_layout
\begin_layout Standard
After clicking on this item, a file dialog box appears.
The filter is set to files with the extension
\begin_inset ERT
status open
\begin_layout Plain Layout
<literal role="extension">
\end_layout
\end_inset
.tcx
\begin_inset ERT
status open
\begin_layout Plain Layout
</literal>
\end_layout
\end_inset
.
Select the wanted file and click on button
\begin_inset ERT
status open
\begin_layout Plain Layout
<guibutton>
\end_layout
\end_inset
Open
\begin_inset ERT
status open
\begin_layout Plain Layout
</guibutton>
\end_layout
\end_inset
.
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
reads the file, evaluates it and parses it.
If it's valid, it will be stored as a new activity.
\end_layout
\begin_layout Subsection
Export activities
\begin_inset CommandInset label
LatexCommand label
name "sec.Export-activities"
\end_inset
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
can save the activities in several formats.
Not every format can contain all informations of an activity.
Most of them can hold only the GPS informations.
The export features of SportWatcher allows other programs to visualize
a track, for example, in special ways.
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
currently supports the following formats:
\end_layout
\begin_layout Itemize
TCX - Garmin Trainig Center
\end_layout
\begin_layout Itemize
GPX - GPS Exchange Format
\end_layout
\begin_layout Itemize
OSM - Open Street Map Format
\end_layout
\begin_layout Itemize
HRM - Polar Heart Rate Monitor Format
\end_layout
\begin_layout Subsubsection
The menu item
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenuitem>
\end_layout
\end_inset
Save heart rate
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenuitem>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.The-menu-HR"
\end_inset
\end_layout
\begin_layout Standard
The software comming with the sport watches of Polar support the proprietary
format
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
HRM
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
(Heart Rate Monitor).
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
can export an activity in this format.
Unfortunately this format can hold only the heart rate information, the
laps, and the total time of the activity.
\end_layout
\begin_layout Standard
After clicking the item
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenuitem>
\end_layout
\end_inset
Save heart rate
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenuitem>
\end_layout
\end_inset
a file dialog box appears.
Choose the directory where you wand to save the file and type in the wanted
file name.
There is allready a filename ther in the notation Polar uses.
If you like, you can change it.
Click on the button
\begin_inset ERT
status open
\begin_layout Plain Layout
<guibutton>
\end_layout
\end_inset
Save
\begin_inset ERT
status open
\begin_layout Plain Layout
</guibutton>
\end_layout
\end_inset
to save the file.
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
<note><para>Allthough &sportwatcher; can save to the <acronym>HRM</acronym>
format, it can't import it.</para></note>
\end_layout
\end_inset
\end_layout
\begin_layout Subsubsection
The menu
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenuitem>
\end_layout
\end_inset
Save as
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenuitem>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.The-menu-Save"
\end_inset
\end_layout
\begin_layout Standard
After clicking to this item, a file dialog box appears.
It allows to save the activity in one of the formats
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
TCX
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
,
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
GPX
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
and
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
OSM
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
<screenshot>
\end_layout
\begin_layout Plain Layout
<screeninfo>Save as</screeninfo>
\end_layout
\begin_layout Plain Layout
<mediaobject>
\end_layout
\begin_layout Plain Layout
<imageobject>
\end_layout
\begin_layout Plain Layout
<imagedata fileref="SaveAs.png" format="PNG"></imagedata>
\end_layout
\begin_layout Plain Layout
</imageobject>
\end_layout
\begin_layout Plain Layout
<textobject>
\end_layout
\begin_layout Plain Layout
<phrase>Save as</phrase>
\end_layout
\begin_layout Plain Layout
</textobject>
\end_layout
\begin_layout Plain Layout
</mediaobject>
\end_layout
\begin_layout Plain Layout
</screenshot>
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Select the wanted directory and type in the file name.
Select the wanted format at the filter line and click on the button
\begin_inset ERT
status open
\begin_layout Plain Layout
<guibutton>
\end_layout
\end_inset
Save
\begin_inset ERT
status open
\begin_layout Plain Layout
</guibutton>
\end_layout
\end_inset
.
If the file allready exists, SportWatcher ask you to overwrite the file.
Decide what you want to do and click the appropriate button.
\end_layout
\begin_layout Paragraph
The format TCX
\end_layout
\begin_layout Standard
This is the format Garmins
\begin_inset ERT
status open
\begin_layout Plain Layout
<command>
\end_layout
\end_inset
Trainingcenter
\begin_inset ERT
status open
\begin_layout Plain Layout
</command>
\end_layout
\end_inset
uses.
It contains the complete information of an activity and can be used by
several programs.
It is also used by the TheoSys sport logger you'll find at
\end_layout
\begin_layout Code
\begin_inset CommandInset href
LatexCommand href
target "https://www.theosys.at/splog/index.php?lang=eng"
\end_inset
\end_layout
\begin_layout Standard
This WEB application completes the records of your activities.
Try it out.
It's free!
\end_layout
\begin_layout Paragraph
The format GPX
\end_layout
\begin_layout Standard
This format is for transporting routes, based on GPS coordinates.
It holds the GPS coordinates of every meassure point.
Together this is a route representing the track.
\end_layout
\begin_layout Paragraph
The format OSM
\end_layout
\begin_layout Standard
This format describes a complete map.
It is used by the
\begin_inset CommandInset href
LatexCommand href
name "Open Street Map"
target "http://www.openstreetmap.org"
\end_inset
project to hold maps.
Because the maps are free, they are available for everybody and everybody
can add parts to the map.
If the way you was running or byking, is currently not part of Open Street
Map and you want it be part of the map, you can use this format to add
the way to the map.
There is more information on there WEB site.
\end_layout
\begin_layout Subsection
The menu item
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenuitem>
\end_layout
\end_inset
Print
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenuitem>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.The-menu-Print"
\end_inset
\end_layout
\begin_layout Standard
After clicking on this item, the currently loaded activity will be printed.
If possible, everything is printed on one page.
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
<note><para>This function is not implemented with &sportwatcher;!</para></note>
\end_layout
\end_inset
\end_layout
\begin_layout Section
The menu
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenu>
\end_layout
\end_inset
Edit
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenu>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.The-menu-Edit"
\end_inset
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
<screenshot>
\end_layout
\begin_layout Plain Layout
<screeninfo>Menu Edit</screeninfo>
\end_layout
\begin_layout Plain Layout
<mediaobject>
\end_layout
\begin_layout Plain Layout
<imageobject>
\end_layout
\begin_layout Plain Layout
<imagedata fileref="menuEdit.png" format="PNG"></imagedata>
\end_layout
\begin_layout Plain Layout
</imageobject>
\end_layout
\begin_layout Plain Layout
<textobject>
\end_layout
\begin_layout Plain Layout
<phrase>Menu Edit</phrase>
\end_layout
\begin_layout Plain Layout
</textobject>
\end_layout
\begin_layout Plain Layout
</mediaobject>
\end_layout
\begin_layout Plain Layout
</screenshot>
\end_layout
\end_inset
\end_layout
\begin_layout Subsection
The menu item
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenuitem>
\end_layout
\end_inset
Rename
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenuitem>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.The-menu-Rename"
\end_inset
\end_layout
\begin_layout Standard
This menu item allows to rename an activity.
After clicking on this item, a small dialog box, with an edit line in it,
appears.
The line contails the actual name of the activity.
In case this is the default name, consisting of the date and time, the
time may be somewhat shortened.
This is because there are only 15 characters allowed.
Type in the name you want and them click on the button
\begin_inset ERT
status open
\begin_layout Plain Layout
<guibutton>
\end_layout
\end_inset
Ok
\begin_inset ERT
status open
\begin_layout Plain Layout
</guibutton>
\end_layout
\end_inset
.
This saves the new name and it shows up in the list of activities on the
left side of the main window.
\end_layout
\begin_layout Section
The menu
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenu>
\end_layout
\end_inset
Settings
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenu>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.The-menu-Settings"
\end_inset
\end_layout
\begin_layout Standard
You must not setup SportWatcher to make use of it.
After successful installation, it should work out of the box.
But as allways, there are some settings available.
The following items show step by step the possible settings and their meaning.
\end_layout
\begin_layout Standard
\align center
\begin_inset ERT
status open
\begin_layout Plain Layout
<screenshot>
\end_layout
\begin_layout Plain Layout
<screeninfo>Menu Settings</screeninfo>
\end_layout
\begin_layout Plain Layout
<mediaobject>
\end_layout
\begin_layout Plain Layout
<imageobject>
\end_layout
\begin_layout Plain Layout
<imagedata fileref="menuSettings.png" format="PNG"></imagedata>
\end_layout
\begin_layout Plain Layout
</imageobject>
\end_layout
\begin_layout Plain Layout
<textobject>
\end_layout
\begin_layout Plain Layout
<phrase>Menu Settings</phrase>
\end_layout
\begin_layout Plain Layout
</textobject>
\end_layout
\begin_layout Plain Layout
</mediaobject>
\end_layout
\begin_layout Plain Layout
</screenshot>
\end_layout
\end_inset
\end_layout
\begin_layout Subsection
The menu item
\series bold
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenuitem>
\end_layout
\end_inset
Configure SportWatcher
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenuitem>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.The-menu-ConfSPW"
\end_inset
\end_layout
\begin_layout Standard
This item opens a dialog box, where you can set sevaral things.
\end_layout
\begin_layout Standard
\align center
\begin_inset ERT
status open
\begin_layout Plain Layout
<screenshot>
\end_layout
\begin_layout Plain Layout
<screeninfo>Configure SportWatcher</screeninfo>
\end_layout
\begin_layout Plain Layout
<mediaobject>
\end_layout
\begin_layout Plain Layout
<imageobject>
\end_layout
\begin_layout Plain Layout
<imagedata fileref="ConfigureSportWatcher.png" format="PNG"></imagedata>
\end_layout
\begin_layout Plain Layout
</imageobject>
\end_layout
\begin_layout Plain Layout
<textobject>
\end_layout
\begin_layout Plain Layout
<phrase>Configure SportWatcher</phrase>
\end_layout
\begin_layout Plain Layout
</textobject>
\end_layout
\begin_layout Plain Layout
</mediaobject>
\end_layout
\begin_layout Plain Layout
</screenshot>
\end_layout
\end_inset
\end_layout
\begin_layout Subsubsection
Heart rate limits
\begin_inset CommandInset label
LatexCommand label
name "sec.Heart-rate-limits"
\end_inset
\end_layout
\begin_layout Standard
This part contains the limits of your personal heart rate range.
You can find out this ranges with an expensive lactat test, where you have
to repeat this test several times to get the real limits.
If you want to do that, ask the doctor of trust.
\end_layout
\begin_layout Standard
A simpler method is the following formular:
\end_layout
\begin_layout Code
<Max.
HR> = 220 - <age>
\end_layout
\begin_layout Standard
From the maximum heart rate you can calculate the levels (or zones).
The following table shows how:
\end_layout
\begin_layout Standard
\begin_inset Tabular
<lyxtabular version="3" rows="6" columns="4">
<features>
<column alignment="left" valignment="top" width="0">
<column alignment="left" valignment="top" width="0">
<column alignment="left" valignment="top" width="0">
<column alignment="left" valignment="top" width="0">
<row>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
Level
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\series bold
Intensity
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\series bold
Running
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
\series bold
Bike
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
0 (<1)
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
very low
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
< 65% (Regular run)
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
< 52% (CO --> Compensation)
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
1
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
low
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
65% - 80% (Ext run --> extensive run)
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
52% - 65% (SP1 --> Basic staying power 1)
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
2
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
middle
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
80% - 85% (Int run --> intensive run)
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
65% - 77% (SP2 --> Basic staying power 2)
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
3
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
high
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
85% - 90% (SPR --> speed run)
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
77% - 90% (PO--> Power)
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
4 (>3)
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
very high
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
> 90% (R --> Race)
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
> 90% (HP --> High power)
\end_layout
\end_inset
</cell>
</row>
</lyxtabular>
\end_inset
\end_layout
\begin_layout Subsubsection
Other limits
\begin_inset CommandInset label
LatexCommand label
name "sec.Other-limits"
\end_inset
\end_layout
\begin_layout Standard
The
\begin_inset ERT
status open
\begin_layout Plain Layout
<guilabel>
\end_layout
\end_inset
VO2max
\begin_inset ERT
status open
\begin_layout Plain Layout
</guilabel>
\end_layout
\end_inset
gives the maximum oxygen saturation in percent.
This indicator is also found during a lactat test.
Unfortunately there is no simple formula to calculate this, as far as I
know.
The second value
\begin_inset ERT
status open
\begin_layout Plain Layout
<guilabel>
\end_layout
\end_inset
weight
\begin_inset ERT
status open
\begin_layout Plain Layout
</guilabel>
\end_layout
\end_inset
is the the weight of your body in
\emph on
kilogramm
\emph default
.
\end_layout
\begin_layout Subsubsection
Device and file settings
\begin_inset CommandInset label
LatexCommand label
name "sec.Device-and-file"
\end_inset
\end_layout
\begin_layout Standard
The settings in this block defines the path and files, where SportWatcher
stores it data.
\end_layout
\begin_layout Paragraph
Even surface contour line
\begin_inset CommandInset label
LatexCommand label
name "sec.Even-surface-contour"
\end_inset
\end_layout
\begin_layout Standard
If the meassure of height is not very exact, and you get big fluctuations
especially when there are only small differences in height, you can check
this.
It will slightly even the contour line.
\end_layout
\begin_layout Paragraph
Use serial port instead of USB port
\begin_inset CommandInset label
LatexCommand label
name "sec.Use-serial-port"
\end_inset
\end_layout
\begin_layout Standard
If your GPS receiver has only a serial port, you can set this here.
You can set the name of the device as described under
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.Serial-device"
\end_inset
.
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
<note><para>This function is not tested and it's very likely that it will
not work!</para></note>
\end_layout
\end_inset
\end_layout
\begin_layout Paragraph
Serial device
\begin_inset CommandInset label
LatexCommand label
name "sec.Serial-device"
\end_inset
\end_layout
\begin_layout Standard
The name of the serial device your GPS receiver is connected to.
This is only enabled, if you've checked
\begin_inset ERT
status open
\begin_layout Plain Layout
<guilabel>
\end_layout
\end_inset
Use serial port instead of USB port
\begin_inset ERT
status open
\begin_layout Plain Layout
</guilabel>
\end_layout
\end_inset
(look at
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.Use-serial-port"
\end_inset
).
\end_layout
\begin_layout Paragraph
Data files
\begin_inset CommandInset label
LatexCommand label
name "sec.Data-files"
\end_inset
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
save the data files, containing the activities in the directory, you specify
here.
Standard is
\begin_inset ERT
status open
\begin_layout Plain Layout
<literal role="extension">
\end_layout
\end_inset
.sportwatcher
\begin_inset ERT
status open
\begin_layout Plain Layout
</literal>
\end_layout
\end_inset
in your home directory.
After the first start, and after you've downloaded your first activity,
\begin_inset ERT
status open
\begin_layout Plain Layout
&sportwatcher;
\end_layout
\end_inset
creates this directory, in case it does not already exist, and saves the
activities there.
\end_layout
\begin_layout Paragraph
HRM files
\begin_inset CommandInset label
LatexCommand label
name "sec.HRM-files"
\end_inset
\end_layout
\begin_layout Standard
SportWatcher is able to save the heart rate data of an activity into Polars
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
HRM
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
format.
If you do that (look at
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.The-menu-HR"
\end_inset
), the file dialog box opens with the directory you set here.
In case you use the software from Polar, than you can set this directory
to the one your Polar software uses.
SportWatcher sets the file name to the same notation Polar uses.
This makes the files from SportWatcher fit seamlessly into the ones of
Polar.
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
<note><para>Because the format from Polar can only hold heard rate data
with a fixed sample rate (5, 15, 30 or 60 seconds) the meassure points
are averaged to fit the sample rate (look at <xref linkend="sec.Other-limits"
/>)</para></note>
\end_layout
\end_inset
\end_layout
\begin_layout Paragraph
Map file
\begin_inset CommandInset label
LatexCommand label
name "sec.Map-file"
\end_inset
\end_layout
\begin_layout Standard
Enter in this line the path and name of a file that is a raster image of
a map or a control file.
It depends on the type of map (look at
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.Map-type"
\end_inset
) you've set.
\end_layout
\begin_layout Subparagraph
Raster images
\end_layout
\begin_layout Standard
A raster image is a simple picture file.
You can view such files with nearly every graphic program (
\begin_inset ERT
status open
\begin_layout Plain Layout
<command>
\end_layout
\end_inset
GIMP
\begin_inset ERT
status open
\begin_layout Plain Layout
</command>
\end_layout
\end_inset
,
\begin_inset ERT
status open
\begin_layout Plain Layout
<command>
\end_layout
\end_inset
Gwenview
\begin_inset ERT
status open
\begin_layout Plain Layout
</command>
\end_layout
\end_inset
, etc.).
These files have extensions like
\begin_inset ERT
status open
\begin_layout Plain Layout
<literal role="extension">.gif</literal>
\end_layout
\end_inset
,
\begin_inset ERT
status open
\begin_layout Plain Layout
<literal role="extension">.png</literal>
\end_layout
\end_inset
,
\begin_inset ERT
status open
\begin_layout Plain Layout
<literal role="extension">.tiff</literal>
\end_layout
\end_inset
and the like.
To make use of such images, you've to know the geo coordinates of the upper
left and the lower right corner.
Only the format
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>TIFF</acronym>
\end_layout
\end_inset
allows to save the geo coordinates directly in the file header.
But this is an optional information and you can't be sure that it's there.
These raster images have the drawback, that they have a fixed resolution.
They also show only a particular area and if your training session is partly
or completely off this area, you get only a part or even no map.
The advantage of a raster image is, that you need no external server or
network connection to get them.
Because they are local on your disc, they are allways available.
\end_layout
\begin_layout Subparagraph
Other sources of maps
\end_layout
\begin_layout Standard
To not have the dawback of a raster image, you can use a
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
WMS
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
server as a source of maps.
Unless this server isn't running on your local machine, you need an internet
connection to access it.
If you've set a
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
WMS
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
server, you must enter here the path and the name of the control file.
SportWatcher creates this control file itself, so you don't have to bother
with it.
Entering the name here makes sure, it will be created in a directory, where
SportWatcher have read and write access to.
\end_layout
\begin_layout Standard
Allthoug you can select
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
Shape
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
files as a source too, this is currently not supported.
In case of a
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
Shape
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
file you've to enter here only the path where the
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
Shape
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
files are.
In future SportWatcher will be able to read them and draw a map out of
them.
This will combine the advantages of vector maps with the advantages of
local raster images, because a
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
Shape
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
file is a local file, containing a map, or a part of it, in vector coordinates.
\end_layout
\begin_layout Paragraph
Map type
\begin_inset CommandInset label
LatexCommand label
name "sec.Map-type"
\end_inset
\end_layout
\begin_layout Standard
This sets the type of map.
Basicly you can distinguish between raster images and vector based maps.
Most vector based maps (
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
WMS
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
servers,
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
Shape
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
files) need the name and location where SportWatcher can create a control
file (look at
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.Map-file"
\end_inset
).
For raster images you've to set the path and name of the file containing
the raster image.
\end_layout
\begin_layout Standard
The setting here is necessary to allow SportWatcher to decide which settings
dialog to show (look at
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.The-menu-ConfMap"
\end_inset
).
\end_layout
\begin_layout Subsubsection
Units
\begin_inset CommandInset label
LatexCommand label
name "sec.Units"
\end_inset
\end_layout
\begin_layout Standard
Here you can set metric units or U.S.
statute.
\end_layout
\begin_layout Standard
In case of metric units, SportWatcher shows meters, kilometers, kilometer
per hour.
If you still used to the old U.S.
statute units, SportWatcher shows feets, miles and miles per hour.
\end_layout
\begin_layout Subsection
The menu item
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenuitem>
\end_layout
\end_inset
Configure map
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenuitem>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.The-menu-ConfMap"
\end_inset
\end_layout
\begin_layout Standard
Dependend on the set map type (look at
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.Map-type"
\end_inset
), SportWatcher displays an individual dialog to set the necessary settings
for the selected map.
Currently there are two dialog boxes.
One to set everything for a
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
WMS
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
server and one to define the corners of a map in geo coordinates.
\end_layout
\begin_layout Subsubsection
WMS
\begin_inset CommandInset label
LatexCommand label
name "sec.WMS"
\end_inset
\end_layout
\begin_layout Standard
\align center
\begin_inset ERT
status open
\begin_layout Plain Layout
<screenshot>
\end_layout
\begin_layout Plain Layout
<screeninfo>Configure WMS</screeninfo>
\end_layout
\begin_layout Plain Layout
<mediaobject>
\end_layout
\begin_layout Plain Layout
<imageobject>
\end_layout
\begin_layout Plain Layout
<imagedata fileref="ConfigureWMS.png" format="PNG"></imagedata>
\end_layout
\begin_layout Plain Layout
</imageobject>
\end_layout
\begin_layout Plain Layout
<textobject>
\end_layout
\begin_layout Plain Layout
<phrase>Configure WMS</phrase>
\end_layout
\begin_layout Plain Layout
</textobject>
\end_layout
\begin_layout Plain Layout
</mediaobject>
\end_layout
\begin_layout Plain Layout
</screenshot>
\end_layout
\end_inset
\end_layout
\begin_layout Standard
This dialog contains all necessary controls to set up the
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
WMS
\lang english
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
client.
You can access a WMS server over the
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
HTTP
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
protocol.
To get a map, you can use a simple
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
URL
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
.
You can use your internet browser to try that out.
Type in the following URL:
\end_layout
\begin_layout Code
http://onearth.jpl.nasa.gov/wms.cgi?VERSION=1.1.1&REQUEST=GetMap&SRS=EPSG:4326&LAYERS=
modis,global_mosaic&STYLES=&FORMAT=image/png&WIDTH=800&HEIGHT=600&BBOX=14.200104,
46.612177,14.307995,46.633730
\end_layout
\begin_layout Standard
You should get a satelite picture of a part of
\emph on
Klagenfurt
\emph default
, a city in austria, and a piece of the
\emph on
W
\begin_inset ERT
status open
\begin_layout Plain Layout
ö
\end_layout
\end_inset
rtersee
\emph default
, a lake.
\emph on
Klagenfurt
\emph default
is on the bank of this lake.
This example shows how easy it is to access a WMS server.
SportWatcher sets all necessary parameters, including the wanted boundaries
for you, so you don't have to bother with that.
Beside the WMS server in our example, there are many others available.
Look at
\end_layout
\begin_layout Code
\begin_inset CommandInset href
LatexCommand href
name "http://www.skylab-mobilesystems.com/ger/wms_serverlist.html"
target "http://www.skylab-mobilesystems.com/ger/wms_serverlist.html"
\end_inset
\end_layout
\begin_layout Standard
for a large list of free WMS servers.
\end_layout
\begin_layout Paragraph
Server URL
\begin_inset CommandInset label
LatexCommand label
name "sec.Server-URL"
\end_inset
\end_layout
\begin_layout Standard
Enter the
\begin_inset ERT
status open
\begin_layout Plain Layout
<acronym>
\end_layout
\end_inset
URL
\begin_inset ERT
status open
\begin_layout Plain Layout
</acronym>
\end_layout
\end_inset
of the WMS server.
Related to our example above, this would be:
\end_layout
\begin_layout Code
http://onearth.jpl.nasa.gov/wms.cgi
\end_layout
\begin_layout Standard
You can omit the extra parameters, as shown in the above example, because
SportWatcher will set them for you.
\end_layout
\begin_layout Paragraph
Layer name
\begin_inset CommandInset label
LatexCommand label
name "sec.Layer-name"
\end_inset
\end_layout
\begin_layout Standard
A WMS server can provide several
\emph on
layers
\emph default
to distinguish between parts of a map.
Imagine a street map, for example.
There one layer could contain the streets, another contains the rivers
and another the rail ways.
Putting this three layer together results in a complete street map.
If you enter some layer names, you have to separate them with commas.
Thing about the order of the maps! For example: Should the streets be drawn
over the rivers or the other way?
\end_layout
\begin_layout Paragraph
SRS
\begin_inset CommandInset label
LatexCommand label
name "sec.SRS"
\end_inset
\end_layout
\begin_layout Standard
To get a map with correct dimensions, the WMS server have to know the wanted
geodetic date.
If you want to learn more about geoids and projections, look at:
\end_layout
\begin_layout Code
\begin_inset CommandInset href
LatexCommand href
name "http://en.wikipedia.org/wiki/Geoid"
target "http://en.wikipedia.org/wiki/Geoid"
\end_inset
\end_layout
\begin_layout Standard
SportWatcher provides several geodetic dates.
You must choose one, that is supported by the WMS server.
Otherwise the map will not exactly fit under the tracks.
In doubt take
\emph on
EPSG:4326
\emph default
, also known as
\emph on
WGS84
\emph default
.
\end_layout
\begin_layout Paragraph
CRS
\begin_inset CommandInset label
LatexCommand label
name "sec.CRS"
\end_inset
\end_layout
\begin_layout Standard
CRS is mostly the same as SRS (look at
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.SRS"
\end_inset
).
But this parameter is optional.
In doubt, take
\emph on
WGS84
\emph default
.
\end_layout
\begin_layout Paragraph
Bands
\end_layout
\begin_layout Standard
A WMS server returns a raster image, representing the requested map.
Every digital picture consist of informations for every of the three color
channels red, green and blue.
Such a channel is also called a band (because of the method the information
of the picture is managed internally).
In case of a color picture, there are at least three bands.
However.
Such a picture could contain a fourth band, called the alpha channel.
The alpha channels defines the transparency of every pixel of the picture.
It is important to set the correct number of bands, because you'll get
an error if this is set wrong!
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
<note><para>If you get an error stating wrong band count, start &sportwatcher;
from the command line and try to get the map again.
&sportwatcher; puts out some error messages where you can find out the
needed band count.</para></note>
\end_layout
\end_inset
\end_layout
\begin_layout Paragraph
Version
\begin_inset CommandInset label
LatexCommand label
name "sec.Version"
\end_inset
\end_layout
\begin_layout Standard
There are more than one version of communication protocol for WMS servers.
A WMS server should be backward compatible and should support version 1.1.0
at least.
Today most of the WMS server support version 1.1.1.
Only newer servers also support protocol version 1.3.0.
In doubt set this to 1.1.1.
\end_layout
\begin_layout Paragraph
Stile
\begin_inset CommandInset label
LatexCommand label
name "sec.Stile"
\end_inset
\end_layout
\begin_layout Standard
Beside the above mentioned layers (look at
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.Layer-name"
\end_inset
), styles are also supported.
For most WMS servers styles are optional.
A style is a variant or part of a layer.
One layer could consist, for example, of the styles country road, interstate
road and highway.
Every kind of street can be a style.
This allows you to filter particular types of roads.
But it's only allowed to give the name of one style per layer.
Be carefull to define exactly the same number of styles, as you've defined
layers and pay attention of the order of the styles.
They must apperar in the same order like the layers (one style per layer).
\end_layout
\begin_layout Paragraph
Tile size
\begin_inset CommandInset label
LatexCommand label
name "sec.Tile-size"
\end_inset
\end_layout
\begin_layout Standard
To save band width, SportWatcher groups the map into several quadrats with
equal size.
This tiles are stored on the disk in a temporary cache.
If some parts can be reused later, SportWatcher will take them out of the
cache rather than downloading them again.
\end_layout
\begin_layout Standard
This setting allows to set the size of such a tile.
The optimal size depends on the WMS server.
You may test this to find out what works fastest.
\end_layout
\begin_layout Paragraph
Depth
\begin_inset CommandInset label
LatexCommand label
name "sec.Depth"
\end_inset
\end_layout
\begin_layout Standard
Number of directory layers.
2 will result in files being written as <cache_path>/A/B/ABCDEF...
(defaults to 2).
\end_layout
\begin_layout Paragraph
Overview count
\begin_inset CommandInset label
LatexCommand label
name "sec.Overview-count"
\end_inset
\end_layout
\begin_layout Standard
Count of reduced resolution layers each having 2 times lower resolution.
In doubt set to 10.
\end_layout
\begin_layout Paragraph
WMS Server uses square pixels
\begin_inset CommandInset label
LatexCommand label
name "sec.WMS-squarepixel"
\end_inset
\end_layout
\begin_layout Standard
In case you find a WMS server that is not able to calculate the projection
correct, you can try to set this option.
\end_layout
\begin_layout Paragraph
Offline mode
\begin_inset CommandInset label
LatexCommand label
name "sec.Offline-mode"
\end_inset
\end_layout
\begin_layout Standard
If you set this option, SportWatcher will not try to get a map from a WMS
server.
It only looks into the local cache and if it finds a map there, it displays
ist.
Otherwise the track appears with a black background.
\end_layout
\begin_layout Paragraph
Advice read
\begin_inset CommandInset label
LatexCommand label
name "sec.Advice-read"
\end_inset
\end_layout
\begin_layout Standard
Download images into cache.
This saves time and brings a map faster to screen.
\end_layout
\begin_layout Paragraph
Verify advice read
\begin_inset CommandInset label
LatexCommand label
name "sec.Verify-advice-read"
\end_inset
\end_layout
\begin_layout Standard
Open each downloaded image and do some basic checks before writing into
cache.
Disabling can save some CPU cycles if server is trusted to always return
correct images.
\end_layout
\begin_layout Paragraph
Add meters to longitude
\begin_inset CommandInset label
LatexCommand label
name "sec.Add-meters-longitude"
\end_inset
\end_layout
\begin_layout Standard
In case the map is moved a little in x direction, you can correct it here.
Type in the number of meters, the map is moved.
\end_layout
\begin_layout Paragraph
Add meters to latitude
\begin_inset CommandInset label
LatexCommand label
name "sec.Add-meters-latitude"
\end_inset
\end_layout
\begin_layout Standard
In case the map is moved a little in y direction, you can correct it here.
Type in the number of meters, the map is moved.
\end_layout
\begin_layout Subsubsection
Image coordinates
\begin_inset CommandInset label
LatexCommand label
name "sec.Image-coordinates"
\end_inset
\end_layout
\begin_layout Standard
\align center
\begin_inset ERT
status open
\begin_layout Plain Layout
<screenshot>
\end_layout
\begin_layout Plain Layout
<screeninfo>Image coordinates</screeninfo>
\end_layout
\begin_layout Plain Layout
<mediaobject>
\end_layout
\begin_layout Plain Layout
<imageobject>
\end_layout
\begin_layout Plain Layout
<imagedata fileref="ConfigureCoordinates.png" format="PNG"></imagedata>
\end_layout
\begin_layout Plain Layout
</imageobject>
\end_layout
\begin_layout Plain Layout
<textobject>
\end_layout
\begin_layout Plain Layout
<phrase>Image coordinates</phrase>
\end_layout
\begin_layout Plain Layout
</textobject>
\end_layout
\begin_layout Plain Layout
</mediaobject>
\end_layout
\begin_layout Plain Layout
</screenshot>
\end_layout
\end_inset
\end_layout
\begin_layout Standard
In case you've choosen a kind of raster image as your map, this dialog appears.
Here you can set the corners in geographical format.
One drawback of raster formats is, that they contain no geographical informatio
n.
To allow SportWatcher to use such raster images, it must know the dimensions
of the map.
An even bigger drawback is the fixed resolution of the map.
Depending of the magnifier, the map may look blurred or it looks coarse-grained.
One benefit of such maps is, that they are available offline and they are
faster than every vector format.
\end_layout
\begin_layout Paragraph
Upper left corner
\begin_inset CommandInset label
LatexCommand label
name "sec.Upper-left-corner"
\end_inset
\end_layout
\begin_layout Standard
This defines the upper left corner.
Define this values in the format of the set
\begin_inset CommandInset ref
LatexCommand ref
name "projection"
reference "sec.Projection"
\end_inset
.
\end_layout
\begin_layout Paragraph
Lower right corner
\begin_inset CommandInset label
LatexCommand label
name "sec.Lower-right-corner"
\end_inset
\end_layout
\begin_layout Standard
his defines the lower right corner.
Define this values in the format of the set
\begin_inset CommandInset ref
LatexCommand ref
name "projection"
reference "sec.Projection"
\end_inset
.
\end_layout
\begin_layout Paragraph
Projection
\begin_inset CommandInset label
LatexCommand label
name "sec.Projection"
\end_inset
\end_layout
\begin_layout Standard
This setting defines the
\begin_inset CommandInset href
LatexCommand href
name "graphical projection"
target "http://en.wikipedia.org/wiki/Graphical_projection"
\end_inset
of the map.
Graphical projection is a protocol by which an image of an imaginary three-dime
nsional object is projected onto a planar surface without the aid of mathematica
l calculation.
The projection is achieved by the use of imaginary "projectors".
The projected, mental image becomes the technician's vision of the desired,
finished picture.
By following the protocol the technician may produce the envisioned picture
on a planar surface such as drawing paper.
The protocols provide a uniform imaging procedure among people trained
in technical graphics (mechanical drawing, computer aided design, etc.).
\end_layout
\begin_layout Standard
SportWatcher allows to set some of the possible projections.
Choose the one, used for your map.
\end_layout
\begin_layout Section
The menu
\begin_inset ERT
status open
\begin_layout Plain Layout
<guimenu>
\end_layout
\end_inset
Help
\begin_inset ERT
status open
\begin_layout Plain Layout
</guimenu>
\end_layout
\end_inset
\begin_inset CommandInset label
LatexCommand label
name "sec.The-menu-Help"
\end_inset
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
&help.menu.documentation;
\end_layout
\end_inset
\end_layout
\begin_layout Chapter
Display a map underneath a track
\begin_inset CommandInset label
LatexCommand label
name "cha.Display-a-map"
\end_inset
\end_layout
\begin_layout Standard
SportWatcher is able to display a map underneath a track.
A track consists of several messure points who are connected with a line.
It represents the path you were running or biking.
SportWatcher supports differnt sources for maps.
Setting the map source (look at
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.The-menu-ConfSPW"
\end_inset
) is the precondition to get a map.
Another precondition is the availability of GPS coordinates.
If you train in the open, the Garmin Forerunner will record the GPS coordinates.
\end_layout
\begin_layout Standard
SportWatcher paints in a first step the map and then draws the track over
it.
If you've set everything correct, the track should fit perfect on the map.
\end_layout
\begin_layout Section
WMS Server
\begin_inset CommandInset label
LatexCommand label
name "sec.WMS-Server"
\end_inset
\end_layout
\begin_layout Standard
The
\begin_inset CommandInset href
LatexCommand href
name "Web Map Service"
target "http://en.wikipedia.org/wiki/Web_Map_Service"
\end_inset
(WMS) is an interface to request parts of a map.
Such an interface could also be called a WEB service.
The specification was designed by the
\begin_inset CommandInset href
LatexCommand href
name "Open Geospatial Consortium"
target "http://en.wikipedia.org/wiki/Open_Geospatial_Consortium"
\end_inset
(OGC).
It describes the parameters needed for a request.
It also defines, how a WMS server should generate a map out of the request.
\end_layout
\begin_layout Standard
SportWatcher supports the access to any WMS server out of the box.
Just choose WMS server as the source for maps and set everything necessary
as described at
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.WMS"
\end_inset
.
\end_layout
\begin_layout Section
Map out of a raster image
\begin_inset CommandInset label
LatexCommand label
name "sec.Map-out-of"
\end_inset
\end_layout
\begin_layout Standard
In case you have a picture representing a map, SportWatcher needs geographical
reference points.
Formats like PNG (Portable Network Graphics), BMP (Bitmap), GIF (Graphics
Image Format), and so on, are called raster images.
First, you have to find a map of the wanted area in the wanted resolution.
Once this is done, you must find out the geodetic date of th map.
This may be difficult, but is absolutely needed! Once this is also done,
you should know the upper left and the lower right corner in geographical
coordinates.
With all this informations, you can start to enter the needed parameters.
Part
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.Map-file"
\end_inset
let you define the path to the map and the file name of the map.
With
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.Map-type"
\end_inset
you can define the type of the map.
Now most of the work is done.
Now only the definations of the corners is left.
Look at
\begin_inset CommandInset ref
LatexCommand ref
reference "sec.Image-coordinates"
\end_inset
for an explanation of how to do that.
Once this is done, SportWatcher should display a map underneath the track.
The map must not have exactly the size of the track.
In fact it should be bigger (maybe a lot bigger).
I recomend to find a map about your whole training area.
SportWatcher will cut the needed piece and stretch and push it to fit into
the given drawing space.
\end_layout
\begin_layout Section
Shape files
\begin_inset CommandInset label
LatexCommand label
name "sec.Shape-files"
\end_inset
\end_layout
\begin_layout Standard
The ESRI Shapefile or simply a shapefile is a popular geospatial vector
data format for geographic information systems software.
It is developed and regulated by
\begin_inset CommandInset href
LatexCommand href
name "ESRI"
target "http://en.wikipedia.org/wiki/ESRI"
\end_inset
as a (mostly) open specification for data interoperability among ESRI and
other software products.
A "shapefile" commonly refers to a collection of files with extensions
of
\begin_inset ERT
status open
\begin_layout Plain Layout
<literal role="extension">
\end_layout
\end_inset
.shp
\begin_inset ERT
status open
\begin_layout Plain Layout
</literal>
\end_layout
\end_inset
,
\begin_inset ERT
status open
\begin_layout Plain Layout
<literal role="extension">
\end_layout
\end_inset
.shx
\begin_inset ERT
status open
\begin_layout Plain Layout
</literal>
\end_layout
\end_inset
,
\begin_inset ERT
status open
\begin_layout Plain Layout
<literal role="extension">
\end_layout
\end_inset
.dbf
\begin_inset ERT
status open
\begin_layout Plain Layout
</literal>
\end_layout
\end_inset
, and other extensions on a common prefix name (e.g., "lakes.*").
The actual shapefile relates specifically to files with the
\begin_inset ERT
status open
\begin_layout Plain Layout
<literal role="extension">
\end_layout
\end_inset
.shp
\begin_inset ERT
status open
\begin_layout Plain Layout
</literal>
\end_layout
\end_inset
extension, however this file alone is incomplete for distribution, as the
other supporting files are required.
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
<note><para>This format is currently not implemented!</para></note>
\end_layout
\end_inset
\end_layout
\begin_layout Section
PostGIS database
\begin_inset CommandInset label
LatexCommand label
name "sec.PostGIS-database"
\end_inset
\end_layout
\begin_layout Standard
PostGIS (
\emph on
/post'-jis/
\emph default
) is an open source software program that adds support for geographic objects
to the PostgreSQL object-relational database.
PostGIS follows the Simple Features for SQL specification from the Open
Geospatial Consortium.
As such, PostGIS includes:
\end_layout
\begin_layout Itemize
Geometry types for points, linestrings, polygons, multipoints, multilinestrings,
multipolygons and geometry collections.
\end_layout
\begin_layout Itemize
Spatial predicates for determining the interactions of geometries using
the 3x3 Egenhofer matrix (provided by GEOS).
\end_layout
\begin_layout Itemize
Spatial operators for determining geospatial measurements like area, distance,
length and perimeter.
\end_layout
\begin_layout Itemize
Spatial operators for determining geospatial set operations, like union,
difference, symmetric difference and buffers (provided by GEOS).
\end_layout
\begin_layout Itemize
R−tree spatial indexes for high speed spatial querying.
\end_layout
\begin_layout Itemize
Index selectivity support, to provide high performance query plans for mixed
spatial/non-spatial queries.
\end_layout
\begin_layout Standard
The PostGIS implementation is based on "light-weight" geometries and indexes
optimized to reduce disk and memory footprint.
Using light-weight geometries helps servers increase the amount of data
migrated up from physical disk storage into RAM, improving query performance
substantially.
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
<note><para>This function is currently not implemented!</para></note>
\end_layout
\end_inset
\end_layout
\begin_layout Chapter
Credits
\begin_inset CommandInset label
LatexCommand label
name "cha.Credits"
\end_inset
\end_layout
\begin_layout Section
Credits and License
\begin_inset CommandInset label
LatexCommand label
name "sec.Danksagung-und-Lizenz"
\end_inset
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
<para>&sportwatcher;</para>
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Program
\begin_inset ERT
status open
\begin_layout Plain Layout
<trademark class="copyright">
\end_layout
\end_inset
Copyright
\begin_inset ERT
status open
\begin_layout Plain Layout
</trademark>
\end_layout
\end_inset
2007 - 2009 by Andreas Theofilu
\begin_inset ERT
status open
\begin_layout Plain Layout
<email>
\end_layout
\end_inset
andreas@theosys.at
\begin_inset ERT
status open
\begin_layout Plain Layout
</email>
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Based on
\begin_inset ERT
status open
\begin_layout Plain Layout
<command>
\end_layout
\end_inset
garmin-tools
\begin_inset ERT
status open
\begin_layout Plain Layout
</command>
\end_layout
\end_inset
from Dave Bailey
\begin_inset ERT
status open
\begin_layout Plain Layout
<email>
\end_layout
\end_inset
dave@daveb.net
\begin_inset ERT
status open
\begin_layout Plain Layout
</email>
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Based on
\begin_inset ERT
status open
\begin_layout Plain Layout
<command>
\end_layout
\end_inset
GANT
\begin_inset ERT
status open
\begin_layout Plain Layout
</command>
\end_layout
\end_inset
from Paul
\begin_inset ERT
status open
\begin_layout Plain Layout
<email>
\end_layout
\end_inset
paul@ant.sbrk.co.uk
\begin_inset ERT
status open
\begin_layout Plain Layout
</email>
\end_layout
\end_inset
\end_layout
\begin_layout Standard
\begin_inset ERT
status open
\begin_layout Plain Layout
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
\end_layout
\begin_layout Plain Layout
&underFDL; <!-- FDL: do not remove -->
\end_layout
\begin_layout Plain Layout
&underGPL; <!-- GPL License -->
\end_layout
\end_inset
\end_layout
\end_body
\end_document