.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.46.4.
.TH OSSIM-VIEWSHED "1" "December 2015" "ossim-viewshed 1.8.20" "User Commands"
.SH NAME
ossim-viewshed \- ossim-viewshed
.SH SYNOPSIS
.B ossim-viewshed
[\fI\,options\/\fR] \fI\,<obs_lat> <obs_lon> <output-image>\/\fR
.SH OPTIONS
.TP
\fB\-\-dem\fR <filename>
Specifies the input DEM filename. If none provided,
the elevation database is referenced as specified in
prefs file
.TP
\fB\-\-disable\-elev\fR
Will disable the elevation
.TP
\fB\-\-disable\-notify\fR
Takes an argument. Arguments are ALL, WARN, NOTICE,
INFO, FATAL, DEBUG.  If you want multiple disables
then just do multiple \fB\-\-disable\-notify\fR on the command
line.  All argument are case insensitive.  Default is
all are enabled.
.TP
\fB\-\-disable\-plugin\fR
Will disable the plugin loader
.TP
\fB\-\-fov\fR <start> <end>
Optional arguments specifying the field\-of\-view
boundary azimuths (in degrees). By default, a 360 deg
FOV is computed. The arc is taken clockwise from start
to end, so for a FOV of 225 deg from W, through N to
SE, start=270 and end=135
.TP
\fB\-\-gsd\fR <meters>
Specifies output GSD in meters. Defaults to the same
resolution as input DEM.
.TP
\fB\-\-hgt\-of\-eye\fR <meters>
Specifies the observers height\-of\-eye above the
terrain in meters. Defaults to 1.5 m.
.TP
\fB\-\-horizon\fR <filename>
Experimental. Outputs the max elevation angles for all
azimuths to <filename>, for horizon profiling.
.TP
\fB\-\-lut\fR <filename>
Specifies the optional lookup table filename for
mapping the single\-band output image to an RGB. The
LUT provided must be in the ossimIndexToRgbLutFilter
format and must handle the three output viewshed
values (see \fB\-\-values\fR option).
.TP
\fB\-\-ossim\-logfile\fR
takes a logfile as an argument.  All output messages
are redirected to the specified log file.  By default
there is no log file and all messages are enabled.
.TP
\fB\-\-radius\fR <meters>
Specifies max visibility in meters. Required unless
\fB\-\-size\fR is specified. This option constrains output to
a circle, similar to a radar display
.TP
\fB\-\-request\-api\fR
Causes applications API to be output as JSON to
stdout. Accepts optional filename to store JSON
output.
.TP
\fB\-\-reticle\fR <int>
Specifies the size of the reticle at the
observerlocation in pixels from the center (i.e., the
radius of the reticle). Defaults to 2. A value of 0
hides the reticle. See \fB\-\-values\fR option for setting
reticle color.
.TP
\fB\-\-simulation\fR
For engineering/debug purposes
.TP
\fB\-\-size\fR <int>
Instead of a visibility radius, directly specifies the
dimensions of the output product in pixels (output is
square). Required unless \fB\-\-radius\fR is specified.
.TP
\fB\-\-summary\fR
Causes a product summary to be output to the console.
.TP
\fB\-\-tbs\fR
"Thread By Sector". For engineering/debug purposes
.TP
\fB\-\-threads\fR <n>
Number of threads. Defaults to use all available
cores. For engineering/debug purposes
.TP
\fB\-\-values\fR <int int int>
Specifies the pixel values (0\-255) for the visible,
hidden and reticle pixels, respectively. Defaults to
visible=null (0), hidden=128, and observer position
reticle is highlighted with 255.
.TP
\fB\-K\fR
specify individual keywords to add to the preferences
keyword list: name=value
.TP
\fB\-P\fR
specify a preference file to load
.TP
\fB\-T\fR
specify the classes to trace, ex:
ossimInit|ossimImage.*
will trace ossimInit and all ossimImage classes
.PP
Computes the viewshed for the given viewpt coordinates. The output is a binary image with 0 representing hidden points, and 1 representing visible points.
.SH EXAMPLES
.TP
ossim\-viewshed \-\-radius 50
28.0 \-80.5 output\-hlz.tif
.TP
ossim\-viewshed \-\-size 1024
28.0 \-80.5 output\-hlz.tif
.PP
An alternate command line provides switch for observer lat and lon:
.TP
ossim\-viewshed \-\-rlz 25 \-\-observer 28.0 \-80.5
output\-hlz.tif
.SH "SEE ALSO"
The full documentation for
.B ossim-viewshed
is maintained as a Texinfo manual.  If the
.B info
and
.B ossim-viewshed
programs are properly installed at your site, the command
.IP
.B info ossim-viewshed
.PP
should give you access to the complete manual.