NAME

       ossim-viewshed - ossim-viewshed

SYNOPSIS

       ossim-viewshed [options] <obs_lat> <obs_lon> <output-image>

OPTIONS

       --dem <filename>
              Specifies  the  input  DEM  filename.  If  none  provided, the elevation database is referenced as
              specified in prefs file

       --disable-elev
              Will disable the elevation

       --disable-notify
              Takes an argument. Arguments are ALL, WARN, NOTICE, INFO, FATAL,  DEBUG.   If  you  want  multiple
              disables  then  just  do  multiple  --disable-notify  on  the command line.  All argument are case
              insensitive.  Default is all are enabled.

       --disable-plugin
              Will disable the plugin loader

       --fov <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

       --gsd <meters>
              Specifies output GSD in meters. Defaults to the same resolution as input DEM.

       --hgt-of-eye <meters>
              Specifies the observers height-of-eye above the terrain in meters. Defaults to 1.5 m.

       --horizon <filename>
              Experimental. Outputs the max elevation  angles  for  all  azimuths  to  <filename>,  for  horizon
              profiling.

       --lut <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 --values option).

       --ossim-logfile
              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.

       --radius <meters>
              Specifies max visibility in meters. Required unless --size is specified.  This  option  constrains
              output to a circle, similar to a radar display

       --request-api
              Causes  applications  API  to be output as JSON to stdout. Accepts optional filename to store JSON
              output.

       --reticle <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 --values option for
              setting reticle color.

       --simulation
              For engineering/debug purposes

       --size <int>
              Instead of a visibility radius, directly specifies the dimensions of the output product in  pixels
              (output is square). Required unless --radius is specified.

       --summary
              Causes a product summary to be output to the console.

       --tbs  "Thread By Sector". For engineering/debug purposes

       --threads <n>
              Number of threads. Defaults to use all available cores. For engineering/debug purposes

       --values <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.

       -K     specify individual keywords to add to the preferences keyword list: name=value

       -P     specify a preference file to load

       -T     specify the classes to trace, ex: ossimInit|ossimImage.*  will trace ossimInit and all  ossimImage
              classes

       Computes  the viewshed for the given viewpt coordinates. The output is a binary image with 0 representing
       hidden points, and 1 representing visible points.

EXAMPLES

       ossim-viewshed --radius 50
              28.0 -80.5 output-hlz.tif

       ossim-viewshed --size 1024
              28.0 -80.5 output-hlz.tif

       An alternate command line provides switch for observer lat and lon:

       ossim-viewshed --rlz 25 --observer 28.0 -80.5
              output-hlz.tif

SEE ALSO

       The full documentation for ossim-viewshed is maintained as a Texinfo manual.   If  the  info  and  ossim-
       viewshed programs are properly installed at your site, the command

              info ossim-viewshed

       should give you access to the complete manual.