OSSIM Helicopter Landing Zone Utility

This utility accepts an area of interest, or alternatively an input elevation model file (DEM file), along with landing zone criteria, and determines suitable HLZs. The output is a TIF raster image with the HLZ indicated in some color.

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.

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 --roi 5000 --rlz 25 --target 25.5000 -80.000 output-hlz.tif

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