| | 1 | |
| | 2 | == OSSIM Viewshed Utility == |
| | 3 | |
| | 4 | Computes the viewshed for the given observer position. The output is a geotiff image representing hidden and visible points within the field-of-view. |
| | 5 | |
| | 6 | Usage: ossim-viewshed [options] <obs_lat> <obs_lon> <output-image> |
| | 7 | |
| | 8 | Options: |
| | 9 | |
| | 10 | --disable-elev Will disable the elevation |
| | 11 | --disable-notify Takes an argument. Arguments are ALL, WARN, NOTICE, |
| | 12 | INFO, FATAL, DEBUG. If you want multiple disables |
| | 13 | then just do multiple --disable-notify on the command |
| | 14 | line. All argument are case insensitive. Default is |
| | 15 | all are enabled. |
| | 16 | --disable-plugin Will disable the plugin loader |
| | 17 | --fov <start> <end> Optional arguments specifying the field-of-view |
| | 18 | boundary azimuths (in degrees). By default, a 360 deg |
| | 19 | FOV is computed. The arc is taken clockwise from start |
| | 20 | to end, so for a FOV of 225 deg from W, through N to |
| | 21 | SE, start=270 and end=135 |
| | 22 | --gsd <meters> Specifies output GSD in meters. Defaults to the same |
| | 23 | resolution as input DEM. |
| | 24 | --hgt-of-eye <meters> Specifies the observers height-of-eye above the |
| | 25 | terrain in meters. Defaults to 1.5 m. |
| | 26 | --input-dem <filename> Specifies the input DEM filename. If none provided, |
| | 27 | the elevation database is referenced as specified in |
| | 28 | prefs file |
| | 29 | --lut <filename> Specifies the optional lookup table filename for |
| | 30 | mapping the single-band output image to an RGB. The |
| | 31 | LUT provided is in the ossimIndexToRgbLutFilter format |
| | 32 | and must handle the three output viewshed values (see |
| | 33 | --values option). |
| | 34 | --multithread Enables multithreading. For engineering/debug |
| | 35 | purposes. |
| | 36 | --ossim-logfile takes a logfile as an argument. All output messages |
| | 37 | are redirected to the specified log file. By default |
| | 38 | there is no log file and all messages are enabled. |
| | 39 | --radius <meters> Specifies max visibility in meters. Required unless |
| | 40 | --size is specified. This option constrains output to |
| | 41 | a circle, similar to a radar display |
| | 42 | --reticle <int> Specifies the size of the reticle at the |
| | 43 | observerlocation in pixels from the center (i.e., the |
| | 44 | radius of the reticle). Defaults to 2. A value of 0 |
| | 45 | hides the reticle. See --values option for setting |
| | 46 | reticle color. |
| | 47 | --simulation For engineering/debug purposes |
| | 48 | --size <int> Instead of a visibility radius, directly specifies the |
| | 49 | dimensions of the output product in pixels (output is |
| | 50 | square). Required unless --radius is specified. |
| | 51 | --summary Causes a product summary to be output to the console. |
| | 52 | --tbs "Thread By Sector". For engineering/debug purposes |
| | 53 | --threads <n> Number of threads. For engineering/debug purposes |
| | 54 | --values <int int int> Specifies the pixel values (0-255) for the visible, |
| | 55 | hidden and reticle pixels, respectively. Defaults to |
| | 56 | visible=null (0), hidden=128, and observer position |
| | 57 | reticle is highlighted with 255. |
| | 58 | -K specify individual keywords to add to the preferences |
| | 59 | keyword list: name=value |
| | 60 | -P specify a preference file to load |
| | 61 | -T specify the classes to trace, ex: |
| | 62 | ossimInit|ossimImage.* |
| | 63 | will trace ossimInit and all ossimImage classes |
| | 64 | -V or --version Display version information. |
| | 65 | |
| | 66 | Examples: |
| | 67 | |
| | 68 | ossim-viewshed [options] --radius <radius> <obs_lat> <obs_lon> <output-image-file> |
| | 69 | ossim-viewshed [options] --size <image_size> <obs_lat> <obs_lon> <output-image-file> |
| | 70 | |
| | 71 | |
