From 2e23614379ad2351d7e1e9c1d54cdea7d43eacb9 Mon Sep 17 00:00:00 2001 From: Johannes Hofmann Date: Sun, 6 Jul 2008 16:09:01 +0200 Subject: README updates --- README | 39 +++++++++++++++++++-------------------- 1 file changed, 19 insertions(+), 20 deletions(-) (limited to 'README') diff --git a/README b/README index 91fde2e..025e0fb 100644 --- a/README +++ b/README @@ -1,5 +1,5 @@ Description -=========== +----------- 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 @@ -11,7 +11,7 @@ warned: It is pretty difficult to find the right parameters for a given picture manually. Requirements -============ +------------ * fltk-1.1.x * libtiff * libjpeg @@ -20,11 +20,11 @@ Requirements * gipfel works on UNIX-like systems (e.g. Linux, *BSD and probably others) Installation -============ +------------ * Unpack the tar file and run `./configure; make; make install` Running -======= +------- To start gipfel, enter gipfel @@ -56,7 +56,7 @@ You may also want to have a look at the screen video at 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: @@ -82,7 +82,7 @@ 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 @@ -95,7 +95,7 @@ of the way points from the current view point and the scale value. You can also modify the width using the "Track Width" slider. 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. @@ -103,7 +103,7 @@ If you open an image containing gipfel image parameters, they are automatcally set. Hidden Object Detection -======================= +----------------------- gipfel tries to identify objects in its database, that are hidden by others. This is done by assuming that every object/peak has the form of a cone with a fixed steapness. If such imaginary cone would hide the view to a @@ -113,15 +113,15 @@ the Option->Show Hidden menu entry. Hidden objects and hidden GPS way points are displayed in blue. Refraction -========== +---------- Refraction caused by temperature and density gardients in the atmosphere is taken into account according to the approximation described by Tom Chester in: -http://tchester.org/sgm/analysis/peaks/refraction_calculation.html + under the assumption of a temperature change of 6.5°C per 1000m and a temperature T0 at view point level of 10°C. Stitching -========= +--------- If you have multiple images from the same viewpoint referenced with gipfel you can stitch them together to form a panorama image. For stitching the input images must all have been correctly referenced @@ -137,8 +137,8 @@ Use the multiple TIFF option for blending the result with enblend . The width and height of the result images can be adjusted with the -w and -h options. -You can use the -b switch to enable bilinear interpolation, which -gives better results but is a bit slower. +You can use the -b switch to enable bicubic interpolation, which +gives smoother results but is a bit slower. The nice thing about stitching is that gipfel uses the same code that it already had for positioning mountains on the pictures. @@ -153,14 +153,14 @@ If you want to open a stitched image in gipfel to locate the mountains on it, don't forget to choose Panoramic Projection! Exif Data -========= +--------- gipfel tries to get useful information from the exif data of the input image. It uses the "Focal Length in 35mm Film" and the "GPS Longitude", "GPS Latitude", and "GPS Height" parameters, if they exist. Lens Distortion -=============== +--------------- Typical lenses especially wide-angle lenses diverge from the optimal rectilinear projection. gipfel can now partly correct the resulting errors. @@ -183,7 +183,7 @@ distortion parameters per image. Distortion correction is also used when stitching panorama images. 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, @@ -196,7 +196,7 @@ Troubleshooting the southern hemisphere, but I would appreciate any feedback about it. Acknowledgements -================ +---------------- Thanks to the guys from for their public GPS database. Also have look at their other site . @@ -206,9 +206,8 @@ I also want to thank my brother Martin 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) +Johannes Hofmann, -- cgit v1.2.3