NAME

       ossim-hlz - ossim-hlz

SYNOPSIS

       ossim-hlz [options] <output-image>

DESCRIPTION

       Command:  ossim-hlz

OPTIONS

       --dem <filename>
              Specifies  the  input  DEM filename to use for level-1 processing. If none provided, the elevation
              database is referenced as specified in prefs file for the ROI specified.

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

       --gsd <meters>
              Specifies output GSD in meters. Defaults to the same resolution as best input DEM.  Alternatively,
              if a DEM file is specified, the product GSD defaults to the input DEM's GSD.

       --ls-fit
              Slope  is  computed  via  an  LS  fit  to  a  plane instead of the default slope computation using
              differences to compute normal vector.

       --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 discrete
              output values (see --values option).

       --mask <filename>
              Either a Keyword-list file or raster image.  The KWL file can contain multiple mask files and  how
              to  interpret  them,  i.e., whether non-null pixels define exclusion zones (cannot land inside) or
              inclusion (must land inside). A single mask raster image is assumed to represent exclusion zones.

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

       --output-slope <filename.tif>
              Generates  a slope byproduct image (floating point degrees) to the specified filename.  Only valid
              if normal-vector method used (i.e., --ls-fit option NOT specified)

       --pc | --point-cloud <filename>
              Specifies ancillary point-cloud data file for level-2 search for obstructions.

       --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 destination point location in pixels from the center
              (i.e., the radius of the reticle).  Defaults to 10. A value of 0 hides the reticle.  See  --values
              option for setting reticle color.

       --rlz <meters>
              Specifies minimum radius of landing zone.  Defaults to 25 m.

       --roi <meters>
              radius  of  interest  surrounding the destination point. If absent, the product defaults to 1024 x
              1024 pixels, with a radius of 512 * GSD. Alternatively, if a DEM file is  specified,  the  product
              ROI defaults to the full DEM coverage.

       --roughness <meters>
              Specifies  the  terrain  roughness  threshold  (meters). This is the maximum deviation from a flat
              plane permitted. Defaults to 0.5 m.  Valid only with --ls-fit specified.

       --simulation
              For engineering/debug purposes

       --size <int>
              Instead of a radius of interest, directly specifies the  dimensions  of  the   output  product  in
              pixels (output is square).  Required unless --roi is specified and/or an inout DEM is specified.

       --slope <degrees>
              Threshold for acceptable landing zone terrain slope. Defaults to 7 deg.

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

       --target <lat> <lon>
              The center target destination around which suitable HLZs are identified. This can be omitted if an
              input DEM file is provided, in which case the center of the DEM is the target.

       --threads <n>
              Number of threads. Defaults to use single core. For engineering/debug purposes.

       --values <bad marg good ret>
              Specifies the pixel values (0-255) for the output product corresponding to bad, marginal, and good
              landing  zones,  respectively,  with  the fourth value representing the reticle value. Defaults to
              bad=0 (null), marg=1, , good=2, and reticle is highlighted with 3.

       -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

       Finds  acceptable  helicopter  landing  zones given terrain data and LZ criteria. The output is an 8-bit,
       single band, raster image. Options exist for customizing the output pixel values including an  option  to
       generate a color raster with the use of a look-up table.

EXAMPLES

              ossim-hlz  [options]  --roi  5000  --rlz  25  --target  25.5000  -80.000  output-hlz.tif ossim-hlz
              [options] --dem mydata.hgt --rlz 25 output-hlz.tif

SEE ALSO

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

              info ossim-hlz

       should give you access to the complete manual.