From cad19b81063c32097165aea1f8af7adfe13f77a4 Mon Sep 17 00:00:00 2001 From: Johannes Hofmann Date: Mon, 31 Oct 2005 22:28:01 +0200 Subject: update README --- README | 71 +++++++++++++++++++++++++++++++++++++----------------------------- 1 file changed, 40 insertions(+), 31 deletions(-) (limited to 'README') 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: - -,,,,, - - and 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: + +,,,,, + + and 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: ,, + 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 -- cgit v1.2.3