Subversion Repositories public

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
312 andreas 1
#LyX 1.6.3 created this file. For more info see http://www.lyx.org/
2
\lyxformat 345
3
\begin_document
4
\begin_header
5
\textclass docbook-book
6
\begin_preamble
7
<?xml version="1.0" ?>
8
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
9
  <!ENTITY sportwatcher "<application>SportWatcher 0.6</application>">
10
  <!ENTITY kappname "&sportwatcher;"><!-- Do *not* replace kappname-->
11
  <!ENTITY package "kde-module"><!-- kdebase, kdeadmin, etc -->
12
  <!ENTITY % addindex "IGNORE">
13
  <!ENTITY % English "INCLUDE"><!-- change language only here -->
14
 
15
 ]>
16
 
17
<!-- XML file was created by LyX 1.6.3
18
  See http://www.lyx.org/ for more information -->
19
<book lang="&language;">
20
<bookinfo>
21
<title>The user manual for &sportwatcher;</title>
22
 
23
<authorgroup>
24
<author>
25
<firstname>Andreas</firstname>
26
<othername></othername>
27
<surname>Theofilu</surname>
28
<affiliation>
29
<address><email>andreas@theosys.at</email></address>
30
</affiliation>
31
</author>
32
</authorgroup>
33
 
34
<copyright>
35
<year>2007</year>
36
<year>2008</year>
37
<year>2009</year>
38
<holder>Andreas Theofilu</holder>
39
</copyright>
40
<!-- Translators: put here the copyright notice of the translation -->
41
<!-- Put here the FDL notice.  Read the explanation in fdl-notice.docbook
42
     and in the FDL itself on how to use it. -->
43
<legalnotice>&FDLNotice;</legalnotice>
44
 
45
<date>2009-07-30</date>
46
<releaseinfo>0.6</releaseinfo>
47
 
48
<abstract>
49
<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>
50
</abstract>
51
 
52
<keywordset>
53
<keyword>KDE</keyword>
54
<keyword>SportWatcher</keyword>
55
<keyword>Garmin</keyword>
56
<keyword>GDAL</keyword>
57
</keywordset>
58
 
59
</bookinfo>
60
\end_preamble
61
\use_default_options true
62
\begin_modules
63
logicalmkup
64
minimalistic
65
\end_modules
66
\language english
67
\inputencoding auto
68
\font_roman default
69
\font_sans default
70
\font_typewriter default
71
\font_default_family default
72
\font_sc false
73
\font_osf false
74
\font_sf_scale 100
75
\font_tt_scale 100
76
 
77
\graphics default
78
\paperfontsize default
79
\spacing single
80
\use_hyperref true
81
\pdf_title "Benutzerhandbuch für SportWatcher 0.6"
82
\pdf_author "Andreas Theofilu <andreas@theosys.at>"
83
\pdf_subject "Benutzerhandbuch"
84
\pdf_keywords "SportWatcher KDE Qt"
85
\pdf_bookmarks true
86
\pdf_bookmarksnumbered false
87
\pdf_bookmarksopen false
88
\pdf_bookmarksopenlevel 1
89
\pdf_breaklinks true
90
\pdf_pdfborder false
91
\pdf_colorlinks false
92
\pdf_backref false
93
\pdf_pdfusetitle true
94
\papersize default
95
\use_geometry false
96
\use_amsmath 1
97
\use_esint 1
98
\cite_engine basic
99
\use_bibtopic false
100
\paperorientation portrait
101
\secnumdepth 4
102
\tocdepth 4
103
\paragraph_separation indent
104
\defskip medskip
105
\quotes_language english
106
\papercolumns 1
107
\papersides 1
108
\paperpagestyle default
109
\tracking_changes false
110
\output_changes false
111
\author "" 
112
\author "" 
113
\end_header
114
 
115
\begin_body
116
 
117
\begin_layout Chapter
118
Introduction
119
\begin_inset CommandInset label
120
LatexCommand label
121
name "cha:Introduction"
122
 
123
\end_inset
124
 
125
 
126
\end_layout
127
 
128
\begin_layout Standard
129
In the first place, SportWatcher is a program to get out some GPS data from
130
 a GPS receiver.
131
 I started developing this program when I realized, that there was no support
132
 for my new Garmin Forerunner305 under Linux.
133
 Because I use Linux only, I was not able to use the software who came with
134
 the watch, because it was for Windows only.
135
 So I looked closer to this GPS receiver, made for sport and training.
136
 Like most GPS receivers from Garmin, this one uses also the NMEA protocol
137
 to transfer data.
138
 By accident I found the garmintools, written by "Dave Bailey" (<dave <at>
139
 daveb <dot> net>).
140
 This tools contain a library to read out the data over the USB port.
141
 I used the source by courtesy of Dave as the basic of SportWatcher and
142
 used it to get out everything of my Forerunner 305 and hopefully every
143
 compatible GPS receiver.
144
\end_layout
145
 
146
\begin_layout Section
147
Supported GPS receiver
148
\begin_inset CommandInset label
149
LatexCommand label
150
name "sec:Supported-GPS-receiver"
151
 
152
\end_inset
153
 
154
 
155
\end_layout
156
 
157
\begin_layout Standard
158
Basically every GPS receiver, who uses the NMEA protocol and has an USB
159
 port, should be supported.
160
 However.
161
 Only the following receivers are tested:
162
\end_layout
163
 
164
\begin_layout Itemize
165
Garmin Forerunner305
166
\end_layout
167
 
168
\begin_layout Itemize
169
Garmin Forerunner205
170
\end_layout
171
 
172
\begin_layout Standard
173
If you own another type of GPS receiver and when it works with SportWatcher,
174
 please send an e−mail to 
175
\emph on
176
andreas <at> theosys <dot> at
177
\emph default
178
.
179
\end_layout
180
 
181
\begin_layout Chapter
182
Installation
183
\begin_inset CommandInset label
184
LatexCommand label
185
name "cha.Installation"
186
 
187
\end_inset
188
 
189
 
190
\end_layout
191
 
192
\begin_layout Standard
193
\begin_inset ERT
194
status open
195
 
196
\begin_layout Plain Layout
197
 
198
&sportwatcher;
199
\end_layout
200
 
201
\end_inset
202
 
203
 was written in C++ and is made for the desktop 
204
\begin_inset CommandInset href
205
LatexCommand href
206
name "KDE"
207
target "http://www.kde.org"
208
 
209
\end_inset
210
 
211
.
212
 The program was developed exclusive under Linux.
213
 SportWatcher is open source! This means, that the whole source is available
214
 to you and you are allowed to use it for your own.
215
 The source code, and with it the whole program, is licensed under the 
216
\begin_inset CommandInset href
217
LatexCommand href
218
name "GNU General Public License version 3"
219
target "http://www.gnu.org/licenses/gpl.html"
220
 
221
\end_inset
222
 
223
.
224
\end_layout
225
 
226
\begin_layout Section
227
Download
228
\begin_inset CommandInset label
229
LatexCommand label
230
name "sec.Download"
231
 
232
\end_inset
233
 
234
 
235
\end_layout
236
 
237
\begin_layout Standard
238
SportWatcher is available as a binary package for some Linux distributions.
239
 Of course, ther is also the source code available.
240
 Get the stable source code or the package for your distribution from one
241
 of the following sources:
242
\end_layout
243
 
244
\begin_layout Itemize
245
Sourceforge: 
246
\begin_inset CommandInset href
247
LatexCommand href
248
name "Sourceforge"
249
target "http://sourceforge.net/projects/sportwatcher/"
250
 
251
\end_inset
252
 
253
 
254
\end_layout
255
 
256
\begin_layout Itemize
257
TheoSys: 
258
\begin_inset CommandInset href
259
LatexCommand href
260
name "TheoSys"
261
target "http://www.theosys.at/download"
262
 
263
\end_inset
264
 
265
 
266
\end_layout
267
 
268
\begin_layout Standard
269
If you like to help develop SportWatcher, or simply want to have the latest,
270
 untested code, with all available bells and whistles, then you can get
271
 the code out of one of the subversion archives.
272
 The source code in the subversion archives, is for developers and is not
273
 tested! There is no garanty, that this code will even compile!
274
\end_layout
275
 
276
\begin_layout Standard
277
Type on the command line (shell), one of the following commands, dependig
278
 from what archive you want to download the code:
279
\end_layout
280
 
281
\begin_layout Code
282
# svn checkout https://sportwatcher.svn.sourceforge.net/svnroot/sportwatcher
283
\end_layout
284
 
285
\begin_layout Standard
286
or
287
\end_layout
288
 
289
\begin_layout Code
290
# svn checkout svn://www.theosys.at/sportwatcher/trunk
291
\end_layout
292
 
293
\begin_layout Standard
294
It is possible to access the 
295
\begin_inset CommandInset href
296
LatexCommand href
297
name "Repository"
298
target "http://www.theosys.at/websvn/listing.php?repname=repos+1&path=/sportwatcher/trunk/&rev=0&sc=0"
299
 
300
\end_inset
301
 
302
, containing the latest code, with your WEB browser too.
303
\end_layout
304
 
305
\begin_layout Subsection
306
Necessary components
307
\begin_inset CommandInset label
308
LatexCommand label
309
name "sec.Necessary-components"
310
 
311
\end_inset
312
 
313
 
314
\end_layout
315
 
316
\begin_layout Standard
317
To be able to compile SportWatcher you need the following components:
318
\end_layout
319
 
320
\begin_layout Itemize
321
\begin_inset CommandInset href
322
LatexCommand href
323
name "KDE 4.1.x"
324
target "http://www.kde.org"
325
 
326
\end_inset
327
 
328
 
329
\end_layout
330
 
331
\begin_layout Itemize
332
\begin_inset CommandInset href
333
LatexCommand href
334
name "GDAL 1.5.x"
335
target "http://www.gdal.org"
336
 
337
\end_inset
338
 
339
 (optional)
340
\end_layout
341
 
342
\begin_layout Subsubsection
343
KDE 4.1.x
344
\begin_inset CommandInset label
345
LatexCommand label
346
name "sec.KDE-4.1.x"
347
 
348
\end_inset
349
 
350
 
351
\end_layout
352
 
353
\begin_layout Standard
354
Since version 0.6 SportWatcher needs at least version 4.1.0 of KDE.
355
 It will not compile with older versions of it!
356
\end_layout
357
 
358
\begin_layout Subsubsection
359
GDAL 1.5.x
360
\begin_inset CommandInset label
361
LatexCommand label
362
name "sec.GDAL-1.5.x"
363
 
364
\end_inset
365
 
366
 
367
\end_layout
368
 
369
\begin_layout Standard
370
SportWatcher is able to display a map underneath a track.
371
 This is made with the help of the GDAL library.
372
 But this library is optional.
373
 It is possible, to compile SportWatcher even without GDAL installed.
374
 Though the ability to display maps is missing then.
375
\end_layout
376
 
377
\begin_layout Standard
378
Debian testing (Squeeze) supports currently version 1.5.4 of GDAL.
379
 Up to version 8.04 TLS of Ubuntu (Hardy Heron), only version 1.4.x of GDAL
380
 is supported.
381
 This version of GDAL is not appropriate for SportWatcher.
382
 It is no problem to use the newer version 1.6.0 of GDAL.
383
 SportWatcher will compile and function very well with the newest version.
384
\end_layout
385
 
386
\begin_layout Standard
387
openSUSE 11.0 doesn't support GDAL out of the box.
388
 There are some easy to find places, where you can download GDAL for openSUSE,
389
 but it's not easy to satisfy the dependencies, GDAL needs.
390
 Therefore I've forgone to include GDAL.
391
 This means, that version 0.5 of SportWatcher does not support maps on openSUSE
392
 11.0.
393
\end_layout
394
 
395
\begin_layout Standard
396
Also openSUSE 11.1 does not support GDAL.
397
 I decided to compile the binary version with it.
398
 To make it simple to compile SprortWatcher yourself, you can download GDAL
399
 for openSUSE 11.1 from here:
400
\end_layout
401
 
402
\begin_layout Itemize
403
\begin_inset CommandInset href
404
LatexCommand href
405
name "gdal-1.6.1-0.pm.1.i586.rpm"
406
target "http://www.theosys.at/download/gdal-1.6.1-0.pm.1.i586.rpm"
407
 
408
\end_inset
409
 
410
 
411
\end_layout
412
 
413
\begin_layout Itemize
414
\begin_inset CommandInset href
415
LatexCommand href
416
name "geotiff-1.2.5-0.pm.1.i586.rpm"
417
target "http://www.theosys.at/download/geotiff-1.2.5-0.pm.1.i586.rpm"
418
 
419
\end_inset
420
 
421
 
422
\end_layout
423
 
424
\begin_layout Itemize
425
\begin_inset CommandInset href
426
LatexCommand href
427
name "libgdal1-1.6.1-0.pm.1.i586.rpm"
428
target "http://www.theosys.at/download/libgdal1-1.6.1-0.pm.1.i586.rpm"
429
 
430
\end_inset
431
 
432
 
433
\end_layout
434
 
435
\begin_layout Itemize
436
\begin_inset CommandInset href
437
LatexCommand href
438
name "libgdal-devel-1.6.1-0.pm.1.i586.rpm"
439
target "http://www.theosys.at/download/libgdal-devel-1.6.1-0.pm.1.i586.rpm"
440
 
441
\end_inset
442
 
443
 
444
\end_layout
445
 
446
\begin_layout Itemize
447
\begin_inset CommandInset href
448
LatexCommand href
449
name "libgeos1-3.1.0-0.pm.1.i586.rpm"
450
target "http://www.theosys.at/download/libgeos1-3.1.0-0.pm.1.i586.rpm"
451
 
452
\end_inset
453
 
454
 
455
\end_layout
456
 
457
\begin_layout Itemize
458
\begin_inset CommandInset href
459
LatexCommand href
460
name "libgeos-devel-3.1.0-0.pm.1.i586.rpm"
461
target "http://www.theosys.at/download/libgeos-devel-3.1.0-0.pm.1.i586.rpm"
462
 
463
\end_inset
464
 
465
 
466
\end_layout
467
 
468
\begin_layout Itemize
469
\begin_inset CommandInset href
470
LatexCommand href
471
name "libgeotiff1-1.2.5-0.pm.1.i586.rpm"
472
target "http://www.theosys.at/download/libgeotiff1-1.2.5-0.pm.1.i586.rpm"
473
 
474
\end_inset
475
 
476
 
477
\end_layout
478
 
479
\begin_layout Itemize
480
\begin_inset CommandInset href
481
LatexCommand href
482
name "libgeotiff-devel-1.2.5-0.pm.1.i586.rpm"
483
target "http://www.theosys.at/download/libgeotiff-devel-1.2.5-0.pm.1.i586.rpm"
484
 
485
\end_inset
486
 
487
 
488
\end_layout
489
 
490
\begin_layout Section
491
Compile / Install
492
\begin_inset CommandInset label
493
LatexCommand label
494
name "sec.Compile-Install"
495
 
496
\end_inset
497
 
498
 
499
\end_layout
500
 
501
\begin_layout Subsection
502
Install the binary pakage
503
\begin_inset CommandInset label
504
LatexCommand label
505
name "sec.Install-the-binary"
506
 
507
\end_inset
508
 
509
 
510
\end_layout
511
 
512
\begin_layout Standard
513
After downloading the pakage, open a shell and become root.
514
 Then type in the following command:
515
\end_layout
516
 
517
\begin_layout Code
518
# dpkg -i sportwatcher_
519
\emph on
520
X.X-x
521
\emph default
522
.i386.deb
523
\end_layout
524
 
525
\begin_layout Standard
526
or
527
\end_layout
528
 
529
\begin_layout Code
530
# dpkg -i sportwatcher_
531
\emph on
532
X.X-x
533
\emph default
534
.amd64.deb 
535
\end_layout
536
 
537
\begin_layout Standard
538
or 
539
\end_layout
540
 
541
\begin_layout Code
542
# dpkg -i sportwatcher_
543
\emph on
544
X.X-x
545
\emph default
546
_ubuntu_i386.deb 
547
\end_layout
548
 
549
\begin_layout Standard
550
or 
551
\end_layout
552
 
553
\begin_layout Code
554
# rpm -ivh sportwatcher-
555
\emph on
556
X.X-x
557
\emph default
558
.i586.rpm 
559
\end_layout
560
 
561
\begin_layout Standard
562
Where X.X-x represents the version and may look like 0.6-1, or the like.
563
 After successfull installation you can use the program immediately.
564
\end_layout
565
 
566
\begin_layout Subsection
567
Compile
568
\begin_inset CommandInset label
569
LatexCommand label
570
name "sec.Compile"
571
 
572
\end_inset
573
 
574
 
575
\end_layout
576
 
577
\begin_layout Standard
578
After downloading the source, and after it was uncompressed into a directory,
579
 change to this new directory.
580
 On a command line, type the following commands:
581
\end_layout
582
 
583
\begin_layout Code
584
$ mkdir build 
585
\end_layout
586
 
587
\begin_layout Code
588
$ cmake ..
589
 -DCMAKE_INSTALL_PREFIX=/usr/local
590
\end_layout
591
 
592
\begin_layout Standard
593
This program checks now for all necessary components.
594
 In case something is missing, the script stops and displays an error message.
595
 Common reason for errors are, that something is not installed.
596
 In most cases, this is the developer version of a package.
597
 With Debian, the name of the developer packages ends with 
598
\emph on
599
dev
600
\emph default
601
.
602
 Install the missing packages, if necessary.
603
\end_layout
604
 
605
\begin_layout Standard
606
With the following command, you start the compiler:
607
\end_layout
608
 
609
\begin_layout Code
610
$ make 
611
\end_layout
612
 
613
\begin_layout Standard
614
In case it stops and display an error message, it is mostly because something
615
 is not installed, or there is a wrong version installed.
616
 Check out what version Debian supports, and install it.
617
\end_layout
618
 
619
\begin_layout Subsubsection
620
Installation
621
\begin_inset CommandInset label
622
LatexCommand label
623
name "sec.Installation"
624
 
625
\end_inset
626
 
627
 
628
\end_layout
629
 
630
\begin_layout Standard
631
To install 
632
\begin_inset ERT
633
status open
634
 
635
\begin_layout Plain Layout
636
 
637
&sportwatcher;
638
\end_layout
639
 
640
\end_inset
641
 
642
 for all users on your system, you need root priviledges.
643
 Otherwise you can install the program into your home directory too.
644
 With SportWatcher you got a file called INSTALL.
645
 It contains a detailed description of how to install the program.
646
 If you've troubles installing SportWatcher, read this file first! To install
647
 SportWatcher for all users on your system, become root and type in the
648
 following command:
649
\end_layout
650
 
651
\begin_layout Code
652
# make install
653
\end_layout
654
 
655
\begin_layout Standard
656
After successfull installation of the program, you can start it with the
657
 command sportwatcher directly from the command line, or you can open the
658
 menu "
659
\begin_inset ERT
660
status open
661
 
662
\begin_layout Plain Layout
663
 
664
<guimenu>
665
\end_layout
666
 
667
\end_inset
668
 
669
Utilities
670
\begin_inset ERT
671
status open
672
 
673
\begin_layout Plain Layout
674
 
675
</guimenu>
676
\end_layout
677
 
678
\end_inset
679
 
680
-->
681
\begin_inset ERT
682
status open
683
 
684
\begin_layout Plain Layout
685
 
686
<guimenuitem>
687
\end_layout
688
 
689
\end_inset
690
 
691
Sportwatcher
692
\begin_inset ERT
693
status open
694
 
695
\begin_layout Plain Layout
696
 
697
</guimenuitem>
698
\end_layout
699
 
700
\end_inset
701
 
702
" and start it from there (this is for KDE only!).
703
\end_layout
704
 
705
\begin_layout Section
706
Settings for Linux
707
\begin_inset CommandInset label
708
LatexCommand label
709
name "sec.Settings-for-Linux"
710
 
711
\end_inset
712
 
713
 
714
\end_layout
715
 
716
\begin_layout Standard
717
SportWatcher tries to find out the USB port, where you've connected your
718
 GPS device itself and then it accesses this port directly.
719
 Unfortunately this is often forbidden for normal users.
720
 To grant access to the USB port for SportWatcher, you've to tell the UDEV
721
 system, that it should set the access rights of the USB port in a way,
722
 that a normal user is allowed to read and write.
723
 While it's possible to run SportWatcher with root priviledges, what is
724
 not recomended, you can add some lines to a configuration file of UDEV.
725
\end_layout
726
 
727
\begin_layout Standard
728
\begin_inset ERT
729
status open
730
 
731
\begin_layout Plain Layout
732
 
733
&sportwatcher;
734
\end_layout
735
 
736
\end_inset
737
 
738
greift direkt auf das USB-Port zu, an dem Sie Ihren 
739
\begin_inset ERT
740
status open
741
 
742
\begin_layout Plain Layout
743
 
744
<hardware>
745
\end_layout
746
 
747
\end_inset
748
 
749
Forerunner 305
750
\begin_inset ERT
751
status open
752
 
753
\begin_layout Plain Layout
754
 
755
</hardware>
756
\end_layout
757
 
758
\end_inset
759
 
760
 angeschlossen haben.
761
 Allerdings fehlen einem normalen Anwender daf
762
\begin_inset ERT
763
status open
764
 
765
\begin_layout Plain Layout
766
 
767
&uuml;
768
\end_layout
769
 
770
\end_inset
771
 
772
r in der Regel die Berechtigungen, so das beim Versuch die Daten aus der
773
 Uhr auszulesen, eine Fehlermeldung erscheint.
774
 Startet man das Programm jedoch als Benutzer root, funktioniert das Auslesen
775
 von Daten einwandfrei.
776
 Diesem Problem kann man nun auf zwei Arten begegnen.
777
 Man kann 
778
\noun on
779
SportWatcher
780
\noun default
781
 immer als 
782
\emph on
783
root
784
\emph default
785
 ausf
786
\begin_inset ERT
787
status open
788
 
789
\begin_layout Plain Layout
790
 
791
&uuml;
792
\end_layout
793
 
794
\end_inset
795
 
796
hren, wovon ich jedoch dringend abrate, oder man manipuliert einmal die
797
 Einstellungen von 
798
\emph on
799
udev
800
\emph default
801
 und vergibt die notwendigen Berechtigungen.
802
 Im Folgenden wird Schritt f
803
\begin_inset ERT
804
status open
805
 
806
\begin_layout Plain Layout
807
 
808
&uuml;
809
\end_layout
810
 
811
\end_inset
812
 
813
r Schritt erkl
814
\begin_inset ERT
815
status open
816
 
817
\begin_layout Plain Layout
818
 
819
&auml;
820
\end_layout
821
 
822
\end_inset
823
 
824
rt, wie man die ben
825
\begin_inset ERT
826
status open
827
 
828
\begin_layout Plain Layout
829
 
830
&ouml;
831
\end_layout
832
 
833
\end_inset
834
 
835
tigten Berechtigungen einstellt.
836
 
837
\end_layout
838
 
839
\begin_layout Subsection
840
For Debian and (K)Ubuntu
841
\begin_inset CommandInset label
842
LatexCommand label
843
name "sec.For-Debian-and"
844
 
845
\end_inset
846
 
847
 
848
\end_layout
849
 
850
\begin_layout Standard
851
Open a shell and become root.
852
 Then type in the following commands:
853
\end_layout
854
 
855
\begin_layout Code
856
# cd /etc/udev/rules.d
857
\end_layout
858
 
859
\begin_layout Code
860
# vi z60-garmin.rules
861
\end_layout
862
 
863
\begin_layout Standard
864
Instead of 
865
\begin_inset ERT
866
status open
867
 
868
\begin_layout Plain Layout
869
 
870
<command>
871
\end_layout
872
 
873
\end_inset
874
 
875
vi
876
\begin_inset ERT
877
status open
878
 
879
\begin_layout Plain Layout
880
 
881
</command>
882
\end_layout
883
 
884
\end_inset
885
 
886
 you can use any other text editor, of course.
887
 Enter the following lines into the new created file:
888
\end_layout
889
 
890
\begin_layout Code
891
SYSFS{idVendor}=="091e", SYSFS{idProduct}=="0003", MODE="0666"
892
\end_layout
893
 
894
\begin_layout Code
895
ATTRS{idVendor}=="091e", ATTRS{idProduct}=="0003", MODE="0666"
896
\end_layout
897
 
898
\begin_layout Standard
899
Save the file and restart UDEV by typing the following command on the command
900
 line:
901
\end_layout
902
 
903
\begin_layout Code
904
# /etc/init.d/udev restart
905
\end_layout
906
 
907
\begin_layout Standard
908
From now on, the access to the USB port - only for your Garmin Forerunner,
909
 regardless on which of the connectors you conected it - should be granted.
910
\end_layout
911
 
912
\begin_layout Subsection
913
Other distributions
914
\begin_inset CommandInset label
915
LatexCommand label
916
name "sec.Other-distributions"
917
 
918
\end_inset
919
 
920
 
921
\end_layout
922
 
923
\begin_layout Standard
924
As long as your Linux distribution uses UDEV, the description above should
925
 work.
926
 In case your distribution uses something else, ask your system administrator,
927
 or read the documentation of your system.
928
 Especialy the chapter about setting rights on USB ports.
929
\end_layout
930
 
931
\begin_layout Subsection
932
It still doesn't work
933
\begin_inset CommandInset label
934
LatexCommand label
935
name "sec.It-still-doesn"
936
 
937
\end_inset
938
 
939
 
940
\end_layout
941
 
942
\begin_layout Standard
943
In case of troubles, if the above instruction doesn't work, you should check
944
 the vendor and product number of your GPS device.
945
 If they differ from the ones above, type in the correct ones.
946
 You can find out this numbers with the command:
947
\end_layout
948
 
949
\begin_layout Code
950
$ lsusb
951
\end_layout
952
 
953
\begin_layout Chapter
954
Working with 
955
\begin_inset ERT
956
status open
957
 
958
\begin_layout Plain Layout
959
 
960
&sportwatcher;
961
\end_layout
962
 
963
\end_inset
964
 
965
 
966
\begin_inset CommandInset label
967
LatexCommand label
968
name "cha.Working-with"
969
 
970
\end_inset
971
 
972
 
973
\end_layout
974
 
975
\begin_layout Section
976
The menu 
977
\begin_inset ERT
978
status open
979
 
980
\begin_layout Plain Layout
981
 
982
<guimenu>
983
\end_layout
984
 
985
\end_inset
986
 
987
File
988
\begin_inset ERT
989
status open
990
 
991
\begin_layout Plain Layout
992
 
993
</guimenu>
994
\end_layout
995
 
996
\end_inset
997
 
998
 
999
\begin_inset CommandInset label
1000
LatexCommand label
1001
name "sec.The-menu-File"
1002
 
1003
\end_inset
1004
 
1005
 
1006
\end_layout
1007
 
1008
\begin_layout Subsection
1009
Read in aktivities
1010
\begin_inset CommandInset label
1011
LatexCommand label
1012
name "sec.Read-in-aktivities"
1013
 
1014
\end_inset
1015
 
1016
 
1017
\end_layout
1018
 
1019
\begin_layout Standard
1020
To visualize anything, SportWatcher must read some informations from a GPS
1021
 receiver.
1022
 To do this, SportWatcher offers a menu point:
1023
\end_layout
1024
 
1025
\begin_layout Standard
1026
\align center
1027
\begin_inset ERT
1028
status open
1029
 
1030
\begin_layout Plain Layout
1031
 
1032
<screenshot>
1033
\end_layout
1034
 
1035
\begin_layout Plain Layout
1036
 
1037
<screeninfo>The menu "File"</screeninfo>
1038
\end_layout
1039
 
1040
\begin_layout Plain Layout
1041
 
1042
   <mediaobject>
1043
\end_layout
1044
 
1045
\begin_layout Plain Layout
1046
 
1047
      <imageobject>
1048
\end_layout
1049
 
1050
\begin_layout Plain Layout
1051
 
1052
         <imagedata fileref="menuFile.png" format="PNG"></imagedata>
1053
\end_layout
1054
 
1055
\begin_layout Plain Layout
1056
 
1057
      </imageobject>
1058
\end_layout
1059
 
1060
\begin_layout Plain Layout
1061
 
1062
      <textobject>
1063
\end_layout
1064
 
1065
\begin_layout Plain Layout
1066
 
1067
         <phrase>Menu File</phrase>
1068
\end_layout
1069
 
1070
\begin_layout Plain Layout
1071
 
1072
      </textobject>
1073
\end_layout
1074
 
1075
\begin_layout Plain Layout
1076
 
1077
   </mediaobject>
1078
\end_layout
1079
 
1080
\begin_layout Plain Layout
1081
 
1082
</screenshot>
1083
\end_layout
1084
 
1085
\end_inset
1086
 
1087
 
1088
\end_layout
1089
 
1090
\begin_layout Subsubsection
1091
Der Menu item 
1092
\begin_inset ERT
1093
status open
1094
 
1095
\begin_layout Plain Layout
1096
 
1097
<guimenuitem>
1098
\end_layout
1099
 
1100
\end_inset
1101
 
1102
Read data
1103
\begin_inset ERT
1104
status open
1105
 
1106
\begin_layout Plain Layout
1107
 
1108
</guimenuitem>
1109
\end_layout
1110
 
1111
\end_inset
1112
 
1113
 
1114
\begin_inset CommandInset label
1115
LatexCommand label
1116
name "sec.Der-Menu-Read"
1117
 
1118
\end_inset
1119
 
1120
 
1121
\end_layout
1122
 
1123
\begin_layout Standard
1124
With the menu item 
1125
\begin_inset ERT
1126
status open
1127
 
1128
\begin_layout Plain Layout
1129
 
1130
<guimenuitem>
1131
\end_layout
1132
 
1133
\end_inset
1134
 
1135
Read data
1136
\begin_inset ERT
1137
status open
1138
 
1139
\begin_layout Plain Layout
1140
 
1141
</guimenuitem>
1142
\end_layout
1143
 
1144
\end_inset
1145
 
1146
, it reads out all aktivities currently stored on the watch.
1147
 After clicking on this menu point, a window appears, showing the progress
1148
 of the read process.
1149
\end_layout
1150
 
1151
\begin_layout Standard
1152
\align center
1153
\begin_inset ERT
1154
status open
1155
 
1156
\begin_layout Plain Layout
1157
 
1158
<screenshot>
1159
\end_layout
1160
 
1161
\begin_layout Plain Layout
1162
 
1163
<screeninfo>Progress dialog</screeninfo>
1164
\end_layout
1165
 
1166
\begin_layout Plain Layout
1167
 
1168
   <mediaobject>
1169
\end_layout
1170
 
1171
\begin_layout Plain Layout
1172
 
1173
      <imageobject>
1174
\end_layout
1175
 
1176
\begin_layout Plain Layout
1177
 
1178
         <imagedata fileref="Progress.png" format="PNG"></imagedata>
1179
\end_layout
1180
 
1181
\begin_layout Plain Layout
1182
 
1183
      </imageobject>
1184
\end_layout
1185
 
1186
\begin_layout Plain Layout
1187
 
1188
      <textobject>
1189
\end_layout
1190
 
1191
\begin_layout Plain Layout
1192
 
1193
         <phrase>Progress dialog</phrase>
1194
\end_layout
1195
 
1196
\begin_layout Plain Layout
1197
 
1198
      </textobject>
1199
\end_layout
1200
 
1201
\begin_layout Plain Layout
1202
 
1203
   </mediaobject>
1204
\end_layout
1205
 
1206
\begin_layout Plain Layout
1207
 
1208
</screenshot>
1209
\end_layout
1210
 
1211
\end_inset
1212
 
1213
 
1214
\end_layout
1215
 
1216
\begin_layout Standard
1217
Depending on the set of data in the watch, this may take up to several minutes.
1218
 As soon as everything was read successful, the progress dialog disappears,
1219
 and one or more new entries appear at the left of the program window.
1220
 Everything is saved in files on your disk at this time.
1221
 SportWatcher allways reads the complete memory of the watch, but it saves
1222
 only new aktivities.
1223
 Existent activities are never overwritten.
1224
\end_layout
1225
 
1226
\begin_layout Standard
1227
At least the Garmin Forerunner305 reorganizes the aktivities, if memory
1228
 is nearly full.
1229
 It deletes messure points and leaves only the laps.
1230
 If SportWatcher would overwrite already saved activities, the meassure
1231
 point would be lost.
1232
\end_layout
1233
 
1234
\begin_layout Standard
1235
In case you've trouble getting the activities out of the watch, read the
1236
 section 
1237
\begin_inset CommandInset ref
1238
LatexCommand ref
1239
reference "sec.Settings-for-Linux"
1240
 
1241
\end_inset
1242
 
1243
.
1244
\end_layout
1245
 
1246
\begin_layout Subsubsection
1247
The menu item 
1248
\begin_inset ERT
1249
status open
1250
 
1251
\begin_layout Plain Layout
1252
 
1253
<guimenu>
1254
\end_layout
1255
 
1256
\end_inset
1257
 
1258
Open
1259
\begin_inset ERT
1260
status open
1261
 
1262
\begin_layout Plain Layout
1263
 
1264
</guimenu>
1265
\end_layout
1266
 
1267
\end_inset
1268
 
1269
 
1270
\begin_inset CommandInset label
1271
LatexCommand label
1272
name "sec.The-menu-Open"
1273
 
1274
\end_inset
1275
 
1276
 
1277
\end_layout
1278
 
1279
\begin_layout Standard
1280
After clicking on this item, a dialog window appears.
1281
 There is a filter installed, showing only files with the extension 
1282
\begin_inset ERT
1283
status open
1284
 
1285
\begin_layout Plain Layout
1286
 
1287
<literal role="extension">
1288
\end_layout
1289
 
1290
\end_inset
1291
 
1292
.gmn
1293
\begin_inset ERT
1294
status open
1295
 
1296
\begin_layout Plain Layout
1297
 
1298
</literal>
1299
\end_layout
1300
 
1301
\end_inset
1302
 
1303
.
1304
 This files are in the format, 
1305
\begin_inset ERT
1306
status open
1307
 
1308
\begin_layout Plain Layout
1309
 
1310
&sportwatcher;
1311
\end_layout
1312
 
1313
\end_inset
1314
 
1315
 uses internal.
1316
 In case you've files in this format, you can read them in here.
1317
 If you selected a valid file, 
1318
\begin_inset ERT
1319
status open
1320
 
1321
\begin_layout Plain Layout
1322
 
1323
&sportwatcher;
1324
\end_layout
1325
 
1326
\end_inset
1327
 
1328
 reads the file and saves it in it own directory structure.
1329
 Then the activity appear in the list of activities on the left side of
1330
 the main window.
1331
\end_layout
1332
 
1333
\begin_layout Subsubsection
1334
The Menu item 
1335
\begin_inset ERT
1336
status open
1337
 
1338
\begin_layout Plain Layout
1339
 
1340
<guimenuitem>
1341
\end_layout
1342
 
1343
\end_inset
1344
 
1345
Import
1346
\begin_inset ERT
1347
status open
1348
 
1349
\begin_layout Plain Layout
1350
 
1351
</guimenuitem>
1352
\end_layout
1353
 
1354
\end_inset
1355
 
1356
 
1357
\begin_inset CommandInset label
1358
LatexCommand label
1359
name "sec.The-Menu-Import"
1360
 
1361
\end_inset
1362
 
1363
 
1364
\end_layout
1365
 
1366
\begin_layout Standard
1367
\begin_inset ERT
1368
status open
1369
 
1370
\begin_layout Plain Layout
1371
 
1372
&sportwatcher;
1373
\end_layout
1374
 
1375
\end_inset
1376
 
1377
 is able to read files created from Garmin 
1378
\begin_inset ERT
1379
status open
1380
 
1381
\begin_layout Plain Layout
1382
 
1383
<command>
1384
\end_layout
1385
 
1386
\end_inset
1387
 
1388
Trainingcenter
1389
\begin_inset ERT
1390
status open
1391
 
1392
\begin_layout Plain Layout
1393
 
1394
</command>
1395
\end_layout
1396
 
1397
\end_inset
1398
 
1399
.
1400
 This files have usually the file extension 
1401
\begin_inset ERT
1402
status open
1403
 
1404
\begin_layout Plain Layout
1405
 
1406
<literal role="extension">
1407
\end_layout
1408
 
1409
\end_inset
1410
 
1411
.tcx
1412
\begin_inset ERT
1413
status open
1414
 
1415
\begin_layout Plain Layout
1416
 
1417
</literal>
1418
\end_layout
1419
 
1420
\end_inset
1421
 
1422
 and are simple XML files.
1423
 There is also other software who can output activities in this format.
1424
\end_layout
1425
 
1426
\begin_layout Standard
1427
After clicking on this item, a file dialog box appears.
1428
 The filter is set to files with the extension 
1429
\begin_inset ERT
1430
status open
1431
 
1432
\begin_layout Plain Layout
1433
 
1434
<literal role="extension">
1435
\end_layout
1436
 
1437
\end_inset
1438
 
1439
.tcx
1440
\begin_inset ERT
1441
status open
1442
 
1443
\begin_layout Plain Layout
1444
 
1445
</literal>
1446
\end_layout
1447
 
1448
\end_inset
1449
 
1450
.
1451
 Select the wanted file and click on button 
1452
\begin_inset ERT
1453
status open
1454
 
1455
\begin_layout Plain Layout
1456
 
1457
<guibutton>
1458
\end_layout
1459
 
1460
\end_inset
1461
 
1462
Open
1463
\begin_inset ERT
1464
status open
1465
 
1466
\begin_layout Plain Layout
1467
 
1468
</guibutton>
1469
\end_layout
1470
 
1471
\end_inset
1472
 
1473
.
1474
 
1475
\begin_inset ERT
1476
status open
1477
 
1478
\begin_layout Plain Layout
1479
 
1480
&sportwatcher;
1481
\end_layout
1482
 
1483
\end_inset
1484
 
1485
 reads the file, evaluates it and parses it.
1486
 If it's valid, it will be stored as a new activity.
1487
\end_layout
1488
 
1489
\begin_layout Subsection
1490
Export activities
1491
\begin_inset CommandInset label
1492
LatexCommand label
1493
name "sec.Export-activities"
1494
 
1495
\end_inset
1496
 
1497
 
1498
\end_layout
1499
 
1500
\begin_layout Standard
1501
\begin_inset ERT
1502
status open
1503
 
1504
\begin_layout Plain Layout
1505
 
1506
&sportwatcher;
1507
\end_layout
1508
 
1509
\end_inset
1510
 
1511
 can save the activities in several formats.
1512
 Not every format can contain all informations of an activity.
1513
 Most of them can hold only the GPS informations.
1514
 The export features of SportWatcher allows other programs to visualize
1515
 a track, for example, in special ways.
1516
 
1517
\begin_inset ERT
1518
status open
1519
 
1520
\begin_layout Plain Layout
1521
 
1522
&sportwatcher;
1523
\end_layout
1524
 
1525
\end_inset
1526
 
1527
 currently supports the following formats:
1528
\end_layout
1529
 
1530
\begin_layout Itemize
1531
TCX - Garmin Trainig Center
1532
\end_layout
1533
 
1534
\begin_layout Itemize
1535
GPX - GPS Exchange Format
1536
\end_layout
1537
 
1538
\begin_layout Itemize
1539
OSM - Open Street Map Format
1540
\end_layout
1541
 
1542
\begin_layout Itemize
1543
HRM - Polar Heart Rate Monitor Format
1544
\end_layout
1545
 
1546
\begin_layout Subsubsection
1547
The menu item 
1548
\begin_inset ERT
1549
status open
1550
 
1551
\begin_layout Plain Layout
1552
 
1553
<guimenuitem>
1554
\end_layout
1555
 
1556
\end_inset
1557
 
1558
Save heart rate
1559
\begin_inset ERT
1560
status open
1561
 
1562
\begin_layout Plain Layout
1563
 
1564
</guimenuitem>
1565
\end_layout
1566
 
1567
\end_inset
1568
 
1569
 
1570
\begin_inset CommandInset label
1571
LatexCommand label
1572
name "sec.The-menu-HR"
1573
 
1574
\end_inset
1575
 
1576
 
1577
\end_layout
1578
 
1579
\begin_layout Standard
1580
The software comming with the sport watches of Polar support the proprietary
1581
 format 
1582
\begin_inset ERT
1583
status open
1584
 
1585
\begin_layout Plain Layout
1586
 
1587
<acronym>
1588
\end_layout
1589
 
1590
\end_inset
1591
 
1592
HRM
1593
\begin_inset ERT
1594
status open
1595
 
1596
\begin_layout Plain Layout
1597
 
1598
</acronym>
1599
\end_layout
1600
 
1601
\end_inset
1602
 
1603
 (Heart Rate Monitor).
1604
 
1605
\begin_inset ERT
1606
status open
1607
 
1608
\begin_layout Plain Layout
1609
 
1610
&sportwatcher;
1611
\end_layout
1612
 
1613
\end_inset
1614
 
1615
 can export an activity in this format.
1616
 Unfortunately this format can hold only the heart rate information, the
1617
 laps, and the total time of the activity.
1618
\end_layout
1619
 
1620
\begin_layout Standard
1621
After clicking the item 
1622
\begin_inset ERT
1623
status open
1624
 
1625
\begin_layout Plain Layout
1626
 
1627
<guimenuitem>
1628
\end_layout
1629
 
1630
\end_inset
1631
 
1632
Save heart rate
1633
\begin_inset ERT
1634
status open
1635
 
1636
\begin_layout Plain Layout
1637
 
1638
</guimenuitem>
1639
\end_layout
1640
 
1641
\end_inset
1642
 
1643
 a file dialog box appears.
1644
 Choose the directory where you wand to save the file and type in the wanted
1645
 file name.
1646
 There is allready a filename ther in the notation Polar uses.
1647
 If you like, you can change it.
1648
 Click on the button 
1649
\begin_inset ERT
1650
status open
1651
 
1652
\begin_layout Plain Layout
1653
 
1654
<guibutton>
1655
\end_layout
1656
 
1657
\end_inset
1658
 
1659
Save
1660
\begin_inset ERT
1661
status open
1662
 
1663
\begin_layout Plain Layout
1664
 
1665
</guibutton>
1666
\end_layout
1667
 
1668
\end_inset
1669
 
1670
 to save the file.
1671
\end_layout
1672
 
1673
\begin_layout Standard
1674
\begin_inset ERT
1675
status open
1676
 
1677
\begin_layout Plain Layout
1678
 
1679
<note><para>Allthough &sportwatcher; can save to the <acronym>HRM</acronym>
1680
 format, it can't import it.</para></note>
1681
\end_layout
1682
 
1683
\end_inset
1684
 
1685
 
1686
\end_layout
1687
 
1688
\begin_layout Subsubsection
1689
The menu 
1690
\begin_inset ERT
1691
status open
1692
 
1693
\begin_layout Plain Layout
1694
 
1695
<guimenuitem>
1696
\end_layout
1697
 
1698
\end_inset
1699
 
1700
Save as
1701
\begin_inset ERT
1702
status open
1703
 
1704
\begin_layout Plain Layout
1705
 
1706
</guimenuitem>
1707
\end_layout
1708
 
1709
\end_inset
1710
 
1711
 
1712
\begin_inset CommandInset label
1713
LatexCommand label
1714
name "sec.The-menu-Save"
1715
 
1716
\end_inset
1717
 
1718
 
1719
\end_layout
1720
 
1721
\begin_layout Standard
1722
After clicking to this item, a file dialog box appears.
1723
 It allows to save the activity in one of the formats 
1724
\begin_inset ERT
1725
status open
1726
 
1727
\begin_layout Plain Layout
1728
 
1729
<acronym>
1730
\end_layout
1731
 
1732
\end_inset
1733
 
1734
TCX
1735
\begin_inset ERT
1736
status open
1737
 
1738
\begin_layout Plain Layout
1739
 
1740
</acronym>
1741
\end_layout
1742
 
1743
\end_inset
1744
 
1745
, 
1746
\begin_inset ERT
1747
status open
1748
 
1749
\begin_layout Plain Layout
1750
 
1751
<acronym>
1752
\end_layout
1753
 
1754
\end_inset
1755
 
1756
GPX
1757
\begin_inset ERT
1758
status open
1759
 
1760
\begin_layout Plain Layout
1761
 
1762
</acronym>
1763
\end_layout
1764
 
1765
\end_inset
1766
 
1767
 and 
1768
\begin_inset ERT
1769
status open
1770
 
1771
\begin_layout Plain Layout
1772
 
1773
<acronym>
1774
\end_layout
1775
 
1776
\end_inset
1777
 
1778
OSM
1779
\begin_inset ERT
1780
status open
1781
 
1782
\begin_layout Plain Layout
1783
 
1784
</acronym>
1785
\end_layout
1786
 
1787
\end_inset
1788
 
1789
.
1790
\end_layout
1791
 
1792
\begin_layout Standard
1793
\begin_inset ERT
1794
status open
1795
 
1796
\begin_layout Plain Layout
1797
 
1798
<screenshot>
1799
\end_layout
1800
 
1801
\begin_layout Plain Layout
1802
 
1803
<screeninfo>Save as</screeninfo>
1804
\end_layout
1805
 
1806
\begin_layout Plain Layout
1807
 
1808
   <mediaobject>
1809
\end_layout
1810
 
1811
\begin_layout Plain Layout
1812
 
1813
      <imageobject>
1814
\end_layout
1815
 
1816
\begin_layout Plain Layout
1817
 
1818
         <imagedata fileref="SaveAs.png" format="PNG"></imagedata>
1819
\end_layout
1820
 
1821
\begin_layout Plain Layout
1822
 
1823
      </imageobject>
1824
\end_layout
1825
 
1826
\begin_layout Plain Layout
1827
 
1828
      <textobject>
1829
\end_layout
1830
 
1831
\begin_layout Plain Layout
1832
 
1833
         <phrase>Save as</phrase>
1834
\end_layout
1835
 
1836
\begin_layout Plain Layout
1837
 
1838
      </textobject>
1839
\end_layout
1840
 
1841
\begin_layout Plain Layout
1842
 
1843
   </mediaobject>
1844
\end_layout
1845
 
1846
\begin_layout Plain Layout
1847
 
1848
</screenshot>
1849
\end_layout
1850
 
1851
\end_inset
1852
 
1853
 
1854
\end_layout
1855
 
1856
\begin_layout Standard
1857
Select the wanted directory and type in the file name.
1858
 Select the wanted format at the filter line and click on the button 
1859
\begin_inset ERT
1860
status open
1861
 
1862
\begin_layout Plain Layout
1863
 
1864
<guibutton>
1865
\end_layout
1866
 
1867
\end_inset
1868
 
1869
Save
1870
\begin_inset ERT
1871
status open
1872
 
1873
\begin_layout Plain Layout
1874
 
1875
</guibutton>
1876
\end_layout
1877
 
1878
\end_inset
1879
 
1880
.
1881
 If the file allready exists, SportWatcher ask you to overwrite the file.
1882
 Decide what you want to do and click the appropriate button.
1883
\end_layout
1884
 
1885
\begin_layout Paragraph
1886
The format TCX
1887
\end_layout
1888
 
1889
\begin_layout Standard
1890
This is the format Garmins 
1891
\begin_inset ERT
1892
status open
1893
 
1894
\begin_layout Plain Layout
1895
 
1896
<command>
1897
\end_layout
1898
 
1899
\end_inset
1900
 
1901
Trainingcenter
1902
\begin_inset ERT
1903
status open
1904
 
1905
\begin_layout Plain Layout
1906
 
1907
</command>
1908
\end_layout
1909
 
1910
\end_inset
1911
 
1912
 uses.
1913
 It contains the complete information of an activity and can be used by
1914
 several programs.
1915
 It is also used by the TheoSys sport logger you'll find at
1916
\end_layout
1917
 
1918
\begin_layout Code
1919
\begin_inset CommandInset href
1920
LatexCommand href
1921
target "https://www.theosys.at/splog/index.php?lang=eng"
1922
 
1923
\end_inset
1924
 
1925
 
1926
\end_layout
1927
 
1928
\begin_layout Standard
1929
This WEB application completes the records of your activities.
1930
 Try it out.
1931
 It's free!
1932
\end_layout
1933
 
1934
\begin_layout Paragraph
1935
The format GPX
1936
\end_layout
1937
 
1938
\begin_layout Standard
1939
This format is for transporting routes, based on GPS coordinates.
1940
 It holds the GPS coordinates of every meassure point.
1941
 Together this is a route representing the track.
1942
\end_layout
1943
 
1944
\begin_layout Paragraph
1945
The format OSM
1946
\end_layout
1947
 
1948
\begin_layout Standard
1949
This format describes a complete map.
1950
 It is used by the 
1951
\begin_inset CommandInset href
1952
LatexCommand href
1953
name "Open Street Map"
1954
target "http://www.openstreetmap.org"
1955
 
1956
\end_inset
1957
 
1958
 project to hold maps.
1959
 Because the maps are free, they are available for everybody and everybody
1960
 can add parts to the map.
1961
 If the way you was running or byking, is currently not part of Open Street
1962
 Map and you want it be part of the map, you can use this format to add
1963
 the way to the map.
1964
 There is more information on there WEB site.
1965
\end_layout
1966
 
1967
\begin_layout Subsection
1968
The menu item 
1969
\begin_inset ERT
1970
status open
1971
 
1972
\begin_layout Plain Layout
1973
 
1974
<guimenuitem>
1975
\end_layout
1976
 
1977
\end_inset
1978
 
1979
Print
1980
\begin_inset ERT
1981
status open
1982
 
1983
\begin_layout Plain Layout
1984
 
1985
</guimenuitem>
1986
\end_layout
1987
 
1988
\end_inset
1989
 
1990
 
1991
\begin_inset CommandInset label
1992
LatexCommand label
1993
name "sec.The-menu-Print"
1994
 
1995
\end_inset
1996
 
1997
 
1998
\end_layout
1999
 
2000
\begin_layout Standard
2001
After clicking on this item, the currently loaded activity will be printed.
2002
 If possible, everything is printed on one page.
2003
\end_layout
2004
 
2005
\begin_layout Standard
2006
\begin_inset ERT
2007
status open
2008
 
2009
\begin_layout Plain Layout
2010
 
2011
<note><para>This function is not implemented with &sportwatcher;!</para></note>
2012
\end_layout
2013
 
2014
\end_inset
2015
 
2016
 
2017
\end_layout
2018
 
2019
\begin_layout Section
2020
The menu 
2021
\begin_inset ERT
2022
status open
2023
 
2024
\begin_layout Plain Layout
2025
 
2026
<guimenu>
2027
\end_layout
2028
 
2029
\end_inset
2030
 
2031
Edit
2032
\begin_inset ERT
2033
status open
2034
 
2035
\begin_layout Plain Layout
2036
 
2037
</guimenu>
2038
\end_layout
2039
 
2040
\end_inset
2041
 
2042
 
2043
\begin_inset CommandInset label
2044
LatexCommand label
2045
name "sec.The-menu-Edit"
2046
 
2047
\end_inset
2048
 
2049
 
2050
\end_layout
2051
 
2052
\begin_layout Standard
2053
\begin_inset ERT
2054
status open
2055
 
2056
\begin_layout Plain Layout
2057
 
2058
<screenshot>
2059
\end_layout
2060
 
2061
\begin_layout Plain Layout
2062
 
2063
<screeninfo>Menu Edit</screeninfo>
2064
\end_layout
2065
 
2066
\begin_layout Plain Layout
2067
 
2068
   <mediaobject>
2069
\end_layout
2070
 
2071
\begin_layout Plain Layout
2072
 
2073
      <imageobject>
2074
\end_layout
2075
 
2076
\begin_layout Plain Layout
2077
 
2078
         <imagedata fileref="menuEdit.png" format="PNG"></imagedata>
2079
\end_layout
2080
 
2081
\begin_layout Plain Layout
2082
 
2083
      </imageobject>
2084
\end_layout
2085
 
2086
\begin_layout Plain Layout
2087
 
2088
      <textobject>
2089
\end_layout
2090
 
2091
\begin_layout Plain Layout
2092
 
2093
         <phrase>Menu Edit</phrase>
2094
\end_layout
2095
 
2096
\begin_layout Plain Layout
2097
 
2098
      </textobject>
2099
\end_layout
2100
 
2101
\begin_layout Plain Layout
2102
 
2103
   </mediaobject>
2104
\end_layout
2105
 
2106
\begin_layout Plain Layout
2107
 
2108
</screenshot>
2109
\end_layout
2110
 
2111
\end_inset
2112
 
2113
 
2114
\end_layout
2115
 
2116
\begin_layout Subsection
2117
The menu item 
2118
\begin_inset ERT
2119
status open
2120
 
2121
\begin_layout Plain Layout
2122
 
2123
<guimenuitem>
2124
\end_layout
2125
 
2126
\end_inset
2127
 
2128
Rename
2129
\begin_inset ERT
2130
status open
2131
 
2132
\begin_layout Plain Layout
2133
 
2134
</guimenuitem>
2135
\end_layout
2136
 
2137
\end_inset
2138
 
2139
 
2140
\begin_inset CommandInset label
2141
LatexCommand label
2142
name "sec.The-menu-Rename"
2143
 
2144
\end_inset
2145
 
2146
 
2147
\end_layout
2148
 
2149
\begin_layout Standard
2150
This menu item allows to rename an activity.
2151
 After clicking on this item, a small dialog box, with an edit line in it,
2152
 appears.
2153
 The line contails the actual name of the activity.
2154
 In case this is the default name, consisting of the date and time, the
2155
 time may be somewhat shortened.
2156
 This is because there are only 15 characters allowed.
2157
 Type in the name you want and them click on the button 
2158
\begin_inset ERT
2159
status open
2160
 
2161
\begin_layout Plain Layout
2162
 
2163
<guibutton>
2164
\end_layout
2165
 
2166
\end_inset
2167
 
2168
Ok
2169
\begin_inset ERT
2170
status open
2171
 
2172
\begin_layout Plain Layout
2173
 
2174
</guibutton>
2175
\end_layout
2176
 
2177
\end_inset
2178
 
2179
.
2180
 This saves the new name and it shows up in the list of activities on the
2181
 left side of the main window.
2182
\end_layout
2183
 
2184
\begin_layout Section
2185
The menu 
2186
\begin_inset ERT
2187
status open
2188
 
2189
\begin_layout Plain Layout
2190
 
2191
<guimenu>
2192
\end_layout
2193
 
2194
\end_inset
2195
 
2196
Settings
2197
\begin_inset ERT
2198
status open
2199
 
2200
\begin_layout Plain Layout
2201
 
2202
</guimenu>
2203
\end_layout
2204
 
2205
\end_inset
2206
 
2207
 
2208
\begin_inset CommandInset label
2209
LatexCommand label
2210
name "sec.The-menu-Settings"
2211
 
2212
\end_inset
2213
 
2214
 
2215
\end_layout
2216
 
2217
\begin_layout Standard
2218
You must not setup SportWatcher to make use of it.
2219
 After successful installation, it should work out of the box.
2220
 But as allways, there are some settings available.
2221
 The following items show step by step the possible settings and their meaning.
2222
\end_layout
2223
 
2224
\begin_layout Standard
2225
\align center
2226
\begin_inset ERT
2227
status open
2228
 
2229
\begin_layout Plain Layout
2230
 
2231
<screenshot>
2232
\end_layout
2233
 
2234
\begin_layout Plain Layout
2235
 
2236
<screeninfo>Menu Settings</screeninfo>
2237
\end_layout
2238
 
2239
\begin_layout Plain Layout
2240
 
2241
   <mediaobject>
2242
\end_layout
2243
 
2244
\begin_layout Plain Layout
2245
 
2246
      <imageobject>
2247
\end_layout
2248
 
2249
\begin_layout Plain Layout
2250
 
2251
         <imagedata fileref="menuSettings.png" format="PNG"></imagedata>
2252
\end_layout
2253
 
2254
\begin_layout Plain Layout
2255
 
2256
      </imageobject>
2257
\end_layout
2258
 
2259
\begin_layout Plain Layout
2260
 
2261
      <textobject>
2262
\end_layout
2263
 
2264
\begin_layout Plain Layout
2265
 
2266
         <phrase>Menu Settings</phrase>
2267
\end_layout
2268
 
2269
\begin_layout Plain Layout
2270
 
2271
      </textobject>
2272
\end_layout
2273
 
2274
\begin_layout Plain Layout
2275
 
2276
   </mediaobject>
2277
\end_layout
2278
 
2279
\begin_layout Plain Layout
2280
 
2281
</screenshot>
2282
\end_layout
2283
 
2284
\end_inset
2285
 
2286
 
2287
\end_layout
2288
 
2289
\begin_layout Subsection
2290
The menu item 
2291
\series bold
2292
 
2293
\begin_inset ERT
2294
status open
2295
 
2296
\begin_layout Plain Layout
2297
 
2298
<guimenuitem>
2299
\end_layout
2300
 
2301
\end_inset
2302
 
2303
Configure SportWatcher
2304
\begin_inset ERT
2305
status open
2306
 
2307
\begin_layout Plain Layout
2308
 
2309
</guimenuitem>
2310
\end_layout
2311
 
2312
\end_inset
2313
 
2314
 
2315
\begin_inset CommandInset label
2316
LatexCommand label
2317
name "sec.The-menu-ConfSPW"
2318
 
2319
\end_inset
2320
 
2321
 
2322
\end_layout
2323
 
2324
\begin_layout Standard
2325
This item opens a dialog box, where you can set sevaral things.
2326
\end_layout
2327
 
2328
\begin_layout Standard
2329
\align center
2330
\begin_inset ERT
2331
status open
2332
 
2333
\begin_layout Plain Layout
2334
 
2335
<screenshot>
2336
\end_layout
2337
 
2338
\begin_layout Plain Layout
2339
 
2340
<screeninfo>Configure SportWatcher</screeninfo>
2341
\end_layout
2342
 
2343
\begin_layout Plain Layout
2344
 
2345
   <mediaobject>
2346
\end_layout
2347
 
2348
\begin_layout Plain Layout
2349
 
2350
      <imageobject>
2351
\end_layout
2352
 
2353
\begin_layout Plain Layout
2354
 
2355
         <imagedata fileref="ConfigureSportWatcher.png" format="PNG"></imagedata>
2356
\end_layout
2357
 
2358
\begin_layout Plain Layout
2359
 
2360
      </imageobject>
2361
\end_layout
2362
 
2363
\begin_layout Plain Layout
2364
 
2365
      <textobject>
2366
\end_layout
2367
 
2368
\begin_layout Plain Layout
2369
 
2370
         <phrase>Configure SportWatcher</phrase>
2371
\end_layout
2372
 
2373
\begin_layout Plain Layout
2374
 
2375
      </textobject>
2376
\end_layout
2377
 
2378
\begin_layout Plain Layout
2379
 
2380
   </mediaobject>
2381
\end_layout
2382
 
2383
\begin_layout Plain Layout
2384
 
2385
</screenshot>
2386
\end_layout
2387
 
2388
\end_inset
2389
 
2390
 
2391
\end_layout
2392
 
2393
\begin_layout Subsubsection
2394
Heart rate limits
2395
\begin_inset CommandInset label
2396
LatexCommand label
2397
name "sec.Heart-rate-limits"
2398
 
2399
\end_inset
2400
 
2401
 
2402
\end_layout
2403
 
2404
\begin_layout Standard
2405
This part contains the limits of your personal heart rate range.
2406
 You can find out this ranges with an expensive lactat test, where you have
2407
 to repeat this test several times to get the real limits.
2408
 If you want to do that, ask the doctor of trust.
2409
\end_layout
2410
 
2411
\begin_layout Standard
2412
A simpler method is the following formular:
2413
\end_layout
2414
 
2415
\begin_layout Code
2416
<Max.
2417
 HR> = 220 - <age>
2418
\end_layout
2419
 
2420
\begin_layout Standard
2421
From the maximum heart rate you can calculate the levels (or zones).
2422
 The following table shows how:
2423
\end_layout
2424
 
2425
\begin_layout Standard
2426
\begin_inset Tabular
2427
<lyxtabular version="3" rows="6" columns="4">
2428
<features>
2429
<column alignment="left" valignment="top" width="0">
2430
<column alignment="left" valignment="top" width="0">
2431
<column alignment="left" valignment="top" width="0">
2432
<column alignment="left" valignment="top" width="0">
2433
<row>
2434
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
2435
\begin_inset Text
2436
 
2437
\begin_layout Plain Layout
2438
Level
2439
\end_layout
2440
 
2441
\end_inset
2442
</cell>
2443
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
2444
\begin_inset Text
2445
 
2446
\begin_layout Plain Layout
2447
 
2448
\series bold
2449
Intensity
2450
\end_layout
2451
 
2452
\end_inset
2453
</cell>
2454
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
2455
\begin_inset Text
2456
 
2457
\begin_layout Plain Layout
2458
 
2459
\series bold
2460
Running
2461
\end_layout
2462
 
2463
\end_inset
2464
</cell>
2465
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
2466
\begin_inset Text
2467
 
2468
\begin_layout Plain Layout
2469
 
2470
\series bold
2471
Bike
2472
\end_layout
2473
 
2474
\end_inset
2475
</cell>
2476
</row>
2477
<row>
2478
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2479
\begin_inset Text
2480
 
2481
\begin_layout Plain Layout
2482
 
2483
\end_layout
2484
 
2485
\end_inset
2486
</cell>
2487
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2488
\begin_inset Text
2489
 
2490
\begin_layout Plain Layout
2491
very low
2492
\end_layout
2493
 
2494
\end_inset
2495
</cell>
2496
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2497
\begin_inset Text
2498
 
2499
\begin_layout Plain Layout
2500
< 65% (Regular run)
2501
\end_layout
2502
 
2503
\end_inset
2504
</cell>
2505
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2506
\begin_inset Text
2507
 
2508
\begin_layout Plain Layout
2509
< 52% (CO --> Compensation)
2510
\end_layout
2511
 
2512
\end_inset
2513
</cell>
2514
</row>
2515
<row>
2516
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2517
\begin_inset Text
2518
 
2519
\begin_layout Plain Layout
2520
1
2521
\end_layout
2522
 
2523
\end_inset
2524
</cell>
2525
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2526
\begin_inset Text
2527
 
2528
\begin_layout Plain Layout
2529
low
2530
\end_layout
2531
 
2532
\end_inset
2533
</cell>
2534
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2535
\begin_inset Text
2536
 
2537
\begin_layout Plain Layout
2538
65% - 80% (Ext run --> extensive run)
2539
\end_layout
2540
 
2541
\end_inset
2542
</cell>
2543
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2544
\begin_inset Text
2545
 
2546
\begin_layout Plain Layout
2547
52% - 65% (SP1 --> Basic staying power 1)
2548
\end_layout
2549
 
2550
\end_inset
2551
</cell>
2552
</row>
2553
<row>
2554
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2555
\begin_inset Text
2556
 
2557
\begin_layout Plain Layout
2558
2
2559
\end_layout
2560
 
2561
\end_inset
2562
</cell>
2563
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2564
\begin_inset Text
2565
 
2566
\begin_layout Plain Layout
2567
middle
2568
\end_layout
2569
 
2570
\end_inset
2571
</cell>
2572
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2573
\begin_inset Text
2574
 
2575
\begin_layout Plain Layout
2576
80% - 85% (Int run --> intensive run)
2577
\end_layout
2578
 
2579
\end_inset
2580
</cell>
2581
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2582
\begin_inset Text
2583
 
2584
\begin_layout Plain Layout
2585
65% - 77% (SP2 --> Basic staying power 2)
2586
\end_layout
2587
 
2588
\end_inset
2589
</cell>
2590
</row>
2591
<row>
2592
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2593
\begin_inset Text
2594
 
2595
\begin_layout Plain Layout
2596
3
2597
\end_layout
2598
 
2599
\end_inset
2600
</cell>
2601
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2602
\begin_inset Text
2603
 
2604
\begin_layout Plain Layout
2605
high
2606
\end_layout
2607
 
2608
\end_inset
2609
</cell>
2610
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2611
\begin_inset Text
2612
 
2613
\begin_layout Plain Layout
2614
85% - 90% (SPR --> speed run)
2615
\end_layout
2616
 
2617
\end_inset
2618
</cell>
2619
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2620
\begin_inset Text
2621
 
2622
\begin_layout Plain Layout
2623
77% - 90% (PO--> Power)
2624
\end_layout
2625
 
2626
\end_inset
2627
</cell>
2628
</row>
2629
<row>
2630
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
2631
\begin_inset Text
2632
 
2633
\begin_layout Plain Layout
2634
4 (>3)
2635
\end_layout
2636
 
2637
\end_inset
2638
</cell>
2639
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
2640
\begin_inset Text
2641
 
2642
\begin_layout Plain Layout
2643
very high
2644
\end_layout
2645
 
2646
\end_inset
2647
</cell>
2648
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
2649
\begin_inset Text
2650
 
2651
\begin_layout Plain Layout
2652
> 90% (R --> Race)
2653
\end_layout
2654
 
2655
\end_inset
2656
</cell>
2657
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
2658
\begin_inset Text
2659
 
2660
\begin_layout Plain Layout
2661
> 90% (HP --> High power)
2662
\end_layout
2663
 
2664
\end_inset
2665
</cell>
2666
</row>
2667
</lyxtabular>
2668
 
2669
\end_inset
2670
 
2671
 
2672
\end_layout
2673
 
2674
\begin_layout Subsubsection
2675
Other limits
2676
\begin_inset CommandInset label
2677
LatexCommand label
2678
name "sec.Other-limits"
2679
 
2680
\end_inset
2681
 
2682
 
2683
\end_layout
2684
 
2685
\begin_layout Standard
2686
The 
2687
\begin_inset ERT
2688
status open
2689
 
2690
\begin_layout Plain Layout
2691
 
2692
<guilabel>
2693
\end_layout
2694
 
2695
\end_inset
2696
 
2697
VO2max
2698
\begin_inset ERT
2699
status open
2700
 
2701
\begin_layout Plain Layout
2702
 
2703
</guilabel>
2704
\end_layout
2705
 
2706
\end_inset
2707
 
2708
 gives the maximum oxygen saturation in percent.
2709
 This indicator is also found during a lactat test.
2710
 Unfortunately there is no simple formula to calculate this, as far as I
2711
 know.
2712
 The second value 
2713
\begin_inset ERT
2714
status open
2715
 
2716
\begin_layout Plain Layout
2717
 
2718
<guilabel>
2719
\end_layout
2720
 
2721
\end_inset
2722
 
2723
weight
2724
\begin_inset ERT
2725
status open
2726
 
2727
\begin_layout Plain Layout
2728
 
2729
</guilabel>
2730
\end_layout
2731
 
2732
\end_inset
2733
 
2734
 is the the weight of your body in 
2735
\emph on
2736
kilogramm
2737
\emph default
2738
.
2739
\end_layout
2740
 
2741
\begin_layout Subsubsection
2742
Device and file settings
2743
\begin_inset CommandInset label
2744
LatexCommand label
2745
name "sec.Device-and-file"
2746
 
2747
\end_inset
2748
 
2749
 
2750
\end_layout
2751
 
2752
\begin_layout Standard
2753
The settings in this block defines the path and files, where SportWatcher
2754
 stores it data.
2755
\end_layout
2756
 
2757
\begin_layout Paragraph
2758
Even surface contour line
2759
\begin_inset CommandInset label
2760
LatexCommand label
2761
name "sec.Even-surface-contour"
2762
 
2763
\end_inset
2764
 
2765
 
2766
\end_layout
2767
 
2768
\begin_layout Standard
2769
If the meassure of height is not very exact, and you get big fluctuations
2770
 especially when there are only small differences in height, you can check
2771
 this.
2772
 It will slightly even the contour line.
2773
\end_layout
2774
 
2775
\begin_layout Paragraph
2776
Use serial port instead of USB port
2777
\begin_inset CommandInset label
2778
LatexCommand label
2779
name "sec.Use-serial-port"
2780
 
2781
\end_inset
2782
 
2783
 
2784
\end_layout
2785
 
2786
\begin_layout Standard
2787
If your GPS receiver has only a serial port, you can set this here.
2788
 You can set the name of the device as described under 
2789
\begin_inset CommandInset ref
2790
LatexCommand ref
2791
reference "sec.Serial-device"
2792
 
2793
\end_inset
2794
 
2795
.
2796
\end_layout
2797
 
2798
\begin_layout Standard
2799
\begin_inset ERT
2800
status open
2801
 
2802
\begin_layout Plain Layout
2803
 
2804
<note><para>This function is not tested and it's very likely that it will
2805
 not work!</para></note>
2806
\end_layout
2807
 
2808
\end_inset
2809
 
2810
 
2811
\end_layout
2812
 
2813
\begin_layout Paragraph
2814
Serial device
2815
\begin_inset CommandInset label
2816
LatexCommand label
2817
name "sec.Serial-device"
2818
 
2819
\end_inset
2820
 
2821
 
2822
\end_layout
2823
 
2824
\begin_layout Standard
2825
The name of the serial device your GPS receiver is connected to.
2826
 This is only enabled, if you've checked 
2827
\begin_inset ERT
2828
status open
2829
 
2830
\begin_layout Plain Layout
2831
 
2832
<guilabel>
2833
\end_layout
2834
 
2835
\end_inset
2836
 
2837
Use serial port instead of USB port
2838
\begin_inset ERT
2839
status open
2840
 
2841
\begin_layout Plain Layout
2842
 
2843
</guilabel>
2844
\end_layout
2845
 
2846
\end_inset
2847
 
2848
 (look at 
2849
\begin_inset CommandInset ref
2850
LatexCommand ref
2851
reference "sec.Use-serial-port"
2852
 
2853
\end_inset
2854
 
2855
).
2856
\end_layout
2857
 
2858
\begin_layout Paragraph
2859
Data files
2860
\begin_inset CommandInset label
2861
LatexCommand label
2862
name "sec.Data-files"
2863
 
2864
\end_inset
2865
 
2866
 
2867
\end_layout
2868
 
2869
\begin_layout Standard
2870
\begin_inset ERT
2871
status open
2872
 
2873
\begin_layout Plain Layout
2874
 
2875
&sportwatcher;
2876
\end_layout
2877
 
2878
\end_inset
2879
 
2880
 save the data files, containing the activities in the directory, you specify
2881
 here.
2882
 Standard is 
2883
\begin_inset ERT
2884
status open
2885
 
2886
\begin_layout Plain Layout
2887
 
2888
<literal role="extension">
2889
\end_layout
2890
 
2891
\end_inset
2892
 
2893
.sportwatcher
2894
\begin_inset ERT
2895
status open
2896
 
2897
\begin_layout Plain Layout
2898
 
2899
</literal>
2900
\end_layout
2901
 
2902
\end_inset
2903
 
2904
 in your home directory.
2905
 After the first start, and after you've downloaded your first activity,
2906
 
2907
\begin_inset ERT
2908
status open
2909
 
2910
\begin_layout Plain Layout
2911
 
2912
&sportwatcher;
2913
\end_layout
2914
 
2915
\end_inset
2916
 
2917
 creates this directory, in case it does not already exist, and saves the
2918
 activities there.
2919
\end_layout
2920
 
2921
\begin_layout Paragraph
2922
HRM files
2923
\begin_inset CommandInset label
2924
LatexCommand label
2925
name "sec.HRM-files"
2926
 
2927
\end_inset
2928
 
2929
 
2930
\end_layout
2931
 
2932
\begin_layout Standard
2933
SportWatcher is able to save the heart rate data of an activity into Polars
2934
 
2935
\begin_inset ERT
2936
status open
2937
 
2938
\begin_layout Plain Layout
2939
 
2940
<acronym>
2941
\end_layout
2942
 
2943
\end_inset
2944
 
2945
HRM
2946
\begin_inset ERT
2947
status open
2948
 
2949
\begin_layout Plain Layout
2950
 
2951
</acronym>
2952
\end_layout
2953
 
2954
\end_inset
2955
 
2956
 format.
2957
 If you do that (look at 
2958
\begin_inset CommandInset ref
2959
LatexCommand ref
2960
reference "sec.The-menu-HR"
2961
 
2962
\end_inset
2963
 
2964
), the file dialog box opens with the directory you set here.
2965
 In case you use the software from Polar, than you can set this directory
2966
 to the one your Polar software uses.
2967
 SportWatcher sets the file name to the same notation Polar uses.
2968
 This makes the files from SportWatcher fit seamlessly into the ones of
2969
 Polar.
2970
\end_layout
2971
 
2972
\begin_layout Standard
2973
\begin_inset ERT
2974
status open
2975
 
2976
\begin_layout Plain Layout
2977
 
2978
<note><para>Because the format from Polar can only hold heard rate data
2979
 with a fixed sample rate (5, 15, 30 or 60 seconds) the meassure points
2980
 are averaged to fit the sample rate (look at <xref linkend="sec.Other-limits"
2981
 />)</para></note>
2982
\end_layout
2983
 
2984
\end_inset
2985
 
2986
 
2987
\end_layout
2988
 
2989
\begin_layout Paragraph
2990
Map file
2991
\begin_inset CommandInset label
2992
LatexCommand label
2993
name "sec.Map-file"
2994
 
2995
\end_inset
2996
 
2997
 
2998
\end_layout
2999
 
3000
\begin_layout Standard
3001
Enter in this line the path and name of a file that is a raster image of
3002
 a map or a control file.
3003
 It depends on the type of map (look at 
3004
\begin_inset CommandInset ref
3005
LatexCommand ref
3006
reference "sec.Map-type"
3007
 
3008
\end_inset
3009
 
3010
) you've set.
3011
\end_layout
3012
 
3013
\begin_layout Subparagraph
3014
Raster images
3015
\end_layout
3016
 
3017
\begin_layout Standard
3018
A raster image is a simple picture file.
3019
 You can view such files with nearly every graphic program (
3020
\begin_inset ERT
3021
status open
3022
 
3023
\begin_layout Plain Layout
3024
 
3025
<command>
3026
\end_layout
3027
 
3028
\end_inset
3029
 
3030
GIMP
3031
\begin_inset ERT
3032
status open
3033
 
3034
\begin_layout Plain Layout
3035
 
3036
</command>
3037
\end_layout
3038
 
3039
\end_inset
3040
 
3041
, 
3042
\begin_inset ERT
3043
status open
3044
 
3045
\begin_layout Plain Layout
3046
 
3047
<command>
3048
\end_layout
3049
 
3050
\end_inset
3051
 
3052
Gwenview
3053
\begin_inset ERT
3054
status open
3055
 
3056
\begin_layout Plain Layout
3057
 
3058
</command>
3059
\end_layout
3060
 
3061
\end_inset
3062
 
3063
, etc.).
3064
 These files have extensions like 
3065
\begin_inset ERT
3066
status open
3067
 
3068
\begin_layout Plain Layout
3069
 
3070
<literal role="extension">.gif</literal>
3071
\end_layout
3072
 
3073
\end_inset
3074
 
3075
, 
3076
\begin_inset ERT
3077
status open
3078
 
3079
\begin_layout Plain Layout
3080
 
3081
<literal role="extension">.png</literal>
3082
\end_layout
3083
 
3084
\end_inset
3085
 
3086
, 
3087
\begin_inset ERT
3088
status open
3089
 
3090
\begin_layout Plain Layout
3091
 
3092
<literal role="extension">.tiff</literal>
3093
\end_layout
3094
 
3095
\end_inset
3096
 
3097
 and the like.
3098
 To make use of such images, you've to know the geo coordinates of the upper
3099
 left and the lower right corner.
3100
 Only the format 
3101
\begin_inset ERT
3102
status open
3103
 
3104
\begin_layout Plain Layout
3105
 
3106
<acronym>TIFF</acronym>
3107
\end_layout
3108
 
3109
\end_inset
3110
 
3111
 allows to save the geo coordinates directly in the file header.
3112
 But this is an optional information and you can't be sure that it's there.
3113
 These raster images have the drawback, that they have a fixed resolution.
3114
 They also show only a particular area and if your training session is partly
3115
 or completely off this area, you get only a part or even no map.
3116
 The advantage of a raster image is, that you need no external server or
3117
 network connection to get them.
3118
 Because they are local on your disc, they are allways available.
3119
\end_layout
3120
 
3121
\begin_layout Subparagraph
3122
Other sources of maps
3123
\end_layout
3124
 
3125
\begin_layout Standard
3126
To not have the dawback of a raster image, you can use a 
3127
\begin_inset ERT
3128
status open
3129
 
3130
\begin_layout Plain Layout
3131
 
3132
<acronym>
3133
\end_layout
3134
 
3135
\end_inset
3136
 
3137
WMS
3138
\begin_inset ERT
3139
status open
3140
 
3141
\begin_layout Plain Layout
3142
 
3143
</acronym>
3144
\end_layout
3145
 
3146
\end_inset
3147
 
3148
 server as a source of maps.
3149
 Unless this server isn't running on your local machine, you need an internet
3150
 connection to access it.
3151
 If you've set a 
3152
\begin_inset ERT
3153
status open
3154
 
3155
\begin_layout Plain Layout
3156
 
3157
<acronym>
3158
\end_layout
3159
 
3160
\end_inset
3161
 
3162
WMS
3163
\begin_inset ERT
3164
status open
3165
 
3166
\begin_layout Plain Layout
3167
 
3168
</acronym>
3169
\end_layout
3170
 
3171
\end_inset
3172
 
3173
 server, you must enter here the path and the name of the control file.
3174
 SportWatcher creates this control file itself, so you don't have to bother
3175
 with it.
3176
 Entering the name here makes sure, it will be created in a directory, where
3177
 SportWatcher have read and write access to.
3178
\end_layout
3179
 
3180
\begin_layout Standard
3181
Allthoug you can select 
3182
\begin_inset ERT
3183
status open
3184
 
3185
\begin_layout Plain Layout
3186
 
3187
<acronym>
3188
\end_layout
3189
 
3190
\end_inset
3191
 
3192
Shape
3193
\begin_inset ERT
3194
status open
3195
 
3196
\begin_layout Plain Layout
3197
 
3198
</acronym>
3199
\end_layout
3200
 
3201
\end_inset
3202
 
3203
 files as a source too, this is currently not supported.
3204
 In case of a 
3205
\begin_inset ERT
3206
status open
3207
 
3208
\begin_layout Plain Layout
3209
 
3210
<acronym>
3211
\end_layout
3212
 
3213
\end_inset
3214
 
3215
Shape
3216
\begin_inset ERT
3217
status open
3218
 
3219
\begin_layout Plain Layout
3220
 
3221
</acronym>
3222
\end_layout
3223
 
3224
\end_inset
3225
 
3226
 file you've to enter here only the path where the 
3227
\begin_inset ERT
3228
status open
3229
 
3230
\begin_layout Plain Layout
3231
 
3232
<acronym>
3233
\end_layout
3234
 
3235
\end_inset
3236
 
3237
Shape
3238
\begin_inset ERT
3239
status open
3240
 
3241
\begin_layout Plain Layout
3242
 
3243
</acronym>
3244
\end_layout
3245
 
3246
\end_inset
3247
 
3248
 files are.
3249
 In future SportWatcher will be able to read them and draw a map out of
3250
 them.
3251
 This will combine the advantages of vector maps with the advantages of
3252
 local raster images, because a 
3253
\begin_inset ERT
3254
status open
3255
 
3256
\begin_layout Plain Layout
3257
 
3258
<acronym>
3259
\end_layout
3260
 
3261
\end_inset
3262
 
3263
Shape
3264
\begin_inset ERT
3265
status open
3266
 
3267
\begin_layout Plain Layout
3268
 
3269
</acronym>
3270
\end_layout
3271
 
3272
\end_inset
3273
 
3274
 file is a local file, containing a map, or a part of it, in vector coordinates.
3275
\end_layout
3276
 
3277
\begin_layout Paragraph
3278
Map type
3279
\begin_inset CommandInset label
3280
LatexCommand label
3281
name "sec.Map-type"
3282
 
3283
\end_inset
3284
 
3285
 
3286
\end_layout
3287
 
3288
\begin_layout Standard
3289
This sets the type of map.
3290
 Basicly you can distinguish between raster images and vector based maps.
3291
 Most vector based maps (
3292
\begin_inset ERT
3293
status open
3294
 
3295
\begin_layout Plain Layout
3296
 
3297
<acronym>
3298
\end_layout
3299
 
3300
\end_inset
3301
 
3302
WMS
3303
\begin_inset ERT
3304
status open
3305
 
3306
\begin_layout Plain Layout
3307
 
3308
</acronym>
3309
\end_layout
3310
 
3311
\end_inset
3312
 
3313
 servers, 
3314
\begin_inset ERT
3315
status open
3316
 
3317
\begin_layout Plain Layout
3318
 
3319
<acronym>
3320
\end_layout
3321
 
3322
\end_inset
3323
 
3324
Shape
3325
\begin_inset ERT
3326
status open
3327
 
3328
\begin_layout Plain Layout
3329
 
3330
</acronym>
3331
\end_layout
3332
 
3333
\end_inset
3334
 
3335
 files) need the name and location where SportWatcher can create a control
3336
 file (look at 
3337
\begin_inset CommandInset ref
3338
LatexCommand ref
3339
reference "sec.Map-file"
3340
 
3341
\end_inset
3342
 
3343
).
3344
 For raster images you've to set the path and name of the file containing
3345
 the raster image.
3346
\end_layout
3347
 
3348
\begin_layout Standard
3349
The setting here is necessary to allow SportWatcher to decide which settings
3350
 dialog to show (look at 
3351
\begin_inset CommandInset ref
3352
LatexCommand ref
3353
reference "sec.The-menu-ConfMap"
3354
 
3355
\end_inset
3356
 
3357
).
3358
\end_layout
3359
 
3360
\begin_layout Subsubsection
3361
Units
3362
\begin_inset CommandInset label
3363
LatexCommand label
3364
name "sec.Units"
3365
 
3366
\end_inset
3367
 
3368
 
3369
\end_layout
3370
 
3371
\begin_layout Standard
3372
Here you can set metric units or U.S.
3373
 statute.
3374
\end_layout
3375
 
3376
\begin_layout Standard
3377
In case of metric units, SportWatcher shows meters, kilometers, kilometer
3378
 per hour.
3379
 If you still used to the old U.S.
3380
 statute units, SportWatcher shows feets, miles and miles per hour.
3381
\end_layout
3382
 
3383
\begin_layout Subsection
3384
The menu item 
3385
\begin_inset ERT
3386
status open
3387
 
3388
\begin_layout Plain Layout
3389
 
3390
<guimenuitem>
3391
\end_layout
3392
 
3393
\end_inset
3394
 
3395
Configure map
3396
\begin_inset ERT
3397
status open
3398
 
3399
\begin_layout Plain Layout
3400
 
3401
</guimenuitem>
3402
\end_layout
3403
 
3404
\end_inset
3405
 
3406
 
3407
\begin_inset CommandInset label
3408
LatexCommand label
3409
name "sec.The-menu-ConfMap"
3410
 
3411
\end_inset
3412
 
3413
 
3414
\end_layout
3415
 
3416
\begin_layout Standard
3417
Dependend on the set map type (look at 
3418
\begin_inset CommandInset ref
3419
LatexCommand ref
3420
reference "sec.Map-type"
3421
 
3422
\end_inset
3423
 
3424
), SportWatcher displays an individual dialog to set the necessary settings
3425
 for the selected map.
3426
 Currently there are two dialog boxes.
3427
 One to set everything for a 
3428
\begin_inset ERT
3429
status open
3430
 
3431
\begin_layout Plain Layout
3432
 
3433
<acronym>
3434
\end_layout
3435
 
3436
\end_inset
3437
 
3438
WMS
3439
\begin_inset ERT
3440
status open
3441
 
3442
\begin_layout Plain Layout
3443
 
3444
</acronym>
3445
\end_layout
3446
 
3447
\end_inset
3448
 
3449
 server and one to define the corners of a map in geo coordinates.
3450
\end_layout
3451
 
3452
\begin_layout Subsubsection
3453
WMS
3454
\begin_inset CommandInset label
3455
LatexCommand label
3456
name "sec.WMS"
3457
 
3458
\end_inset
3459
 
3460
 
3461
\end_layout
3462
 
3463
\begin_layout Standard
3464
\align center
3465
\begin_inset ERT
3466
status open
3467
 
3468
\begin_layout Plain Layout
3469
 
3470
<screenshot>
3471
\end_layout
3472
 
3473
\begin_layout Plain Layout
3474
 
3475
<screeninfo>Configure WMS</screeninfo>
3476
\end_layout
3477
 
3478
\begin_layout Plain Layout
3479
 
3480
   <mediaobject>
3481
\end_layout
3482
 
3483
\begin_layout Plain Layout
3484
 
3485
      <imageobject>
3486
\end_layout
3487
 
3488
\begin_layout Plain Layout
3489
 
3490
         <imagedata fileref="ConfigureWMS.png" format="PNG"></imagedata>
3491
\end_layout
3492
 
3493
\begin_layout Plain Layout
3494
 
3495
      </imageobject>
3496
\end_layout
3497
 
3498
\begin_layout Plain Layout
3499
 
3500
      <textobject>
3501
\end_layout
3502
 
3503
\begin_layout Plain Layout
3504
 
3505
         <phrase>Configure WMS</phrase>
3506
\end_layout
3507
 
3508
\begin_layout Plain Layout
3509
 
3510
      </textobject>
3511
\end_layout
3512
 
3513
\begin_layout Plain Layout
3514
 
3515
   </mediaobject>
3516
\end_layout
3517
 
3518
\begin_layout Plain Layout
3519
 
3520
</screenshot>
3521
\end_layout
3522
 
3523
\end_inset
3524
 
3525
 
3526
\end_layout
3527
 
3528
\begin_layout Standard
3529
This dialog contains all necessary controls to set up the 
3530
\begin_inset ERT
3531
status open
3532
 
3533
\begin_layout Plain Layout
3534
 
3535
<acronym>
3536
\end_layout
3537
 
3538
\end_inset
3539
 
3540
 
3541
WMS
3542
\lang english
3543
 
3544
\begin_inset ERT
3545
status open
3546
 
3547
\begin_layout Plain Layout
3548
 
3549
</acronym>
3550
\end_layout
3551
 
3552
\end_inset
3553
 
3554
 client.
3555
 You can access a WMS server over the 
3556
\begin_inset ERT
3557
status open
3558
 
3559
\begin_layout Plain Layout
3560
 
3561
<acronym>
3562
\end_layout
3563
 
3564
\end_inset
3565
 
3566
HTTP
3567
\begin_inset ERT
3568
status open
3569
 
3570
\begin_layout Plain Layout
3571
 
3572
</acronym>
3573
\end_layout
3574
 
3575
\end_inset
3576
 
3577
 protocol.
3578
 To get a map, you can use a simple 
3579
\begin_inset ERT
3580
status open
3581
 
3582
\begin_layout Plain Layout
3583
 
3584
<acronym>
3585
\end_layout
3586
 
3587
\end_inset
3588
 
3589
URL
3590
\begin_inset ERT
3591
status open
3592
 
3593
\begin_layout Plain Layout
3594
 
3595
</acronym>
3596
\end_layout
3597
 
3598
\end_inset
3599
 
3600
.
3601
 You can use your internet browser to try that out.
3602
 Type in the following URL:
3603
\end_layout
3604
 
3605
\begin_layout Code
3606
http://onearth.jpl.nasa.gov/wms.cgi?VERSION=1.1.1&REQUEST=GetMap&SRS=EPSG:4326&LAYERS=
3607
modis,global_mosaic&STYLES=&FORMAT=image/png&WIDTH=800&HEIGHT=600&BBOX=14.200104,
3608
46.612177,14.307995,46.633730
3609
\end_layout
3610
 
3611
\begin_layout Standard
3612
You should get a satelite picture of a part of 
3613
\emph on
3614
Klagenfurt
3615
\emph default
3616
, a city in austria, and a piece of the 
3617
\emph on
3618
W
3619
\begin_inset ERT
3620
status open
3621
 
3622
\begin_layout Plain Layout
3623
 
3624
&ouml;
3625
\end_layout
3626
 
3627
\end_inset
3628
 
3629
rtersee
3630
\emph default
3631
, a lake.
3632
 
3633
\emph on
3634
Klagenfurt
3635
\emph default
3636
 is on the bank of this lake.
3637
 This example shows how easy it is to access a WMS server.
3638
 SportWatcher sets all necessary parameters, including the wanted boundaries
3639
 for you, so you don't have to bother with that.
3640
 Beside the WMS server in our example, there are many others available.
3641
 Look at
3642
\end_layout
3643
 
3644
\begin_layout Code
3645
\begin_inset CommandInset href
3646
LatexCommand href
3647
name "http://www.skylab-mobilesystems.com/ger/wms_serverlist.html"
3648
target "http://www.skylab-mobilesystems.com/ger/wms_serverlist.html"
3649
 
3650
\end_inset
3651
 
3652
 
3653
\end_layout
3654
 
3655
\begin_layout Standard
3656
for a large list of free WMS servers.
3657
\end_layout
3658
 
3659
\begin_layout Paragraph
3660
Server URL
3661
\begin_inset CommandInset label
3662
LatexCommand label
3663
name "sec.Server-URL"
3664
 
3665
\end_inset
3666
 
3667
 
3668
\end_layout
3669
 
3670
\begin_layout Standard
3671
Enter the 
3672
\begin_inset ERT
3673
status open
3674
 
3675
\begin_layout Plain Layout
3676
 
3677
<acronym>
3678
\end_layout
3679
 
3680
\end_inset
3681
 
3682
URL
3683
\begin_inset ERT
3684
status open
3685
 
3686
\begin_layout Plain Layout
3687
 
3688
</acronym>
3689
\end_layout
3690
 
3691
\end_inset
3692
 
3693
 of the WMS server.
3694
 Related to our example above, this would be:
3695
\end_layout
3696
 
3697
\begin_layout Code
3698
http://onearth.jpl.nasa.gov/wms.cgi
3699
\end_layout
3700
 
3701
\begin_layout Standard
3702
You can omit the extra parameters, as shown in the above example, because
3703
 SportWatcher will set them for you.
3704
\end_layout
3705
 
3706
\begin_layout Paragraph
3707
Layer name
3708
\begin_inset CommandInset label
3709
LatexCommand label
3710
name "sec.Layer-name"
3711
 
3712
\end_inset
3713
 
3714
 
3715
\end_layout
3716
 
3717
\begin_layout Standard
3718
A WMS server can provide several 
3719
\emph on
3720
layers
3721
\emph default
3722
 to distinguish between parts of a map.
3723
 Imagine a street map, for example.
3724
 There one layer could contain the streets, another contains the rivers
3725
 and another the rail ways.
3726
 Putting this three layer together results in a complete street map.
3727
 If you enter some layer names, you have to separate them with commas.
3728
 Thing about the order of the maps! For example: Should the streets be drawn
3729
 over the rivers or the other way?
3730
\end_layout
3731
 
3732
\begin_layout Paragraph
3733
SRS
3734
\begin_inset CommandInset label
3735
LatexCommand label
3736
name "sec.SRS"
3737
 
3738
\end_inset
3739
 
3740
 
3741
\end_layout
3742
 
3743
\begin_layout Standard
3744
To get a map with correct dimensions, the WMS server have to know the wanted
3745
 geodetic date.
3746
 If you want to learn more about geoids and projections, look at:
3747
\end_layout
3748
 
3749
\begin_layout Code
3750
\begin_inset CommandInset href
3751
LatexCommand href
3752
name "http://en.wikipedia.org/wiki/Geoid"
3753
target "http://en.wikipedia.org/wiki/Geoid"
3754
 
3755
\end_inset
3756
 
3757
 
3758
\end_layout
3759
 
3760
\begin_layout Standard
3761
SportWatcher provides several geodetic dates.
3762
 You must choose one, that is supported by the WMS server.
3763
 Otherwise the map will not exactly fit under the tracks.
3764
 In doubt take 
3765
\emph on
3766
EPSG:4326
3767
\emph default
3768
, also known as 
3769
\emph on
3770
WGS84
3771
\emph default
3772
.
3773
\end_layout
3774
 
3775
\begin_layout Paragraph
3776
CRS
3777
\begin_inset CommandInset label
3778
LatexCommand label
3779
name "sec.CRS"
3780
 
3781
\end_inset
3782
 
3783
 
3784
\end_layout
3785
 
3786
\begin_layout Standard
3787
CRS is mostly the same as SRS (look at 
3788
\begin_inset CommandInset ref
3789
LatexCommand ref
3790
reference "sec.SRS"
3791
 
3792
\end_inset
3793
 
3794
).
3795
 But this parameter is optional.
3796
 In doubt, take 
3797
\emph on
3798
WGS84
3799
\emph default
3800
.
3801
\end_layout
3802
 
3803
\begin_layout Paragraph
3804
Bands
3805
\end_layout
3806
 
3807
\begin_layout Standard
3808
A WMS server returns a raster image, representing the requested map.
3809
 Every digital picture consist of informations for every of the three color
3810
 channels red, green and blue.
3811
 Such a channel is also called a band (because of the method the information
3812
 of the picture is managed internally).
3813
 In case of a color picture, there are at least three bands.
3814
 However.
3815
 Such a picture could contain a fourth band, called the alpha channel.
3816
 The alpha channels defines the transparency of every pixel of the picture.
3817
 It is important to set the correct number of bands, because you'll get
3818
 an error if this is set wrong!
3819
\end_layout
3820
 
3821
\begin_layout Standard
3822
\begin_inset ERT
3823
status open
3824
 
3825
\begin_layout Plain Layout
3826
 
3827
<note><para>If you get an error stating wrong band count, start &sportwatcher;
3828
 from the command line and try to get the map again.
3829
 &sportwatcher; puts out some error messages where you can find out the
3830
 needed band count.</para></note>
3831
\end_layout
3832
 
3833
\end_inset
3834
 
3835
 
3836
\end_layout
3837
 
3838
\begin_layout Paragraph
3839
Version
3840
\begin_inset CommandInset label
3841
LatexCommand label
3842
name "sec.Version"
3843
 
3844
\end_inset
3845
 
3846
 
3847
\end_layout
3848
 
3849
\begin_layout Standard
3850
There are more than one version of communication protocol for WMS servers.
3851
 A WMS server should be backward compatible and should support version 1.1.0
3852
 at least.
3853
 Today most of the WMS server support version 1.1.1.
3854
 Only newer servers also support protocol version 1.3.0.
3855
 In doubt set this to 1.1.1.
3856
\end_layout
3857
 
3858
\begin_layout Paragraph
3859
Stile
3860
\begin_inset CommandInset label
3861
LatexCommand label
3862
name "sec.Stile"
3863
 
3864
\end_inset
3865
 
3866
 
3867
\end_layout
3868
 
3869
\begin_layout Standard
3870
Beside the above mentioned layers (look at 
3871
\begin_inset CommandInset ref
3872
LatexCommand ref
3873
reference "sec.Layer-name"
3874
 
3875
\end_inset
3876
 
3877
), styles are also supported.
3878
 For most WMS servers styles are optional.
3879
 A style is a variant or part of a layer.
3880
 One layer could consist, for example, of the styles country road, interstate
3881
 road and highway.
3882
 Every kind of street can be a style.
3883
 This allows you to filter particular types of roads.
3884
 But it's only allowed to give the name of one style per layer.
3885
 Be carefull to define exactly the same number of styles, as you've defined
3886
 layers and pay attention of the order of the styles.
3887
 They must apperar in the same order like the layers (one style per layer).
3888
\end_layout
3889
 
3890
\begin_layout Paragraph
3891
Tile size
3892
\begin_inset CommandInset label
3893
LatexCommand label
3894
name "sec.Tile-size"
3895
 
3896
\end_inset
3897
 
3898
 
3899
\end_layout
3900
 
3901
\begin_layout Standard
3902
To save band width, SportWatcher groups the map into several quadrats with
3903
 equal size.
3904
 This tiles are stored on the disk in a temporary cache.
3905
 If some parts can be reused later, SportWatcher will take them out of the
3906
 cache rather than downloading them again.
3907
\end_layout
3908
 
3909
\begin_layout Standard
3910
This setting allows to set the size of such a tile.
3911
 The optimal size depends on the WMS server.
3912
 You may test this to find out what works fastest.
3913
\end_layout
3914
 
3915
\begin_layout Paragraph
3916
Depth
3917
\begin_inset CommandInset label
3918
LatexCommand label
3919
name "sec.Depth"
3920
 
3921
\end_inset
3922
 
3923
 
3924
\end_layout
3925
 
3926
\begin_layout Standard
3927
Number of directory layers.
3928
 2 will result in files being written as <cache_path>/A/B/ABCDEF...
3929
 (defaults to 2).
3930
\end_layout
3931
 
3932
\begin_layout Paragraph
3933
Overview count
3934
\begin_inset CommandInset label
3935
LatexCommand label
3936
name "sec.Overview-count"
3937
 
3938
\end_inset
3939
 
3940
 
3941
\end_layout
3942
 
3943
\begin_layout Standard
3944
Count of reduced resolution layers each having 2 times lower resolution.
3945
 In doubt set to 10.
3946
\end_layout
3947
 
3948
\begin_layout Paragraph
3949
WMS Server uses square pixels
3950
\begin_inset CommandInset label
3951
LatexCommand label
3952
name "sec.WMS-squarepixel"
3953
 
3954
\end_inset
3955
 
3956
 
3957
\end_layout
3958
 
3959
\begin_layout Standard
3960
In case you find a WMS server that is not able to calculate the projection
3961
 correct, you can try to set this option.
3962
\end_layout
3963
 
3964
\begin_layout Paragraph
3965
Offline mode
3966
\begin_inset CommandInset label
3967
LatexCommand label
3968
name "sec.Offline-mode"
3969
 
3970
\end_inset
3971
 
3972
 
3973
\end_layout
3974
 
3975
\begin_layout Standard
3976
If you set this option, SportWatcher will not try to get a map from a WMS
3977
 server.
3978
 It only looks into the local cache and if it finds a map there, it displays
3979
 ist.
3980
 Otherwise the track appears with a black background.
3981
\end_layout
3982
 
3983
\begin_layout Paragraph
3984
Advice read
3985
\begin_inset CommandInset label
3986
LatexCommand label
3987
name "sec.Advice-read"
3988
 
3989
\end_inset
3990
 
3991
 
3992
\end_layout
3993
 
3994
\begin_layout Standard
3995
Download images into cache.
3996
 This saves time and brings a map faster to screen.
3997
\end_layout
3998
 
3999
\begin_layout Paragraph
4000
Verify advice read
4001
\begin_inset CommandInset label
4002
LatexCommand label
4003
name "sec.Verify-advice-read"
4004
 
4005
\end_inset
4006
 
4007
 
4008
\end_layout
4009
 
4010
\begin_layout Standard
4011
Open each downloaded image and do some basic checks before writing into
4012
 cache.
4013
 Disabling can save some CPU cycles if server is trusted to always return
4014
 correct images.
4015
\end_layout
4016
 
4017
\begin_layout Paragraph
4018
Add meters to longitude
4019
\begin_inset CommandInset label
4020
LatexCommand label
4021
name "sec.Add-meters-longitude"
4022
 
4023
\end_inset
4024
 
4025
 
4026
\end_layout
4027
 
4028
\begin_layout Standard
4029
In case the map is moved a little in x direction, you can correct it here.
4030
 Type in the number of meters, the map is moved.
4031
\end_layout
4032
 
4033
\begin_layout Paragraph
4034
Add meters to latitude
4035
\begin_inset CommandInset label
4036
LatexCommand label
4037
name "sec.Add-meters-latitude"
4038
 
4039
\end_inset
4040
 
4041
 
4042
\end_layout
4043
 
4044
\begin_layout Standard
4045
In case the map is moved a little in y direction, you can correct it here.
4046
 Type in the number of meters, the map is moved.
4047
\end_layout
4048
 
4049
\begin_layout Subsubsection
4050
Image coordinates
4051
\begin_inset CommandInset label
4052
LatexCommand label
4053
name "sec.Image-coordinates"
4054
 
4055
\end_inset
4056
 
4057
 
4058
\end_layout
4059
 
4060
\begin_layout Standard
4061
\align center
4062
\begin_inset ERT
4063
status open
4064
 
4065
\begin_layout Plain Layout
4066
 
4067
<screenshot>
4068
\end_layout
4069
 
4070
\begin_layout Plain Layout
4071
 
4072
<screeninfo>Image coordinates</screeninfo>
4073
\end_layout
4074
 
4075
\begin_layout Plain Layout
4076
 
4077
   <mediaobject>
4078
\end_layout
4079
 
4080
\begin_layout Plain Layout
4081
 
4082
      <imageobject>
4083
\end_layout
4084
 
4085
\begin_layout Plain Layout
4086
 
4087
         <imagedata fileref="ConfigureCoordinates.png" format="PNG"></imagedata>
4088
\end_layout
4089
 
4090
\begin_layout Plain Layout
4091
 
4092
      </imageobject>
4093
\end_layout
4094
 
4095
\begin_layout Plain Layout
4096
 
4097
      <textobject>
4098
\end_layout
4099
 
4100
\begin_layout Plain Layout
4101
 
4102
         <phrase>Image coordinates</phrase>
4103
\end_layout
4104
 
4105
\begin_layout Plain Layout
4106
 
4107
      </textobject>
4108
\end_layout
4109
 
4110
\begin_layout Plain Layout
4111
 
4112
   </mediaobject>
4113
\end_layout
4114
 
4115
\begin_layout Plain Layout
4116
 
4117
</screenshot>
4118
\end_layout
4119
 
4120
\end_inset
4121
 
4122
 
4123
\end_layout
4124
 
4125
\begin_layout Standard
4126
In case you've choosen a kind of raster image as your map, this dialog appears.
4127
 Here you can set the corners in geographical format.
4128
 One drawback of raster formats is, that they contain no geographical informatio
4129
n.
4130
 To allow SportWatcher to use such raster images, it must know the dimensions
4131
 of the map.
4132
 An even bigger drawback is the fixed resolution of the map.
4133
 Depending of the magnifier, the map may look blurred or it looks coarse-grained.
4134
 One benefit of such maps is, that they are available offline and they are
4135
 faster than every vector format.
4136
\end_layout
4137
 
4138
\begin_layout Paragraph
4139
Upper left corner
4140
\begin_inset CommandInset label
4141
LatexCommand label
4142
name "sec.Upper-left-corner"
4143
 
4144
\end_inset
4145
 
4146
 
4147
\end_layout
4148
 
4149
\begin_layout Standard
4150
This defines the upper left corner.
4151
 Define this values in the format of the set 
4152
\begin_inset CommandInset ref
4153
LatexCommand ref
4154
name "projection"
4155
reference "sec.Projection"
4156
 
4157
\end_inset
4158
 
4159
.
4160
\end_layout
4161
 
4162
\begin_layout Paragraph
4163
Lower right corner
4164
\begin_inset CommandInset label
4165
LatexCommand label
4166
name "sec.Lower-right-corner"
4167
 
4168
\end_inset
4169
 
4170
 
4171
\end_layout
4172
 
4173
\begin_layout Standard
4174
his defines the lower right corner.
4175
 Define this values in the format of the set 
4176
\begin_inset CommandInset ref
4177
LatexCommand ref
4178
name "projection"
4179
reference "sec.Projection"
4180
 
4181
\end_inset
4182
 
4183
.
4184
\end_layout
4185
 
4186
\begin_layout Paragraph
4187
Projection
4188
\begin_inset CommandInset label
4189
LatexCommand label
4190
name "sec.Projection"
4191
 
4192
\end_inset
4193
 
4194
 
4195
\end_layout
4196
 
4197
\begin_layout Standard
4198
This setting defines the 
4199
\begin_inset CommandInset href
4200
LatexCommand href
4201
name "graphical projection"
4202
target "http://en.wikipedia.org/wiki/Graphical_projection"
4203
 
4204
\end_inset
4205
 
4206
 of the map.
4207
 Graphical projection is a protocol by which an image of an imaginary three-dime
4208
nsional object is projected onto a planar surface without the aid of mathematica
4209
l calculation.
4210
 The projection is achieved by the use of imaginary "projectors".
4211
 The projected, mental image becomes the technician's vision of the desired,
4212
 finished picture.
4213
 By following the protocol the technician may produce the envisioned picture
4214
 on a planar surface such as drawing paper.
4215
 The protocols provide a uniform imaging procedure among people trained
4216
 in technical graphics (mechanical drawing, computer aided design, etc.).
4217
\end_layout
4218
 
4219
\begin_layout Standard
4220
SportWatcher allows to set some of the possible projections.
4221
 Choose the one, used for your map.
4222
\end_layout
4223
 
4224
\begin_layout Section
4225
The menu 
4226
\begin_inset ERT
4227
status open
4228
 
4229
\begin_layout Plain Layout
4230
 
4231
<guimenu>
4232
\end_layout
4233
 
4234
\end_inset
4235
 
4236
Help
4237
\begin_inset ERT
4238
status open
4239
 
4240
\begin_layout Plain Layout
4241
 
4242
</guimenu>
4243
\end_layout
4244
 
4245
\end_inset
4246
 
4247
 
4248
\begin_inset CommandInset label
4249
LatexCommand label
4250
name "sec.The-menu-Help"
4251
 
4252
\end_inset
4253
 
4254
 
4255
\end_layout
4256
 
4257
\begin_layout Standard
4258
\begin_inset ERT
4259
status open
4260
 
4261
\begin_layout Plain Layout
4262
 
4263
&help.menu.documentation;
4264
\end_layout
4265
 
4266
\end_inset
4267
 
4268
 
4269
\end_layout
4270
 
4271
\begin_layout Chapter
4272
Display a map underneath a track
4273
\begin_inset CommandInset label
4274
LatexCommand label
4275
name "cha.Display-a-map"
4276
 
4277
\end_inset
4278
 
4279
 
4280
\end_layout
4281
 
4282
\begin_layout Standard
4283
SportWatcher is able to display a map underneath a track.
4284
 A track consists of several messure points who are connected with a line.
4285
 It represents the path you were running or biking.
4286
 SportWatcher supports differnt sources for maps.
4287
 Setting the map source (look at 
4288
\begin_inset CommandInset ref
4289
LatexCommand ref
4290
reference "sec.The-menu-ConfSPW"
4291
 
4292
\end_inset
4293
 
4294
) is the precondition to get a map.
4295
 Another precondition is the availability of GPS coordinates.
4296
 If you train in the open, the Garmin Forerunner will record the GPS coordinates.
4297
\end_layout
4298
 
4299
\begin_layout Standard
4300
SportWatcher paints in a first step the map and then draws the track over
4301
 it.
4302
 If you've set everything correct, the track should fit perfect on the map.
4303
\end_layout
4304
 
4305
\begin_layout Section
4306
WMS Server
4307
\begin_inset CommandInset label
4308
LatexCommand label
4309
name "sec.WMS-Server"
4310
 
4311
\end_inset
4312
 
4313
 
4314
\end_layout
4315
 
4316
\begin_layout Standard
4317
The 
4318
\begin_inset CommandInset href
4319
LatexCommand href
4320
name "Web Map Service"
4321
target "http://en.wikipedia.org/wiki/Web_Map_Service"
4322
 
4323
\end_inset
4324
 
4325
 (WMS) is an interface to request parts of a map.
4326
 Such an interface could also be called a WEB service.
4327
 The specification was designed by the 
4328
\begin_inset CommandInset href
4329
LatexCommand href
4330
name "Open Geospatial Consortium"
4331
target "http://en.wikipedia.org/wiki/Open_Geospatial_Consortium"
4332
 
4333
\end_inset
4334
 
4335
 (OGC).
4336
 It describes the parameters needed for a request.
4337
 It also defines, how a WMS server should generate a map out of the request.
4338
\end_layout
4339
 
4340
\begin_layout Standard
4341
SportWatcher supports the access to any WMS server out of the box.
4342
 Just choose WMS server as the source for maps and set everything necessary
4343
 as described at 
4344
\begin_inset CommandInset ref
4345
LatexCommand ref
4346
reference "sec.WMS"
4347
 
4348
\end_inset
4349
 
4350
.
4351
\end_layout
4352
 
4353
\begin_layout Section
4354
Map out of a raster image
4355
\begin_inset CommandInset label
4356
LatexCommand label
4357
name "sec.Map-out-of"
4358
 
4359
\end_inset
4360
 
4361
 
4362
\end_layout
4363
 
4364
\begin_layout Standard
4365
In case you have a picture representing a map, SportWatcher needs geographical
4366
 reference points.
4367
 Formats like PNG (Portable Network Graphics), BMP (Bitmap), GIF (Graphics
4368
 Image Format), and so on, are called raster images.
4369
 First, you have to find a map of the wanted area in the wanted resolution.
4370
 Once this is done, you must find out the geodetic date of th map.
4371
 This may be difficult, but is absolutely needed! Once this is also done,
4372
 you should know the upper left and the lower right corner in geographical
4373
 coordinates.
4374
 With all this informations, you can start to enter the needed parameters.
4375
 Part 
4376
\begin_inset CommandInset ref
4377
LatexCommand ref
4378
reference "sec.Map-file"
4379
 
4380
\end_inset
4381
 
4382
 let you define the path to the map and the file name of the map.
4383
 With 
4384
\begin_inset CommandInset ref
4385
LatexCommand ref
4386
reference "sec.Map-type"
4387
 
4388
\end_inset
4389
 
4390
 you can define the type of the map.
4391
 Now most of the work is done.
4392
 Now only the definations of the corners is left.
4393
 Look at 
4394
\begin_inset CommandInset ref
4395
LatexCommand ref
4396
reference "sec.Image-coordinates"
4397
 
4398
\end_inset
4399
 
4400
 for an explanation of how to do that.
4401
 Once this is done, SportWatcher should display a map underneath the track.
4402
 The map must not have exactly the size of the track.
4403
 In fact it should be bigger (maybe a lot bigger).
4404
 I recomend to find a map about your whole training area.
4405
 SportWatcher will cut the needed piece and stretch and push it to fit into
4406
 the given drawing space.
4407
\end_layout
4408
 
4409
\begin_layout Section
4410
Shape files
4411
\begin_inset CommandInset label
4412
LatexCommand label
4413
name "sec.Shape-files"
4414
 
4415
\end_inset
4416
 
4417
 
4418
\end_layout
4419
 
4420
\begin_layout Standard
4421
The ESRI Shapefile or simply a shapefile is a popular geospatial vector
4422
 data format for geographic information systems software.
4423
 It is developed and regulated by 
4424
\begin_inset CommandInset href
4425
LatexCommand href
4426
name "ESRI"
4427
target "http://en.wikipedia.org/wiki/ESRI"
4428
 
4429
\end_inset
4430
 
4431
 as a (mostly) open specification for data interoperability among ESRI and
4432
 other software products.
4433
 A "shapefile" commonly refers to a collection of files with extensions
4434
 of 
4435
\begin_inset ERT
4436
status open
4437
 
4438
\begin_layout Plain Layout
4439
 
4440
<literal role="extension">
4441
\end_layout
4442
 
4443
\end_inset
4444
 
4445
.shp
4446
\begin_inset ERT
4447
status open
4448
 
4449
\begin_layout Plain Layout
4450
 
4451
</literal>
4452
\end_layout
4453
 
4454
\end_inset
4455
 
4456
, 
4457
\begin_inset ERT
4458
status open
4459
 
4460
\begin_layout Plain Layout
4461
 
4462
<literal role="extension">
4463
\end_layout
4464
 
4465
\end_inset
4466
 
4467
.shx
4468
\begin_inset ERT
4469
status open
4470
 
4471
\begin_layout Plain Layout
4472
 
4473
</literal>
4474
\end_layout
4475
 
4476
\end_inset
4477
 
4478
, 
4479
\begin_inset ERT
4480
status open
4481
 
4482
\begin_layout Plain Layout
4483
 
4484
<literal role="extension">
4485
\end_layout
4486
 
4487
\end_inset
4488
 
4489
.dbf
4490
\begin_inset ERT
4491
status open
4492
 
4493
\begin_layout Plain Layout
4494
 
4495
</literal>
4496
\end_layout
4497
 
4498
\end_inset
4499
 
4500
, and other extensions on a common prefix name (e.g., "lakes.*").
4501
 The actual shapefile relates specifically to files with the 
4502
\begin_inset ERT
4503
status open
4504
 
4505
\begin_layout Plain Layout
4506
 
4507
<literal role="extension">
4508
\end_layout
4509
 
4510
\end_inset
4511
 
4512
.shp
4513
\begin_inset ERT
4514
status open
4515
 
4516
\begin_layout Plain Layout
4517
 
4518
</literal>
4519
\end_layout
4520
 
4521
\end_inset
4522
 
4523
 extension, however this file alone is incomplete for distribution, as the
4524
 other supporting files are required.
4525
\end_layout
4526
 
4527
\begin_layout Standard
4528
\begin_inset ERT
4529
status open
4530
 
4531
\begin_layout Plain Layout
4532
 
4533
<note><para>This format is currently not implemented!</para></note>
4534
\end_layout
4535
 
4536
\end_inset
4537
 
4538
 
4539
\end_layout
4540
 
4541
\begin_layout Section
4542
PostGIS database
4543
\begin_inset CommandInset label
4544
LatexCommand label
4545
name "sec.PostGIS-database"
4546
 
4547
\end_inset
4548
 
4549
 
4550
\end_layout
4551
 
4552
\begin_layout Standard
4553
PostGIS (
4554
\emph on
4555
/post'-jis/
4556
\emph default
4557
) is an open source software program that adds support for geographic objects
4558
 to the PostgreSQL object-relational database.
4559
 PostGIS follows the Simple Features for SQL specification from the Open
4560
 Geospatial Consortium.
4561
 As such, PostGIS includes:
4562
\end_layout
4563
 
4564
\begin_layout Itemize
4565
Geometry types for points, linestrings, polygons, multipoints, multilinestrings,
4566
 multipolygons and geometry collections.
4567
\end_layout
4568
 
4569
\begin_layout Itemize
4570
Spatial predicates for determining the interactions of geometries using
4571
 the 3x3 Egenhofer matrix (provided by GEOS).
4572
\end_layout
4573
 
4574
\begin_layout Itemize
4575
Spatial operators for determining geospatial measurements like area, distance,
4576
 length and perimeter.
4577
\end_layout
4578
 
4579
\begin_layout Itemize
4580
Spatial operators for determining geospatial set operations, like union,
4581
 difference, symmetric difference and buffers (provided by GEOS).
4582
\end_layout
4583
 
4584
\begin_layout Itemize
4585
R−tree spatial indexes for high speed spatial querying.
4586
\end_layout
4587
 
4588
\begin_layout Itemize
4589
Index selectivity support, to provide high performance query plans for mixed
4590
 spatial/non-spatial queries.
4591
\end_layout
4592
 
4593
\begin_layout Standard
4594
The PostGIS implementation is based on "light-weight" geometries and indexes
4595
 optimized to reduce disk and memory footprint.
4596
 Using light-weight geometries helps servers increase the amount of data
4597
 migrated up from physical disk storage into RAM, improving query performance
4598
 substantially.
4599
\end_layout
4600
 
4601
\begin_layout Standard
4602
\begin_inset ERT
4603
status open
4604
 
4605
\begin_layout Plain Layout
4606
 
4607
<note><para>This function is currently not implemented!</para></note>
4608
\end_layout
4609
 
4610
\end_inset
4611
 
4612
 
4613
\end_layout
4614
 
4615
\begin_layout Chapter
4616
Credits
4617
\begin_inset CommandInset label
4618
LatexCommand label
4619
name "cha.Credits"
4620
 
4621
\end_inset
4622
 
4623
 
4624
\end_layout
4625
 
4626
\begin_layout Section
4627
Credits and License
4628
\begin_inset CommandInset label
4629
LatexCommand label
4630
name "sec.Danksagung-und-Lizenz"
4631
 
4632
\end_inset
4633
 
4634
 
4635
\end_layout
4636
 
4637
\begin_layout Standard
4638
\begin_inset ERT
4639
status open
4640
 
4641
\begin_layout Plain Layout
4642
 
4643
<para>&sportwatcher;</para>
4644
\end_layout
4645
 
4646
\end_inset
4647
 
4648
 
4649
\end_layout
4650
 
4651
\begin_layout Standard
4652
Program 
4653
\begin_inset ERT
4654
status open
4655
 
4656
\begin_layout Plain Layout
4657
 
4658
<trademark class="copyright">
4659
\end_layout
4660
 
4661
\end_inset
4662
 
4663
Copyright 
4664
\begin_inset ERT
4665
status open
4666
 
4667
\begin_layout Plain Layout
4668
 
4669
</trademark>
4670
\end_layout
4671
 
4672
\end_inset
4673
 
4674
 2007 - 2009 by Andreas Theofilu 
4675
\begin_inset ERT
4676
status open
4677
 
4678
\begin_layout Plain Layout
4679
 
4680
<email>
4681
\end_layout
4682
 
4683
\end_inset
4684
 
4685
andreas@theosys.at
4686
\begin_inset ERT
4687
status open
4688
 
4689
\begin_layout Plain Layout
4690
 
4691
</email>
4692
\end_layout
4693
 
4694
\end_inset
4695
 
4696
 
4697
\end_layout
4698
 
4699
\begin_layout Standard
4700
Based on 
4701
\begin_inset ERT
4702
status open
4703
 
4704
\begin_layout Plain Layout
4705
 
4706
<command>
4707
\end_layout
4708
 
4709
\end_inset
4710
 
4711
garmin-tools
4712
\begin_inset ERT
4713
status open
4714
 
4715
\begin_layout Plain Layout
4716
 
4717
</command>
4718
\end_layout
4719
 
4720
\end_inset
4721
 
4722
 from Dave Bailey 
4723
\begin_inset ERT
4724
status open
4725
 
4726
\begin_layout Plain Layout
4727
 
4728
<email>
4729
\end_layout
4730
 
4731
\end_inset
4732
 
4733
dave@daveb.net
4734
\begin_inset ERT
4735
status open
4736
 
4737
\begin_layout Plain Layout
4738
 
4739
</email>
4740
\end_layout
4741
 
4742
\end_inset
4743
 
4744
 
4745
\end_layout
4746
 
4747
\begin_layout Standard
4748
Based on 
4749
\begin_inset ERT
4750
status open
4751
 
4752
\begin_layout Plain Layout
4753
 
4754
<command>
4755
\end_layout
4756
 
4757
\end_inset
4758
 
4759
GANT
4760
\begin_inset ERT
4761
status open
4762
 
4763
\begin_layout Plain Layout
4764
 
4765
</command>
4766
\end_layout
4767
 
4768
\end_inset
4769
 
4770
 from Paul 
4771
\begin_inset ERT
4772
status open
4773
 
4774
\begin_layout Plain Layout
4775
 
4776
<email>
4777
\end_layout
4778
 
4779
\end_inset
4780
 
4781
paul@ant.sbrk.co.uk
4782
\begin_inset ERT
4783
status open
4784
 
4785
\begin_layout Plain Layout
4786
 
4787
</email>
4788
\end_layout
4789
 
4790
\end_inset
4791
 
4792
 
4793
\end_layout
4794
 
4795
\begin_layout Standard
4796
\begin_inset ERT
4797
status open
4798
 
4799
\begin_layout Plain Layout
4800
 
4801
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
4802
\end_layout
4803
 
4804
\begin_layout Plain Layout
4805
 
4806
&underFDL;               <!-- FDL: do not remove -->
4807
\end_layout
4808
 
4809
\begin_layout Plain Layout
4810
 
4811
&underGPL;               <!-- GPL License -->
4812
\end_layout
4813
 
4814
\end_inset
4815
 
4816
 
4817
\end_layout
4818
 
4819
\end_body
4820
\end_document