Subversion Repositories public

  <!ENTITY sportwatcher "<application>sportwatcher 0.4</application>">

  <!ENTITY sportwatcher "<application>SportWatcher 0.6</application>">

- also, quote all attributes.

<!-- XML file was created by LyX 1.6.3

<!-- The language must NOT be changed here. -->

  See http://www.lyx.org/ for more information -->

<title>The &sportwatcher; Handbook</title>

<title>The user manual for &sportwatcher;</title>

<date>2008-11-01</date>

<date>2009-07-30</date>

<releaseinfo>0.4</releaseinfo>

<releaseinfo>0.6</releaseinfo>

&sportwatcher; is an application specially designed to get out the data of

<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>

<!-- The contents of the documentation begin here.  Label

<chapter id='cha.Introduction-1' >

each chapter so with the id attribute. This is necessary for two reasons: it

<title>Introduction<!-- anchor id="cha.Introduction-1" --></title>

allows you to easily reference the chapter from other chapters of your

<para>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" (&lt;dave &lt;at&gt; daveb &lt;dot&gt; net&gt;). 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.</para><sect1 id='sec:Supported-GPS-receiver' >

document, and if there is no ID, the name of the generated HTML files will vary

<title>Supported GPS receiver<!-- anchor id="sec:Supported-GPS-receiver" --></title>

from time to time making it hard to manage for maintainers and for the CVS

<listitem><para>Garmin Forerunner305</para></listitem><listitem><para>Garmin Forerunner205</para></listitem></itemizedlist><para>If you own another type of GPS receiver and when it works with SportWatcher, please send an e−mail to <emphasis>andreas &lt;at&gt; theosys &lt;dot&gt; at</emphasis>.</para></sect1></chapter><chapter id='cha.Installation' >

system. Any chapter labelled (OPTIONAL) may be left out at the author's

<title>Installation<!-- anchor id="cha.Installation" --></title>

discretion. Other chapters should not be left out in order to maintain a

<para>&sportwatcher; was written in C++ and is made for the desktop <ulink url="http://www.kde.org">KDE</ulink>. 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 <ulink url="http://www.gnu.org/licenses/gpl.html">GNU General Public License version 3</ulink>.</para><sect1 id='sec.Download' >

consistent documentation style across all KDE apps. -->

<title>Download<!-- anchor id="sec.Download" --></title>

<listitem><para>Sourceforge: <ulink url="http://sourceforge.net/projects/sportwatcher/">Sourceforge</ulink></para></listitem><listitem><para>TheoSys: <ulink url="http://www.theosys.at/download">TheoSys</ulink></para></listitem></itemizedlist><para>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!</para>

<chapter id="introduction">

]]></screen><para>or</para><screen>

<title>Introduction</title>

<![CDATA[# svn checkout svn://www.theosys.at/sportwatcher/trunk

]]></screen><para>It is possible to access the <ulink url="http://www.theosys.at/websvn/listing.php?repname=repos+1&amp;path=/sportwatcher/trunk/&amp;rev=0&amp;sc=0">Repository</ulink>, containing the latest code, with your WEB browser too.</para><sect2 id='sec.Necessary-components' >

<!-- The introduction chapter contains a brief introduction for the

<title>Necessary components<!-- anchor id="sec.Necessary-components" --></title>

application that explains what it does and where to report

<title>KDE 4.1.x<!-- anchor id="sec.KDE-4.1.x" --></title>

problems. Basically a long version of the abstract.  Don't include a

<title>GDAL 1.5.x<!-- anchor id="sec.GDAL-1.5.x" --></title>

revision history. (see installation appendix comment) -->

<para>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.</para>

<para>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.</para>

<para>

<para>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.</para>

&sportwatcher; is a program that lets you load the data from a Garmin

<listitem><para><ulink url="http://www.theosys.at/download/gdal-1.6.1-0.pm.1.i586.rpm">gdal-1.6.1-0.pm.1.i586.rpm</ulink></para></listitem><listitem><para><ulink url="http://www.theosys.at/download/geotiff-1.2.5-0.pm.1.i586.rpm">geotiff-1.2.5-0.pm.1.i586.rpm</ulink></para></listitem><listitem><para><ulink url="http://www.theosys.at/download/libgdal1-1.6.1-0.pm.1.i586.rpm">libgdal1-1.6.1-0.pm.1.i586.rpm</ulink></para></listitem><listitem><para><ulink url="http://www.theosys.at/download/libgdal-devel-1.6.1-0.pm.1.i586.rpm">libgdal-devel-1.6.1-0.pm.1.i586.rpm</ulink></para></listitem><listitem><para><ulink url="http://www.theosys.at/download/libgeos1-3.1.0-0.pm.1.i586.rpm">libgeos1-3.1.0-0.pm.1.i586.rpm</ulink></para></listitem><listitem><para><ulink url="http://www.theosys.at/download/libgeos-devel-3.1.0-0.pm.1.i586.rpm">libgeos-devel-3.1.0-0.pm.1.i586.rpm</ulink></para></listitem><listitem><para><ulink url="http://www.theosys.at/download/libgeotiff1-1.2.5-0.pm.1.i586.rpm">libgeotiff1-1.2.5-0.pm.1.i586.rpm</ulink></para></listitem><listitem><para><ulink url="http://www.theosys.at/download/libgeotiff-devel-1.2.5-0.pm.1.i586.rpm">libgeotiff-devel-1.2.5-0.pm.1.i586.rpm</ulink></para></listitem></itemizedlist></sect3></sect2></sect1><sect1 id='sec.Compile-Install' >

Forerunner 305 and similar products, over the USB port. &sportwatcher;

<title>Compile / Install<!-- anchor id="sec.Compile-Install" --></title>

displays the laps, track, heart beats per minute and the profile of the

<title>Install the binary pakage<!-- anchor id="sec.Install-the-binary" --></title>

surface. It is able to put a satellite image underneath the track or, if

<![CDATA[]]># dpkg -i sportwatcher_<emphasis>X.X-x</emphasis>.amd64.deb 

available, a map. To do this, it can use raster images or the WMS service,

<![CDATA[]]># rpm -ivh sportwatcher-<emphasis>X.X-x</emphasis>.i586.rpm 

provided by the GDAL library.

<![CDATA[$ mkdir build 

]]></screen><para>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 <emphasis>dev</emphasis>. Install the missing packages, if necessary.</para>

Please report any problems or feature requests to andreas@theosys.at.

<para>With the following command, you start the compiler:</para><screen>

</para>

<![CDATA[$ make 

</chapter>

<para>To install &sportwatcher; 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:</para><screen>

]]></screen><para>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 "<guimenu>Utilities</guimenu>--&gt;<guimenuitem>Sportwatcher</guimenuitem>" and start it from there (this is for KDE only!).</para></sect3></sect2></sect1><sect1 id='sec.Settings-for-Linux' >

<chapter id="using-sportwatcher">

<title>Settings for Linux<!-- anchor id="sec.Settings-for-Linux" --></title>

<title>Using &sportwatcher;</title>

<para>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.</para>

<para>&sportwatcher;greift direkt auf das USB-Port zu, an dem Sie Ihren <hardware>Forerunner 305</hardware> angeschlossen haben. Allerdings fehlen einem normalen Anwender daf&uuml;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 SportWatcher immer als <emphasis>root</emphasis> ausf&uuml;hren, wovon ich jedoch dringend abrate, oder man manipuliert einmal die Einstellungen von <emphasis>udev</emphasis> und vergibt die notwendigen Berechtigungen. Im Folgenden wird Schritt f&uuml;r Schritt erkl&auml;rt, wie man die ben&ouml;tigten Berechtigungen einstellt. </para><sect2 id='sec.For-Debian-and' >

<!-- This chapter should tell the user how to use your app. You should use as

<title>For Debian and (K)Ubuntu<!-- anchor id="sec.For-Debian-and" --></title>

many sections (Chapter, Sect1, Sect3, etc...) as is necessary to fully document

<para>Open a shell and become root. Then type in the following commands:</para><screen>

your application. -->

# vi z60-garmin.rules

<para>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.</para></sect2><sect2 id='sec.It-still-doesn' >

<para>

<para>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:</para><screen>

<screenshot>

<!-- Note that all graphics should be in .png format. Use no gifs because of

         <imagedata fileref="menuFile.png" format="PNG"></imagedata>

patent issues. -->

      </imageobject>

<screeninfo>Here's a screenshot of &sportwatcher;</screeninfo>

<screeninfo>Progress dialog</screeninfo>

	<mediaobject>

   <mediaobject>

	  <imageobject>

      <imageobject>

	    <imagedata fileref="screenshot.png" format="PNG"/>

         <imagedata fileref="Progress.png" format="PNG"></imagedata>

	  </imageobject>

      </imageobject>

	  <textobject>

      <textobject>

	    <phrase>Screenshot</phrase>

         <phrase>Progress dialog</phrase>

	  </textobject>

      </textobject>

	</mediaobject>

   </mediaobject>

</para>

<para>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.</para>

<para>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.</para>

<para>In case you've trouble getting the activities out of the watch, read the section <xref linkend="sec.Settings-for-Linux" />.</para></sect3><sect3 id='sec.The-menu-Open' >

<sect1 id="sportwatcher-features">

<title>The menu item <guimenu>Open</guimenu><!-- anchor id="sec.The-menu-Open" --></title>

<title>More &sportwatcher; features</title>

<para>After clicking on this item, a dialog window appears. There is a filter installed, showing only files with the extension <literal role="extension">.gmn</literal>. This files are in the format, &sportwatcher; uses internal. In case you've files in this format, you can read them in here. If you selected a valid file, &sportwatcher; 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.</para></sect3><sect3 id='sec.The-Menu-Import' >

<title>The Menu item <guimenuitem>Import</guimenuitem><!-- anchor id="sec.The-Menu-Import" --></title>

<para>It slices! It dices! and it comes with a free toaster!</para>

<para>&sportwatcher; is able to read files created from Garmin <command>Trainingcenter</command>. This files have usually the file extension <literal role="extension">.tcx</literal> and are simple XML files. There is also other software who can output activities in this format.</para>

<para>

<para>After clicking on this item, a file dialog box appears. The filter is set to files with the extension <literal role="extension">.tcx</literal>. Select the wanted file and click on button <guibutton>Open</guibutton>. &sportwatcher; reads the file, evaluates it and parses it. If it's valid, it will be stored as a new activity.</para></sect3></sect2><sect2 id='sec.Export-activities' >

The Squiggle Tool <guiicon><inlinemediaobject>

<title>Export activities<!-- anchor id="sec.Export-activities" --></title>

	  <imageobject>

<para>&sportwatcher; 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. &sportwatcher; currently supports the following formats:</para><itemizedlist>

	    <imagedata fileref="squiggle.png" format="PNG"/>

<listitem><para>TCX - Garmin Trainig Center</para></listitem><listitem><para>GPX - GPS Exchange Format</para></listitem><listitem><para>OSM - Open Street Map Format</para></listitem><listitem><para>HRM - Polar Heart Rate Monitor Format</para></listitem></itemizedlist><sect3 id='sec.The-menu-HR' >

	  </imageobject>

<title>The menu item <guimenuitem>Save heart rate</guimenuitem><!-- anchor id="sec.The-menu-HR" --></title>

	  <imageobject>

<para>The software comming with the sport watches of Polar support the proprietary format <acronym>HRM</acronym> (Heart Rate Monitor). &sportwatcher; 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.</para>

	    <imagedata fileref="squiggle.eps" format="EPS"/>

<para>After clicking the item <guimenuitem>Save heart rate</guimenuitem> 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 <guibutton>Save</guibutton> to save the file.</para>

	  </imageobject>

<note><para>Allthough &sportwatcher; can save to the <acronym>HRM</acronym> format, it can't import it.</para></note></sect3><sect3 id='sec.The-menu-Save' >

	  <textobject>

<title>The menu <guimenuitem>Save as</guimenuitem><!-- anchor id="sec.The-menu-Save" --></title>

	    <phrase>Squiggle</phrase>

<para>After clicking to this item, a file dialog box appears. It allows to save the activity in one of the formats <acronym>TCX</acronym>, <acronym>GPX</acronym> and <acronym>OSM</acronym>.</para>

	  </textobject>

<screenshot>

</inlinemediaobject></guiicon> is used to draw squiggly lines all over

<screeninfo>Save as</screeninfo>

the &sportwatcher; main window. It's not a bug, it's a feature!

   <mediaobject>

</para>

      <imageobject>

         <imagedata fileref="SaveAs.png" format="PNG"></imagedata>

</sect1>

      </imageobject>

</chapter>

      <textobject>

         <phrase>Save as</phrase>

<chapter id="commands">

      </textobject>

<title>Command Reference</title>

   </mediaobject>

</screenshot>

<!-- (OPTIONAL, BUT RECOMMENDED) This chapter should list all of the

<para>Select the wanted directory and type in the file name. Select the wanted format at the filter line and click on the button <guibutton>Save</guibutton>. If the file allready exists, SportWatcher ask you to overwrite the file. Decide what you want to do and click the appropriate button.</para><sect4>

application windows and their menubar and toolbar commands for easy reference.

<title>The format TCX</title>

Also include any keys that have a special function but have no equivalent in the

<para>This is the format Garmins <command>Trainingcenter</command> 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</para><screen>

menus or toolbars. This may not be necessary for small apps or apps with no tool

<![CDATA[]]><ulink url="https://www.theosys.at/splog/index.php?lang=eng"></ulink>

or menu bars. -->

<![CDATA[]]></screen><para>This WEB application completes the records of your activities. Try it out. It's free!</para></sect4><sect4>

<title>The format GPX</title>

<sect1 id="sportwatcher-mainwindow">

<para>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.</para></sect4><sect4>

<title>The main &sportwatcher; window</title>

<title>The format OSM</title>

<para>This format describes a complete map. It is used by the <ulink url="http://www.openstreetmap.org">Open Street Map</ulink> 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.</para></sect4></sect3></sect2><sect2 id='sec.The-menu-Print' >

<sect2>

<title>The menu item <guimenuitem>Print</guimenuitem><!-- anchor id="sec.The-menu-Print" --></title>

<title>The File Menu</title>

<para>After clicking on this item, the currently loaded activity will be printed. If possible, everything is printed on one page.</para>

<para>

<note><para>This function is not implemented with &sportwatcher;!</para></note></sect2></sect1><sect1 id='sec.The-menu-Edit' >

<variablelist>

<title>The menu <guimenu>Edit</guimenu><!-- anchor id="sec.The-menu-Edit" --></title>

<varlistentry>

<screenshot>

<term><menuchoice>

<screeninfo>Menu Edit</screeninfo>

<shortcut>

   <mediaobject>

<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>

      <imageobject>

</shortcut>

         <imagedata fileref="menuEdit.png" format="PNG"></imagedata>

<guimenu>File</guimenu>

      </imageobject>

<guimenuitem>New</guimenuitem>

      <textobject>

</menuchoice></term>

         <phrase>Menu Edit</phrase>

<listitem><para><action>Creates a new document</action></para></listitem>

      </textobject>

</varlistentry>

   </mediaobject>

<varlistentry>

</screenshot><sect2 id='sec.The-menu-Rename' >

<term><menuchoice>

<title>The menu item <guimenuitem>Rename</guimenuitem><!-- anchor id="sec.The-menu-Rename" --></title>

<shortcut>

<para>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 <guibutton>Ok</guibutton>. This saves the new name and it shows up in the list of activities on the left side of the main window.</para></sect2></sect1><sect1 id='sec.The-menu-Settings' >

<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>

<title>The menu <guimenu>Settings</guimenu><!-- anchor id="sec.The-menu-Settings" --></title>

</shortcut>

<para>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.</para>

<guimenu>File</guimenu>

<screenshot>

<guimenuitem>Save</guimenuitem>

<screeninfo>Menu Settings</screeninfo>

</menuchoice></term>

   <mediaobject>

<listitem><para><action>Saves the document</action></para></listitem>

      <imageobject>

</varlistentry>

         <imagedata fileref="menuSettings.png" format="PNG"></imagedata>

<varlistentry>

      </imageobject>

<term><menuchoice>

      <textobject>

<shortcut>

         <phrase>Menu Settings</phrase>

<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>

      </textobject>

</shortcut>

   </mediaobject>

<guimenu>File</guimenu>

</screenshot><sect2 id='sec.The-menu-ConfSPW' >

<guimenuitem>Quit</guimenuitem>

<title>The menu item <guimenuitem>Configure SportWatcher</guimenuitem><!-- anchor id="sec.The-menu-ConfSPW" --></title>

</menuchoice></term>

<para>This item opens a dialog box, where you can set sevaral things.</para>

<listitem><para><action>Quits</action> &sportwatcher;</para></listitem>

<screenshot>

</varlistentry>

<screeninfo>Configure SportWatcher</screeninfo>

</variablelist>

   <mediaobject>

</para>

      <imageobject>

         <imagedata fileref="ConfigureSportWatcher.png" format="PNG"></imagedata>

</sect2>

      </imageobject>

      <textobject>

<sect2>

         <phrase>Configure SportWatcher</phrase>

<title>The <guimenu>Help</guimenu> Menu</title>

      </textobject>

   </mediaobject>

<!-- Assuming you have a standard help menu (help, what's this, about -->

</screenshot><sect3 id='sec.Heart-rate-limits' >

<!-- &sportwatcher;, about KDE) then the documentation is already written. -->

<title>Heart rate limits<!-- anchor id="sec.Heart-rate-limits" --></title>

<!-- The following entity is valid anywhere that a variablelist is -->

<para>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.</para>

<!-- valid.  -->

<para>A simpler method is the following formular:</para><screen>

<![CDATA[<Max. HR> = 220 - <age>

&help.menu.documentation;

]]></screen><para>From the maximum heart rate you can calculate the levels (or zones). The following table shows how:</para>

<informaltable><tgroup cols="4" colsep="1" rowsep="1">

</sect2>

<colspec colname="col0" align="left"/>

<colspec colname="col1" align="left"/>

</sect1>

<colspec colname="col2" align="left"/>

</chapter>

<colspec colname="col3" align="left"/>

<tbody>

<chapter id="developers">

<row>

<title>Developer's Guide to &sportwatcher;</title>

<entry align="left" valign="top">Level</entry>

<entry align="left" valign="top">Intensity</entry>

<!-- (OPTIONAL) A Programming/Scripting reference chapter should be

<entry align="left" valign="top">Running</entry>

used for apps that use plugins or that provide their own scripting hooks

<entry align="left" valign="top">Bike</entry>

and/or development libraries. -->

</row>

<row>

<para>

<entry align="left" valign="top">0 (&lt;1)</entry>

Programming &sportwatcher; plugins is a joy to behold. Just read through the next

<entry align="left" valign="top">very low</entry>

66 pages of API's to learn how!

<entry align="left" valign="top">&lt; 65% (Regular run)</entry>

</para>

<entry align="left" valign="top">&lt; 52% (CO --&gt; Compensation)</entry>

</row>

<!-- Use refentries to describe APIs.  Refentries are fairly complicated and you

<row>

should consult the docbook reference for further details. The example below was

<entry align="left" valign="top">1</entry>

taken from that reference and shortened a bit for readability. -->

<entry align="left" valign="top">low</entry>

<entry align="left" valign="top">65% - 80% (Ext run --&gt; extensive run)</entry>

<refentry id="re-1007-unmanagechildren-1">

<entry align="left" valign="top">52% - 65% (SP1 --&gt; Basic staying power 1)</entry>

<refmeta>

</row>

<refentrytitle>XtUnmanageChildren</refentrytitle>

<row>

<refmiscinfo>Xt - Geometry Management</refmiscinfo>

<entry align="left" valign="top">2</entry>

</refmeta>

<entry align="left" valign="top">middle</entry>

<refnamediv>

<entry align="left" valign="top">80% - 85% (Int run --&gt; intensive run)</entry>

<refname>XtUnmanageChildren

<entry align="left" valign="top">65% - 77% (SP2 --&gt; Basic staying power 2)</entry>

</refname>

</row>

<refpurpose>remove a list of children from a parent widget's managed

<row>

list.

<entry align="left" valign="top">3</entry>

<indexterm id="ix-1007-unmanagechildren-1"><primary>widgets</primary><secondary>removing</secondary></indexterm>

<entry align="left" valign="top">high</entry>

<indexterm id="ix-1007-unmanagechildren-2"><primary>XtUnmanageChildren</primary></indexterm> 

<entry align="left" valign="top">85% - 90% (SPR --&gt; speed run)</entry>

</refpurpose>

<entry align="left" valign="top">77% - 90% (PO--&gt; Power)</entry>

</row>

</refnamediv>

<row>

<refsynopsisdiv>

<entry align="left" valign="top">4 (&gt;3)</entry>

<refsynopsisdivinfo>

<entry align="left" valign="top">very high</entry>

<date>4 March 1996</date>

<entry align="left" valign="top">&gt; 90% (R --&gt; Race)</entry>

</refsynopsisdivinfo>

<entry align="left" valign="top">&gt; 90% (HP --&gt; High power)</entry>

<synopsis>

</row>

void XtUnmanageChildren(<replaceable class="parameter">children</replaceable>, <replaceable class="parameter">num_children</replaceable>)

</tbody>

    WidgetList <replaceable class="parameter">children</replaceable>;

</tgroup></informaltable></sect3><sect3 id='sec.Other-limits' >

    Cardinal <replaceable class="parameter">num_children</replaceable>;

<title>Other limits<!-- anchor id="sec.Other-limits" --></title>

</synopsis>

<para>The <guilabel>VO2max</guilabel> 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 <guilabel>weight</guilabel> is the the weight of your body in <emphasis>kilogramm</emphasis>.</para></sect3><sect3 id='sec.Device-and-file' >

<title>Device and file settings<!-- anchor id="sec.Device-and-file" --></title>

<refsect2 id="r2-1007-unmanagechildren-1">

<para>The settings in this block defines the path and files, where SportWatcher stores it data.</para><sect4 id='sec.Even-surface-contour' >

<title>Inputs</title>

<title>Even surface contour line<!-- anchor id="sec.Even-surface-contour" --></title>

<variablelist>

<para>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.</para></sect4><sect4 id='sec.Use-serial-port' >

<varlistentry>

<title>Use serial port instead of USB port<!-- anchor id="sec.Use-serial-port" --></title>

<term><replaceable class="parameter">children</replaceable>

<para>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 <xref linkend="sec.Serial-device" />.</para>

</term>

<note><para>This function is not tested and it's very likely that it will not work!</para></note></sect4><sect4 id='sec.Serial-device' >

<listitem>

<title>Serial device<!-- anchor id="sec.Serial-device" --></title>

<para>Specifies an array of child widgets. Each child must be of

<para>The name of the serial device your GPS receiver is connected to. This is only enabled, if you've checked <guilabel>Use serial port instead of USB port</guilabel> (look at <xref linkend="sec.Use-serial-port" />).</para></sect4><sect4 id='sec.Data-files' >

class RectObj or any subclass thereof.

<title>Data files<!-- anchor id="sec.Data-files" --></title>

</para>

<para>&sportwatcher; save the data files, containing the activities in the directory, you specify here. Standard is <literal role="extension">.sportwatcher</literal> in your home directory. After the first start, and after you've downloaded your first activity, &sportwatcher; creates this directory, in case it does not already exist, and saves the activities there.</para></sect4><sect4 id='sec.HRM-files' >

</listitem>

<title>HRM files<!-- anchor id="sec.HRM-files" --></title>

</varlistentry>

<para>SportWatcher is able to save the heart rate data of an activity into Polars <acronym>HRM</acronym> format. If you do that (look at <xref linkend="sec.The-menu-HR" />), 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.</para>

<varlistentry>

<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></sect4><sect4 id='sec.Map-file' >

<term><replaceable class="parameter">num_children</replaceable>

<title>Map file<!-- anchor id="sec.Map-file" --></title>

</term>

<para>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 <xref linkend="sec.Map-type" />) you've set.</para><sect5>

<listitem>

<title>Raster images</title>

<para>Specifies the number of elements in <replaceable class="parameter">children</replaceable>.

<para>A raster image is a simple picture file. You can view such files with nearly every graphic program (<command>GIMP</command>, <command>Gwenview</command>, etc.). These files have extensions like <literal role="extension">.gif</literal>, <literal role="extension">.png</literal>, <literal role="extension">.tiff</literal> 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 <acronym>TIFF</acronym> 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.</para></sect5><sect5>

</para>

<title>Other sources of maps</title>

</listitem>

<para>To not have the dawback of a raster image, you can use a <acronym>WMS</acronym> 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 <acronym>WMS</acronym> 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.</para>

</varlistentry>

<para>Allthoug you can select <acronym>Shape</acronym> files as a source too, this is currently not supported. In case of a <acronym>Shape</acronym> file you've to enter here only the path where the <acronym>Shape</acronym> 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 <acronym>Shape</acronym> file is a local file, containing a map, or a part of it, in vector coordinates.</para></sect5></sect4><sect4 id='sec.Map-type' >

</variablelist>

<title>Map type<!-- anchor id="sec.Map-type" --></title>

</refsect2></refsynopsisdiv>

<para>This sets the type of map. Basicly you can distinguish between raster images and vector based maps. Most vector based maps (<acronym>WMS</acronym> servers, <acronym>Shape</acronym> files) need the name and location where SportWatcher can create a control file (look at <xref linkend="sec.Map-file" />). For raster images you've to set the path and name of the file containing the raster image.</para>

<para>The setting here is necessary to allow SportWatcher to decide which settings dialog to show (look at <xref linkend="sec.The-menu-ConfMap" />).</para></sect4></sect3><sect3 id='sec.Units' >

<refsect1 id="r1-1007-unmanagechildren-1">

<title>Units<!-- anchor id="sec.Units" --></title>

<title>Description

<para>Here you can set metric units or U.S. statute.</para>

</title>

<para>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.</para></sect3></sect2><sect2 id='sec.The-menu-ConfMap' >

<para><function>XtUnmanageChildren()</function> unmaps the specified widgets

<title>The menu item <guimenuitem>Configure map</guimenuitem><!-- anchor id="sec.The-menu-ConfMap" --></title>

and removes them from their parent's geometry management.

<para>Dependend on the set map type (look at <xref linkend="sec.Map-type" />), 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 <acronym>WMS</acronym> server and one to define the corners of a map in geo coordinates.</para><sect3 id='sec.WMS' >

The widgets will disappear from the screen, and (depending

<title>WMS<!-- anchor id="sec.WMS" --></title>

on its parent) may no longer have screen space allocated for

<screenshot>

them.

<screeninfo>Configure WMS</screeninfo>

</para>

   <mediaobject>

<para>Each of the widgets in the <replaceable class="parameter">children</replaceable> array must have

      <imageobject>

the same parent.

         <imagedata fileref="ConfigureWMS.png" format="PNG"></imagedata>

</para>

      </imageobject>

<para>See the &ldquo;Algorithm&rdquo; section below for full details of the

      <textobject>

widget unmanagement procedure.

         <phrase>Configure WMS</phrase>

</para>

      </textobject>

</refsect1>

   </mediaobject>

</screenshot>

<refsect1 id="r1-1007-unmanagechildren-2">

<para>This dialog contains all necessary controls to set up the <acronym>WMS</acronym> client. You can access a WMS server over the <acronym>HTTP</acronym> protocol. To get a map, you can use a simple <acronym>URL</acronym>. You can use your internet browser to try that out. Type in the following URL:</para><screen>

<title>Usage</title>

<![CDATA[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

<para>Unmanaging widgets is the usual method for temporarily

]]></screen><para>You should get a satelite picture of a part of <emphasis>Klagenfurt</emphasis>, a city in austria, and a piece of the <emphasis>W&ouml;rtersee</emphasis>, a lake. <emphasis>Klagenfurt</emphasis> 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</para><screen>

making them invisible.  They can be re-managed with

<![CDATA[]]><ulink url="http://www.skylab-mobilesystems.com/ger/wms_serverlist.html">http://www.skylab-mobilesystems.com/ger/wms_serverlist.html</ulink>

<function>XtManageChildren()</function>.

<![CDATA[]]></screen><para>for a large list of free WMS servers.</para><sect4 id='sec.Server-URL' >

</para>

<title>Server URL<!-- anchor id="sec.Server-URL" --></title>

<para>You can unmap a widget, but leave it under geometry

<para>Enter the <acronym>URL</acronym> of the WMS server. Related to our example above, this would be:</para><screen>

management by calling <function>XtUnmapWidget()</function>.  You can

<![CDATA[http://onearth.jpl.nasa.gov/wms.cgi

destroy a widget's window without destroying the widget by

]]></screen><para>You can omit the extra parameters, as shown in the above example, because SportWatcher will set them for you.</para></sect4><sect4 id='sec.Layer-name' >

calling <function>XtUnrealizeWidget()</function>.  You can destroy a

<title>Layer name<!-- anchor id="sec.Layer-name" --></title>

widget completely with <function>XtDestroyWidget()</function>.

<para>A WMS server can provide several <emphasis>layers</emphasis> 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?</para></sect4><sect4 id='sec.SRS' >

</para>

<title>SRS<!-- anchor id="sec.SRS" --></title>

<para>If you are only going to unmanage a single widget, it is

<para>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:</para><screen>

more convenient to call <function>XtUnmanageChild()</function>.  It is

<![CDATA[]]><ulink url="http://en.wikipedia.org/wiki/Geoid">http://en.wikipedia.org/wiki/Geoid</ulink>

often more convenient to call <function>XtUnmanageChild()</function>

<![CDATA[]]></screen><para>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 <emphasis>EPSG:4326</emphasis>, also known as <emphasis>WGS84</emphasis>.</para></sect4><sect4 id='sec.CRS' >

several times than it is to declare and initialize an array

<title>CRS<!-- anchor id="sec.CRS" --></title>

of widgets to pass to <function>XtUnmanageChildren()</function>.  Calling

<para>CRS is mostly the same as SRS (look at <xref linkend="sec.SRS" />). But this parameter is optional. In doubt, take <emphasis>WGS84</emphasis>.</para></sect4><sect4>

<function>XtUnmanageChildren()</function> is more efficient, however,

<title>Bands</title>

because it only calls the parent's <function>change_managed()</function>

<para>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!</para>

method once.

<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></sect4><sect4 id='sec.Version' >

</para>

<title>Version<!-- anchor id="sec.Version" --></title>

</refsect1>

<para>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.</para></sect4><sect4 id='sec.Stile' >

<title>Stile<!-- anchor id="sec.Stile" --></title>

<refsect1 id="r1-1007-unmanagechildren-3">

<para>Beside the above mentioned layers (look at <xref linkend="sec.Layer-name" />), 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).</para></sect4><sect4 id='sec.Tile-size' >

<title>Algorithm

<title>Tile size<!-- anchor id="sec.Tile-size" --></title>

</title>

<para>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.</para>

<para><function>XtUnmanageChildren()</function> performs the following:

<para>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.</para></sect4><sect4 id='sec.Depth' >

</para>

<title>Depth<!-- anchor id="sec.Depth" --></title>

<variablelist>

<para>Number of directory layers. 2 will result in files being written as &lt;cache_path&gt;/A/B/ABCDEF... (defaults to 2).</para></sect4><sect4 id='sec.Overview-count' >

<varlistentry>

<title>Overview count<!-- anchor id="sec.Overview-count" --></title>

<term>-

<para>Count of reduced resolution layers each having 2 times lower resolution. In doubt set to 10.</para></sect4><sect4 id='sec.WMS-squarepixel' >

</term>

<title>WMS Server uses square pixels<!-- anchor id="sec.WMS-squarepixel" --></title>

<listitem>

<para>In case you find a WMS server that is not able to calculate the projection correct, you can try to set this option.</para></sect4><sect4 id='sec.Offline-mode' >

<para>Ignores the child if it already is unmanaged or is being

<title>Offline mode<!-- anchor id="sec.Offline-mode" --></title>

destroyed.

<para>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.</para></sect4><sect4 id='sec.Advice-read' >

</para>

<title>Advice read<!-- anchor id="sec.Advice-read" --></title>

</listitem>

<para>Download images into cache. This saves time and brings a map faster to screen.</para></sect4><sect4 id='sec.Verify-advice-read' >

</varlistentry>

<title>Verify advice read<!-- anchor id="sec.Verify-advice-read" --></title>

<varlistentry>

<para>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.</para></sect4><sect4 id='sec.Add-meters-longitude' >

<term>-

<title>Add meters to longitude<!-- anchor id="sec.Add-meters-longitude" --></title>

</term>

<para>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.</para></sect4><sect4 id='sec.Add-meters-latitude' >

<listitem>

<title>Add meters to latitude<!-- anchor id="sec.Add-meters-latitude" --></title>

<para>Otherwise, if the child is realized, it makes it nonvisible

<para>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.</para></sect4></sect3><sect3 id='sec.Image-coordinates' >

by unmapping it.

<title>Image coordinates<!-- anchor id="sec.Image-coordinates" --></title>

</para>

<screenshot>

</listitem>

<screeninfo>SportWatcher coordinates</screeninfo>

</varlistentry>

   <mediaobject>

</variablelist>

      <imageobject>

<para>

         <imagedata fileref="ConfigureCoordinates.png" format="PNG"></imagedata>

</para>

      </imageobject>

</refsect1>

      <textobject>

         <phrase>SportWatcher coordinates</phrase>

<refsect1 id="r1-1007-unmanagechildren-4">

      </textobject>

<title>Structures</title>

   </mediaobject>

<para>The <type>WidgetList</type> type is simply an array of widgets:

</screenshot>

</para>

<para>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 information. 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.</para><sect4 id='sec.Upper-left-corner' >

<screen id="sc-1007-unmanagechildren-1">typedef Widget *WidgetList;

<title>Upper left corner<!-- anchor id="sec.Upper-left-corner" --></title>

</screen>

<para>This defines the upper left corner. Define this values in the format of the set <link linkend="sec.Projection">projection</link>.</para></sect4><sect4 id='sec.Lower-right-corner' >

</refsect1>

<title>Lower right corner<!-- anchor id="sec.Lower-right-corner" --></title>

</refentry>

<para>his defines the lower right corner. Define this values in the format of the set <link linkend="sec.Projection">projection</link>.</para></sect4><sect4 id='sec.Projection' >

<title>Projection<!-- anchor id="sec.Projection" --></title>

</chapter>

<para>This setting defines the <ulink url="http://en.wikipedia.org/wiki/Graphical_projection">graphical projection</ulink> of the map. Graphical projection is a protocol by which an image of an imaginary three-dimensional object is projected onto a planar surface without the aid of mathematical 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.).</para>

<para>SportWatcher allows to set some of the possible projections. Choose the one, used for your map.</para></sect4></sect3></sect2></sect1><sect1 id='sec.The-menu-Help' >

<chapter id="faq">

<title>The menu <guimenu>Help</guimenu><!-- anchor id="sec.The-menu-Help" --></title>

<title>Questions and Answers</title>

&help.menu.documentation;</sect1></chapter><chapter id='cha.Display-a-map' >

<title>Display a map underneath a track<!-- anchor id="cha.Display-a-map" --></title>

<!-- (OPTIONAL but recommended) This chapter should include all of the silly

<para>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 <xref linkend="sec.The-menu-ConfSPW" />) 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.</para>

(and not-so-silly) newbie questions that fill up your mailbox. This chapter

<para>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.</para><sect1 id='sec.WMS-Server' >

should be reserved for BRIEF questions and answers! If one question uses more

<title>WMS Server<!-- anchor id="sec.WMS-Server" --></title>

than a page or so then it should probably be part of the

<para>The <ulink url="http://en.wikipedia.org/wiki/Web_Map_Service">Web Map Service</ulink> (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 <ulink url="http://en.wikipedia.org/wiki/Open_Geospatial_Consortium">Open Geospatial Consortium</ulink> (OGC). It describes the parameters needed for a request. It also defines, how a WMS server should generate a map out of the request.</para>

"Using this Application" chapter instead. You should use links to

<para>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 <xref linkend="sec.WMS" />.</para></sect1><sect1 id='sec.Map-out-of' >

cross-reference questions to the parts of your documentation that answer them.

<title>Map out of a raster image<!-- anchor id="sec.Map-out-of" --></title>

This is also a great place to provide pointers to other FAQ's if your users

<para>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 <xref linkend="sec.Map-file" /> let you define the path to the map and the file name of the map. With <xref linkend="sec.Map-type" /> 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 <xref linkend="sec.Image-coordinates" /> 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.</para></sect1><sect1 id='sec.Shape-files' >

must do some complicated configuration on other programs in order for your

<title>Shape files<!-- anchor id="sec.Shape-files" --></title>

application work. -->

<para>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 <ulink url="http://en.wikipedia.org/wiki/ESRI">ESRI</ulink> 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 <literal role="extension">.shp</literal>, <literal role="extension">.shx</literal>, <literal role="extension">.dbf</literal>, and other extensions on a common prefix name (e.g., "lakes.*"). The actual shapefile relates specifically to files with the <literal role="extension">.shp</literal> extension, however this file alone is incomplete for distribution, as the other supporting files are required.</para>

<note><para>This format is currently not implemented!</para></note></sect1><sect1 id='sec.PostGIS-database' >

&reporting.bugs;

<title>PostGIS database<!-- anchor id="sec.PostGIS-database" --></title>

&updating.documentation;

<para>PostGIS (<emphasis>/post'-jis/</emphasis>) 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:</para><itemizedlist>

<listitem><para>Geometry types for points, linestrings, polygons, multipoints, multilinestrings, multipolygons and geometry collections.</para></listitem><listitem><para>Spatial predicates for determining the interactions of geometries using the 3x3 Egenhofer matrix (provided by GEOS).</para></listitem><listitem><para>Spatial operators for determining geospatial measurements like area, distance, length and perimeter.</para></listitem><listitem><para>Spatial operators for determining geospatial set operations, like union, difference, symmetric difference and buffers (provided by GEOS).</para></listitem><listitem><para>R−tree spatial indexes for high speed spatial querying.</para></listitem><listitem><para>Index selectivity support, to provide high performance query plans for mixed spatial/non-spatial queries.</para></listitem></itemizedlist><para>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.</para>

<qandaset id="faqlist">

<note><para>This function is currently not implemented!</para></note></sect1></chapter><chapter id='cha.Credits' >

<qandaentry>

<title>Credits<!-- anchor id="cha.Credits" --></title>

<question>

<sect1 id='sec.Danksagung-und-Lizenz' >

<para>My Mouse doesn't work. How do I quit &sportwatcher;?</para>

<title>Credits and License<!-- anchor id="sec.Danksagung-und-Lizenz" --></title>

</question>

<para>&sportwatcher;</para>

<answer>

<para>Program <trademark class="copyright">Copyright </trademark> 2007 - 2009 by Andreas Theofilu <email>andreas@theosys.at</email></para>

<para>You silly goose! Check out the <link linkend="commands">Commands

<para>Based on <command>garmin-tools</command> from Dave Bailey <email>dave@daveb.net</email></para>

Section</link> for the answer.</para>

<para>Based on <command>GANT</command> from Paul <email>paul@ant.sbrk.co.uk</email></para>

&underGPL;        	 <!-- GPL License -->

&underGPL;               <!-- GPL License --></sect1></chapter></book>