1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.4.
.TH OSSIM-VIEWSHED "1" "December 2015" "ossim-viewshed 1.8.20" "User Commands"
.SH NAME
ossim-viewshed \- ossim-viewshed
.SH SYNOPSIS
.B ossim-viewshed
[\fI\,options\/\fR] \fI\,<obs_lat> <obs_lon> <output-image>\/\fR
.SH OPTIONS
.TP
\fB\-\-dem\fR <filename>
Specifies the input DEM filename. If none provided,
the elevation database is referenced as specified in
prefs file
.TP
\fB\-\-disable\-elev\fR
Will disable the elevation
.TP
\fB\-\-disable\-notify\fR
Takes an argument. Arguments are ALL, WARN, NOTICE,
INFO, FATAL, DEBUG. If you want multiple disables
then just do multiple \fB\-\-disable\-notify\fR on the command
line. All argument are case insensitive. Default is
all are enabled.
.TP
\fB\-\-disable\-plugin\fR
Will disable the plugin loader
.TP
\fB\-\-fov\fR <start> <end>
Optional arguments specifying the field\-of\-view
boundary azimuths (in degrees). By default, a 360 deg
FOV is computed. The arc is taken clockwise from start
to end, so for a FOV of 225 deg from W, through N to
SE, start=270 and end=135
.TP
\fB\-\-gsd\fR <meters>
Specifies output GSD in meters. Defaults to the same
resolution as input DEM.
.TP
\fB\-\-hgt\-of\-eye\fR <meters>
Specifies the observers height\-of\-eye above the
terrain in meters. Defaults to 1.5 m.
.TP
\fB\-\-horizon\fR <filename>
Experimental. Outputs the max elevation angles for all
azimuths to <filename>, for horizon profiling.
.TP
\fB\-\-lut\fR <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 three output viewshed
values (see \fB\-\-values\fR option).
.TP
\fB\-\-ossim\-logfile\fR
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.
.TP
\fB\-\-radius\fR <meters>
Specifies max visibility in meters. Required unless
\fB\-\-size\fR is specified. This option constrains output to
a circle, similar to a radar display
.TP
\fB\-\-request\-api\fR
Causes applications API to be output as JSON to
stdout. Accepts optional filename to store JSON
output.
.TP
\fB\-\-reticle\fR <int>
Specifies the size of the reticle at the
observerlocation in pixels from the center (i.e., the
radius of the reticle). Defaults to 2. A value of 0
hides the reticle. See \fB\-\-values\fR option for setting
reticle color.
.TP
\fB\-\-simulation\fR
For engineering/debug purposes
.TP
\fB\-\-size\fR <int>
Instead of a visibility radius, directly specifies the
dimensions of the output product in pixels (output is
square). Required unless \fB\-\-radius\fR is specified.
.TP
\fB\-\-summary\fR
Causes a product summary to be output to the console.
.TP
\fB\-\-tbs\fR
"Thread By Sector". For engineering/debug purposes
.TP
\fB\-\-threads\fR <n>
Number of threads. Defaults to use all available
cores. For engineering/debug purposes
.TP
\fB\-\-values\fR <int int int>
Specifies the pixel values (0\-255) for the visible,
hidden and reticle pixels, respectively. Defaults to
visible=null (0), hidden=128, and observer position
reticle is highlighted with 255.
.TP
\fB\-K\fR
specify individual keywords to add to the preferences
keyword list: name=value
.TP
\fB\-P\fR
specify a preference file to load
.TP
\fB\-T\fR
specify the classes to trace, ex:
ossimInit|ossimImage.*
will trace ossimInit and all ossimImage classes
.PP
Computes the viewshed for the given viewpt coordinates. The output is a binary image with 0 representing hidden points, and 1 representing visible points.
.SH EXAMPLES
.TP
ossim\-viewshed \-\-radius 50
28.0 \-80.5 output\-hlz.tif
.TP
ossim\-viewshed \-\-size 1024
28.0 \-80.5 output\-hlz.tif
.PP
An alternate command line provides switch for observer lat and lon:
.TP
ossim\-viewshed \-\-rlz 25 \-\-observer 28.0 \-80.5
output\-hlz.tif
.SH "SEE ALSO"
The full documentation for
.B ossim-viewshed
is maintained as a Texinfo manual. If the
.B info
and
.B ossim-viewshed
programs are properly installed at your site, the command
.IP
.B info ossim-viewshed
.PP
should give you access to the complete manual.
|
