summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorJohannes Hofmann <Johannes.Hofmann@gmx.de>2005-10-31 22:28:01 +0200
committerJohannes Hofmann <Johannes.Hofmann@gmx.de>2005-10-31 22:28:01 +0200
commitcad19b81063c32097165aea1f8af7adfe13f77a4 (patch)
tree2a37fbdb146806c357c3239d14535dab53ba35e3 /README
parentddfb0927f6b01da55bd9e5fb7ccdad82920ed7d2 (diff)
update README
Diffstat (limited to 'README')
-rw-r--r--README71
1 files changed, 40 insertions, 31 deletions
diff --git a/README b/README
index 46d737c..ceb2a11 100644
--- a/README
+++ b/README
@@ -2,7 +2,7 @@
gipfel
======
-gipfel is a tool to find the names of mountains or points of interest
+gipfel helps to find the names of mountains or points of interest
on a picture.
It uses a database containing names and GPS data. With the given viewpoint
(the point from which the picture was taken) and two known mountains
@@ -28,32 +28,6 @@ Installation
- Unpack the tar file and run ./configure; make; make install
-The Data File
-=============
-As stated before, gipfel needs GPS input data. The input data must be
-an ASCII file with one line per mountain / point of interest.
-Each line must contain the following values separated by a comma:
-
-<SHORTNAME>,<NAME>,<DESCRIPTION>,<LATITUDE>,<LONGITUDE>,<HEIGHT>
-
-<SHORTNAME> and <DESCRIPTION> may be left empty.
-
-The following line is a valid example:
-SMTSBG,Simetsberg,,47.56617,11.25358,1836
-
-Fortunately, there is a great website http://www.alpin-koordinaten.de, where
-you can download a suitable file containg quite a lot of data mostly
-concerning the alps:
-Click on the "Suchen" button and the click on the diskette symbol below
-the first table then select "Fugawi 3 TXT" format and click on "Download".
-
-Obviously you can easily add your own entries to the data file or add them
-to the database at http://www.alpin-koordinaten.de.
-
-Thanks to the kind permission of the owners of www.alpin-koordinaten.de, the
-standard gipfel tarball now includes a default datafile generated by
-www.alpin-koordinaten.de
-
Running
=======
@@ -90,6 +64,38 @@ Then click on the "guess" button. If the result is disapointing, try to adjust
the visibility parameter as only visible mountains are taken into account
during the "guess"-process.
+You may also want to have a look at the screen video at
+http://www.ecademix.com/JohannesHofmann/gipfel.avi
+for an example session.
+
+
+The Data File
+=============
+As stated before, gipfel needs GPS input data. The input data must be
+an ASCII file with one line per mountain / point of interest.
+Each line must contain the following values separated by a comma:
+
+<SHORTNAME>,<NAME>,<DESCRIPTION>,<LATITUDE>,<LONGITUDE>,<HEIGHT>
+
+<SHORTNAME> and <DESCRIPTION> may be left empty.
+
+The following line is a valid example:
+SMTSBG,Simetsberg,,47.56617,11.25358,1836
+
+Fortunately, there is a great website http://www.alpin-koordinaten.de, where
+you can download a suitable file containg quite a lot of data mostly
+concerning the alps:
+Click on the "Suchen" button and the click on the diskette symbol below
+the first table then select "Fugawi 3 TXT" format and click on "Download".
+
+Obviously you can easily add your own entries to the data file or add them
+to the database at http://www.alpin-koordinaten.de.
+
+Thanks to the kind permission of the owners of www.alpin-koordinaten.de, the
+standard gipfel tarball now includes a default datafile generated by
+www.alpin-koordinaten.de
+
+
GPS Tracks
==========
@@ -100,6 +106,7 @@ one line per waypoint. Each line should be of the form:
<LATITUDE>,<LONGITUDE>,<HEIGHT>
+
Loading and Saving Images
=========================
@@ -107,6 +114,7 @@ gipfel allows to save the image paramters in the comment section of
the JPEG image. Use the File->Save Image menu item.
Note, that in the saved image all previous JPEG comments are removed.
+
Troubleshooting
===============
@@ -123,6 +131,7 @@ might want to try the experimental "Panoramic Projection" support (see
- I have no idea, whether gipfel works correctly on pictures taken on
the southern hemisphere, but I would appreciate any feedback about it.
+
Commercial Applications
=======================
@@ -135,13 +144,13 @@ Acknowledgements
Thanks to the guys from http://www.alpin-koordinaten.de for their public
GPS database.
-Thanks to Carsten Clasohm for his great gallery at http://www.clasohm.com/.
+thanks to Carsten Clasohm for his great gallery at http://www.clasohm.com/.
His pictures are good test cases for gipfel!
Also have look at their other site http://www.alpen-panoramen.de/ !
Thanks to George J. Gesslein II for his great program mathomatic
(http://www.mathomatic.com/) which helped a lot to handle and simplify large
-expressions.
-I also want to thank my brother Martin Hofmann for his tips and the
+Expressions.
+I also want to thank my brother Martin Hofmann for his suggestions and the
discussions.
@@ -153,4 +162,4 @@ results of gipfel.
Johannes Hofmann
(Johannes.Hofmann@gmx.de)
-Sep 12, 2005
+Oct 31, 2005