PHYGHTMAP

Section: User Commands (1)
Updated: December 2011
Index
 

NAME

phyghtmap - NASA SRTM -> OSM xml translator  

SYNOPSIS

phyghtmap [options] [<hgt file>] [<hgt files>]  

DESCRIPTION

phyghtmap generates contour lines from NASA SRTM data. It takes at least an area definition as input. It then looks for a cache directory (./hgt/) and the needed SRTM files. If no cache directory is found, it will be created. It then downloads all the needed NASA SRTM data files automatically if they are not cached yet. There is also the possibility of masking the NASA SRTM data with data from www.viewfinderpanoramas.org which fills voids and other data lacking in the NASA data set.  

OPTIONS

-h, --help
show this help message and exit
-a LEFT:BOTTOM:RIGHT:TOP, --area=LEFT:BOTTOM:RIGHT:TOP
choses the area to generate osm SRTM data for by bounding box. If necessary, files are downloaded from the NASA server (http://dds.cr.usgs.gov/srtm/version2_1/SRTM[1|3]). Specify as <left>:<bottom>:<right>:<top> in degrees of latitude and longitude, respectively. Latitudes south of the equator and longitudes west of Greenwich may be given as negative decimal numbers. If this option is given, specified hgt files will be omitted.
-s STEP, --step=STEP
specify contour line step size in meters. The default value is 20.
-o PREFIX, --output-prefix=PREFIX
specify a prefix for the filenames of the output osm file(s).
-p PLOTNAME, --plot=PLOTNAME
specify the path to write longitude/latitude/elevation data to instead of generating contour osm.
-c ELEVATION_MAJOR,ELEVATION_MEDIUM, --line-cat=ELEVATION_MAJOR,ELEVATION_MEDIUM
specify a string of two comma seperated integers for major and medium elevation categories, e. g. '200,100' which is the default. This is needed for fancy rendering.
-j NJOBS, --jobs=NJOBS
number of jobs to be run in parallel (POSIX only)
--osm-version=OSM-VERSION
pass a number as OSM-VERSION to use for the output. The default value is 0.5 since this saves disk space. If you need a newer version, try 0.6.
--start-node-id=STARTID
specify an integer as id of the first written node in the output OSM xml. It defaults to 10000000 but some OSM xml mergers are running into trouble when encountering non unique ids. In this case and for the moment, it is safe to say 10000000000 (ten billion) then.
--srtm=SRTM-RESOLUTION
use SRTM resolution of SRTM-RESOLUTION arc seconds. Note that the finer 1 arc second grid is only available in the USA. Possible values are 1 and 3, the default value is 3.
--viewfinder-mask=VIEWFINDER-RESOLUTION
if specified, NASA SRTM data are masked with data from www.viewfinderpanoramas.org. Possible values are 1 and 3 (for explanation, see the --srtm option).
-v, --version
print version and exit.
 

USAGE EXAMPLES

Here are some usage examples
phyghtmap -a 8.59:49.34:8.78:49.45
generate openstreetmap xml for the area around Heidelberg, Germany
phyghtmap -a 8.59:49.34:8.78:49.45 -o heidelberg
same as above but save data to heidelberg_*.osm files instead of automatically generated filenames
phyghtmap -a -25:62:-12:68 -o iceland
This will not work since no SRTM data is available north of 60 degrees of north.
phyghtmap -a -25:62:-12:68 -o iceland --viewfinder-mask=3
Yes, this works. There is data available for that area at www.viewfinderpanoramas.org.
phyghtmap -a -25:62:-12:68 -o iceland --viewfinder-mask=3 -j 16
Same as above but use 16 parallel processes for the contour line calculation.
phyghtmap -a -25:62:-12:68 -o iceland -s 10 -c 100,50
Say this, if you want contour lines for Iceland with a step size of ten meters and major contour lines every 100 meters and medium contour lines every 50 meters.
phyghtmap -a 6:44:9:47 -o high_alps --viewfinder-mask=1
With this, you get wonderful contour line .osm with a resolution of 1 arc second where data is available at www.viewfinderpanoramas.org and NASA SRTM 3 arc second data elsewhere.
phyghtmap -s 5 some_filename.hgt
Make contour line .osm with steps of 5 meters from file some_filename.hgt. Note that no area was specified here. You can use phyghtmap like this with .hgt files from sources other than NASA SRTM or www.viewfinderpanoramas.org.
phyghtmap -p example_plotname.xyz -a 8.9:49.0:9.0:49.1
Do not generate contour line OSM xml but write a file 'example_plotname.xyz' with lines containing space seperated values of longitude, latitude and elevation for each point stored in the corresponding .hgt file within the specified area.
 

BUGS

If you find a bug, please report it to <dempwolff@informatik.uni-heidelberg.de>.  

AUTHOR

Adrian Dempwolff <dempwolff@informatik.uni-heidelberg.de>

Markus Demleitner <msdemlei@users.sf.net>  

COPYRIGHT

Copyright (c) 2009-2011 Adrian Dempwolff, Markus Demleitner. License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
USAGE EXAMPLES
BUGS
AUTHOR
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 12:15:43 GMT, December 12, 2011