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