GKK
der GPX KURVEN-KOEFFIZIENTEN-RECHNER
Version 0.7 vom 21.7.2010
ALLGEMEINES
GKK ist ein kommandozeilengesteuertes Programm, mit dem Sie sich zu einer GPX-Route
einen Kurvenkoeffizienten errechnen lassen k�nnen.
Hintergrund ist die �berlegung, dass eine Route anhand Ihres Kurvenkoeffizienten bez�glich
ihrer Eignung zum Motorradfahren beurteilt, sozusagen der �Spa�faktor� der Route berechnet
werden kann (Immer vorausgesetzt, dass der Fahrer an Kurven Spa� hat). Als groben
Anhaltspunkt kann man sagen, dass Routen mit GKK<100 keine Motorradrouten sind, GKK
>200 k�nnen als gute Touren gelten, Touren �ber 300 sind geniale Strecken. Hier ist wiederum
zu beachten, dass l�ngere Anfahrten den GKK-Wert senken, sofern sie nicht als eigene Tracks
definiert wurden und mit der Option �s getrennt ausgewertet werden.
Zur Vergleichbarkeit der Ergebnisse macht es Sinn, das GPS auf ein Aufzeichnungsintervall von
1 Sekunde zu setzen. GKKs, die aus Aufzeichnungen mit unterschiedlichen
Aufzeichnungsintervallen gewonnen wurden, sind nur begrenzt vergleichbar.
Download
gkk ist als Perl-Skript und als Windows-Exe-Datei verf�gbar und kann hier
(http://sourceforge.net/projects/gkk/files/) heruntergeladen werden.
Dokumentation
Die Dokumentation kann als PDF-Dokument ebenfalls auf der Downloadseite herutnergeladen werden.
Feedback
�ber R�ckmeldungen und Verbesserungsvorschl�ge an die Mailadresse q-tools AT arcor.de (AT
durch @ ersetzen) freue ich mich.
Roland
STARTEN VON GKK
gkk ist als Perl-Skript und als Windows-Exe-Datei verf�gbar und kann von der Adresse
http://sourceforge.net/projects/gkk/files/ heruntergeladen werden. Danach in ein Verzeichnis
nach Wahl entpacken.
Die Anwendung wird wie folgt gestartet:
1. Ggf. Shell Starten (In Windows cmd.exe)
2.a gkk.pl [Dateiname.gpx] ausf�hren
gkk.pl setzt eine Perl-Installation voraus
(z.B. von http://www.activestate.com/activeperl)
oder unter Windows:
2.b gkk.exe [Dateiname.gpx] ausf�hren
Das Ergebnis sieht dann wie folgt aus:
c:\ >gkk.pl testfile.gpx
GKK -ein GPX KurvenKoeffizientenrechner
Vorgaben:
Ausgewertetes XML-Tag: trkpt
Genauigkeit GPS wird angenommen mit +/-3 Meter
Ergebnisse
testfile.gpx , 9 km, 3049 Grad, GKK: 292 Grad/km
Das Ergebnis enth�lt den Namen der ausgewerteten Datei, die L�nge der Strecke sowie die
Summe der Winkelgrade der Tour und den errechneten GKK in Grad pro Kilometer.
OPTIONEN
GKK hat mehrere Optionen, die hier aufgef�hrt sind:
usage: gkk.pl gpx-file|*.gpx [-v] [-tag=] [-abw=] [-s] [-nld] [-gpxout] [-gpxextout]
[-kmlout] [-kmzout] [-maxrtlen=]
-v -verbose
-tag= -Name des Trackpoint-Tags, der in der GPX-Datei gesucht wird
-abw= -Genauigkeitsannahme des GPS in Metern. (=3 Meter)
-s -SingleTrk. Mehrere Tracks in einer GPX-Datei werden getrennt ausgewertet
-nld -NoLongDistance. Grosse Tracklaengen werden ignoriert
-nldlen=x -Laenge NoLongDistance. Tracklaenge, ab der -nld greift. (=2 km)
-gpxout -Datei wird neu geschrieben mit zusaetzlichem Track, der die
verwendeten Punkte der Kurvenberechnung enthaelt. Die Hoehenangaben
der Trackpoints enthalten den Richtungswinkel (gkk-[filename].gpx)
-gpxextout -Datei wird geschrieben mit einem Track, der die
verwendeten Punkte der Kurvenberechnung mit erweiterten GKK-Daten
enthaelt (gkkext-[filename].gpx)
-kmlout -KML-Datei mit Farbzuordnung zu Kurven wird erstellt (gkk-[filename].kml)
-kmzout -KML-und KMZ-Datei mit Farbzuordnung zu Kurven wird erstellt (gkk[
filename].kmz)
-maxrtlen=x -Laenge in km, ab der die Teilrouten geteilt werden. (=10 km)
Die Optionen werden im Folgenden n�her beschrieben:
FEINTUNING VON GKK
gpx-file*.gpx|
Dateiname der GPX-Datei oder Platzhalter *.gpx, mit oder ohne Pfadangabe
Beispiele:
gkk.exe datei1.xml
gkk.exe c:\MeineDateien\*.gpx
-verbose
Erweiterte Ausgabe mit zus�tzlichen Informationen
Ergebnisse
Datei:
test.GPX
Info: Trk 2053 hat grosse Laenge: 2.5 km
Info: Trk 4259 hat grosse Laenge: 5.8 km
Info: Trk 5837 hat grosse Laenge: 3.4 km
Anzahl Punkte: 13676, davon beruecksichtigt: 11605 (84 %)
Kurvensumme der Tour: 274373 Grad auf einer Laenge von 1926 km
GPX Kurvenkoeffizient GKK: 142 Grad/km
Aufteilung in Teilrouten >= 10 km:
Kat 1 gkk<100: 898km -47 % (D: 36Grad/km)
Kat 2 gkk<200: 515km -27 % (D: 141Grad/km)
Kat 3 gkk<400: 402km -21 % (D: 289Grad/km)
Kat 4 gkk>400: 111km -6 % (D: 479Grad/km)
-tag=
Alternativer Trackpoint-Tag, der in der GPX-Datei ausgewertet wird, Standard ist trkpt
-abw=
Abweichungen innerhalb der Genauigkeitsangabe von +/-3 Metern werden als Ungenauigkeit
des GPS gewertet und nicht als Kurven berechnet. Bei sehr ungenauen Punktwerten muss �abw
auf einen h�heren Wert gesetzt werden, um Artefakte zu vermeiden. Andererseits werden bei
einem hohen �abw-Wert m�glicherweise Kurven als GPS-Ungenauigkeit interpretiert, der
resultierende GKK-Wert wird also geringer.
-s -SingleTrk.
Wenn in einer GPX-Datei mehrere Tracks vorhanden sind, so werden diese getrennt ausgewertet
und f�r jeden Track ein eigener GKK erstellt.
-nld
(NoLongDistance) Grosse Trackl�ngen werden ignoriert Hiermit k�nnen Teile eines Tracks
ohne aufgezeichnete Punkte (z.B. bei tempor�ren Ausfall des GPS) von der Bewertung
ausgeschlossen werden, um eine Verf�lschung des Wertes zu vermeiden.
-nldlen=x
(L�ngenvorgabe f�r NoLongDistance). Distanz zwischen zwei Trackpunkten, ab der
Trackabschnitte als auff�llig gro�e Distanzen behandelt werden, siehe -nld. Standard ist zwei
Kilometer. Bei Angabe der Option �v wird eine Info ausgegeben, wenn solche Trackabschnitte
bestehen. Bei der Option �nld werden diese Trackabschnitte von der Berechnung
ausgeschlossen.
AUSGABE EINER NEUEN GPX -DATEI
-gpxout
Datei wird neu geschrieben mit zus�tzlichem Track, der die verwendeten Punkte der
Kurvenberechnung enth�lt. (gkk-[filename].gpx) �ber diese Option kann die Zuverl�ssigkeit der
GKK-Parameter gepr�ft werden. Beim Vergleich des urspr�nglichem mit dem neu
geschriebenen Track (zum Beispiel mit GTA GPS-Track-Analyser) kann optisch �berpr�ft
werden, ob GKK verl�ssliche Vereinfachungen der Route getroffen hat.
-gpxextout
Eine neue GPX-Datei wird geschrieben mit einem Track, der die verwendeten Punkte der
Kurvenberechnung mit erweiterten GKK-Daten enth�lt (gkkext-[filename].gpx). Die neue GPX-
Datei enth�lt zu jedem Trackpoint im Tag Extensions die folgenden zus�tzlichen Informationen:
<trkpt lat="46.5419316" lon="11.8040583">
<time>2010-06-11T13:03:17Z</time>
<extensions>
<gpxgkk:gkkExtension>
<gpxgkk:direction>46</gpxgkk:direction>
<gpxgkk:length>0.012</gpxgkk:length>
<gpxgkk:kat>4</gpxgkk:kat>
</gpxgkk:gkkExtension>
</extensions>
</trkpt>
Das Tag direction enth�lt die Richtung in Grad (-180 bis +180)
Das Tag length enth�lt die L�nge zwischen zwei Trackpoints in km
Das Tag kat enth�lt die Kurvenkategorie der Teilroute (siehe dazu auch �kmlout und �maxrtlen)
Die Datei kann zur weiteren Verarbeitung/Auswertung genutzt werden. Die zugeh�rige XSD-
Datei mit den GKK-Erweiterungen liegt unter:
http://gkk.sourceforge.net/GpxExtensions/1.0/gpx-gkk.xsd
ERSTELLEN EINER KML -DATEI MIT FARBINFORMATIONEN
-kmlout
Eine KML-Datei mit Farbzuordnung zu Kurven wird erstellt (gkk-[filename].kml) Der Track
wird dazu zun�chst in Teilbereiche der L�nge maxrtlen unterteilt und f�r jeden Teilbereich wird
ein Kurvenkoeffizient erstellt. Dieser wird dann in vier Kategorien unterteilt:
GKK bis 100: Nicht kurvig, Kategorie 1
GKK bis 200: Wenig kurvig, Kategorie 2
GKK bis 400: Kurvig, Kategorie 3
GKK �ber 400: sehr kurvig, Kategorie 4
Angrenzende Teilbereiche gleicher Kategorie werden anschlie�end wieder zu einem Track
zusammengefasst, um bei der Anzeige m�glichst wenige Tracks darstellen zu m�ssen.
Jeder Kategorie wird eine Farbe zugeordnet und eine entsprechende KML-Datei wird
ausgegeben.
-kmzout
Die oben beschriebene KML-Datei (siehe �kmlout) wird gepackt und eine KMZ-Datei erstellt.
KMZ-Dateien sind gezippte KML-Dateien, die als Grundlage f�r die Anzeige in maps.google.de
verwendet werden.
-maxrtlen=x
L�nge in km, f�r die bei Nutzung der option �kmlout einzelne GKK-Werte berechnet werden.
Standard ist 10 km. Kleinere Werte ergeben mehr Teilrouten und beeinflussen ggf. die Anzeige in
GoogleMaps negativ. Gro�e Werte verallgemeinern st�rker. Die Angabe hat auch Auswirkungen
auf die Ausgabe der Routenanteile pro Kategorie bei Nutzung der Option �v
GPL
Dieses Programm ist freie Software. Sie k�nnen es unter den Bedingungen der GNU General
Public License Version 2, wie von der Free Software Foundation ver�ffentlicht, weitergeben
und/oder modifizieren. Die Ver�ffentlichung dieses Programms erfolgt in der Hoffnung, dass es
Ihnen von Nutzen sein wird, aber OHNE IRGENDEINE GARANTIE, sogar ohne die
implizite Garantie der MARKTREIFE oder der VERWENDBARKEIT F�R EINEN
BESTIMMTEN ZWECK. Details finden Sie in der GNU General Public License, siehe
http://www.gnu.org
This program is free software; you can redistribute it and/or modify it under the terms of the
GNU General Public License version 2 as published by the Free Software Foundation. See the
GNU General Public License for more details.
Homepage: http://gkk.sourceforge.net/
Stand: August 2010