OSSIM Helicopter Landing Zone Utility

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

Usage: ossim-hlz [options] <dest_lat> <dest_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
  --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.
  --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).
  --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.
  --reticle <int>               Specifies the size of the reticle at the
                                destination pointlocation 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.
  --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 all available
                                cores. 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
  -V or --version               Display version information.

Examples:

    ossim-hlz --roi 5000 --rlz 25 --target 25.5000 -80.000 output-hlz.tif

    ossim-hlz --dem mydata.hgt --rlz 25 output-hlz.tif