| | 1 | '''OSSIM Helicopter Landing Zone Utility''' |
| | 2 | |
| | 3 | 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. |
| | 4 | |
| | 5 | Usage: ossim-hlz [options] <dest_lat> <dest_lon> <output-image>[[BR]] |
| | 6 | |
| | 7 | Options: |
| | 8 | --dem <filename> Specifies the input DEM filename. If none |
| | 9 | provided, the elevation database is referenced |
| | 10 | as specified in prefs file |
| | 11 | --disable-elev Will disable the elevation |
| | 12 | --disable-notify Takes an argument. Arguments are ALL, WARN, |
| | 13 | NOTICE, INFO, FATAL, DEBUG. If you want |
| | 14 | multiple disables then just do multiple |
| | 15 | --disable-notify on the command line. All |
| | 16 | argument are case insensitive. Default is all |
| | 17 | are enabled. |
| | 18 | --disable-plugin Will disable the plugin loader |
| | 19 | --gsd <meters> Specifies output GSD in meters. Defaults to the |
| | 20 | same resolution as best input DEM. |
| | 21 | Alternatively, if a DEM file is specified, the |
| | 22 | product GSD defaults to the input DEM's GSD. |
| | 23 | --lut <filename> Specifies the optional lookup table filename for |
| | 24 | mapping the single-band output image to an RGB. |
| | 25 | The LUT provided must be in the |
| | 26 | ossimIndexToRgbLutFilter format and must handle |
| | 27 | the discrete output values (see --values |
| | 28 | option). |
| | 29 | --ossim-logfile takes a logfile as an argument. All output |
| | 30 | messages are redirected to the specified log |
| | 31 | file. By default there is no log file and all |
| | 32 | messages are enabled. |
| | 33 | --reticle <int> Specifies the size of the reticle at the |
| | 34 | destination pointlocation in pixels from the |
| | 35 | center (i.e., the radius of the reticle). |
| | 36 | Defaults to 10. A value of 0 hides the reticle. |
| | 37 | See --values option for setting reticle color. |
| | 38 | --rlz <meters> Specifies minimum radius of landing zone. |
| | 39 | Defaults to 25 m. |
| | 40 | --roi <meters> radius of interest surrounding the destination |
| | 41 | point. If absent, the product defaults to 1024 x |
| | 42 | 1024 pixels, with a radius of 512 * GSD. |
| | 43 | Alternatively, if a DEM file is specified, the |
| | 44 | product ROI defaults to the full DEM coverage. |
| | 45 | --roughness <meters> Specifies the terrain roughness threshold |
| | 46 | (meters).This is the maximum deviation from a |
| | 47 | flat plane permitted. Defaults to 0.5 m. |
| | 48 | --simulation For engineering/debug purposes |
| | 49 | --size <int> Instead of a radius of interest, directly |
| | 50 | specifies the dimensions of the output product |
| | 51 | in pixels (output is square). Required unless |
| | 52 | --roi is specified and/or an inout DEM is |
| | 53 | specified. |
| | 54 | --slope <degrees> Threshold for acceptable landing zone terrain |
| | 55 | slope. Defaults to 7 deg. |
| | 56 | --summary Causes a product summary to be output to the |
| | 57 | console. |
| | 58 | --target <lat> <lon> The center target destination around which |
| | 59 | suitable HLZs are identified. This can be |
| | 60 | omitted if an input DEM file is provided, in |
| | 61 | which case the center of the DEM is the target. |
| | 62 | --threads <n> Number of threads. Defaults to use all available |
| | 63 | cores. For engineering/debug purposes. |
| | 64 | --values <bad marg good ret> Specifies the pixel values (0-255) for the |
| | 65 | output product corresponding to bad, marginal, |
| | 66 | and good landing zones, respectively, with the |
| | 67 | fourth value representing the reticle value. |
| | 68 | Defaults to bad=0 (null), marg=1, , good=2, and |
| | 69 | reticle is highlighted with 3. |
| | 70 | -K specify individual keywords to add to the |
| | 71 | preferences keyword list: name=value |
| | 72 | -P specify a preference file to load |
| | 73 | -T specify the classes to trace, ex: |
| | 74 | ossimInit|ossimImage.* |
| | 75 | will trace ossimInit and all ossimImage classes |
| | 76 | -V or --version Display version information. |
| | 77 | |
| | 78 | |
| | 79 | 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. |
| | 80 | |
| | 81 | Examples: |
| | 82 | |
| | 83 | ossim-hlz --roi 5000 --rlz 25 --target 25.5000 -80.000 output-hlz.tif[[BR]] |
| | 84 | |
| | 85 | ossim-hlz --dem mydata.hgt --rlz 25 output-hlz.tif |
| | 86 | |
