====== gipfel ====== 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 on the picture, gipfel can compute all parameters needed to compute the positions of other mountains on the picture. Additionally, gipfel can try to guess these parameter if only one mountain is known on the picture. In this case, a few other peaks need to be marked, but it is not necassary to know their names. gipfel can also be used to play around with the parameters manually. But be warned: It is pretty difficult to find the right parameters for a given picture manually. Requirements ============ - gipfel works on UNIX-like system (e.g. Linux, *BSD and probably others). - You need fltk-1.1.x from www.fltk.org. - You need the ccmath library (http://freshmeat.net/projects/ccmath/). Installation ============ - Unpack the tar file and run ./configure; make; make install Running ======= To start gipfel, enter gipfel where is the actual picture in JPEG format. You should now see a control window and the actual picture. Additionally a "Choose Viewpoint" window should pop up, where you can search for the viewpoint from which the picture was taken. Select a viewpoint and click "Ok". You can now use the controls in the control window to modify the view parameters. These are: - View direction - Nick angle - Tilt angle - Scale - Visibility Play around with these parameters, until you see the names of one or two mountains, which you already recognize on the picture. Now click on the small cross at the left of the name to mark it and drag them to the position of the mountain on the picture. The marked mountains should have a red flag. If you have positioned two mountains, you can now click on the "comp" button in the control window. If you have only marked one mountain, you need to mark other peaks on the picture using the green flags which you find at the center of the picture. Make sure, that the one marked mountain has a red flag containing a "1" if it has a "2" in its flag, just keep clicking on it until it changes to a "1". 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 ========== Once you have determined the right parameters using the procedure described above, you can load GPS tracks and display them on the picture. Use the File->Load Track menu item. GPS tracks should be text files containing one line per waypoint. Each line should be of the form: ,, Loading and Saving Images ========================= 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 =============== - Obviously gipfel can only be as good as its input data. If there is no data about the mountains on your picture, you are out of luck... But as the data file format is pretty simple and GPS receivers are common, you can build up your own datafile. - gipfel only works with full normal unmodified pictures taken with a non-distorting standard objektive. If you have a panorama picture, you might want to try the experimental "Panoramic Projection" support (see "Options" menu). - 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 ======================= If you are interested in a commercial application of the methods used in gipfel, feel free to contact me. 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/. 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 suggestions and the discussions. DISCLAIMER ========== gipfel must NOT be used for real navigation. You should not rely on the results of gipfel. Johannes Hofmann (Johannes.Hofmann@gmx.de) Oct 31, 2005