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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.4.
.TH OSSIM-HLZ "1" "December 2015" "ossim-hlz 1.8.20" "User Commands"
.SH NAME
ossim-hlz \- ossim-hlz
.SH SYNOPSIS
.B ossim-hlz
[\fI\,options\/\fR] \fI\,<output-image>\/\fR
.SH DESCRIPTION
Command: ossim\-hlz
.SH OPTIONS
.TP
\fB\-\-dem\fR <filename>
Specifies the input DEM filename to use for
level\-1 processing. If none provided, the
elevation database is referenced as specified
in prefs file for the ROI specified.
.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\-\-gsd\fR <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.
.TP
\fB\-\-ls\-fit\fR
Slope is computed via an LS fit to a plane
instead of the default slope computation
using differences to compute normal vector.
.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 discrete output values (see
\fB\-\-values\fR option).
.TP
\fB\-\-mask\fR <filename>
Either a Keyword\-list file or raster image.
The KWL file can contain multiple mask files
and how to interpret them, i.e., whether
non\-null pixels define exclusion zones
(cannot land inside) or inclusion (must land
inside). A single mask raster image is
assumed to represent exclusion zones.
.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\-\-output\-slope\fR <filename.tif>
Generates a slope byproduct image (floating
point degrees) to the specified filename.
Only valid if normal\-vector method used
(i.e., \fB\-\-ls\-fit\fR option NOT specified)
.TP
\fB\-\-pc\fR | \fB\-\-point\-cloud\fR <filename>
Specifies ancillary point\-cloud data file for
level\-2 search for obstructions.
.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
destination point location in pixels from the
center (i.e., the radius of the reticle).
Defaults to 10. A value of 0 hides the
reticle. See \fB\-\-values\fR option for setting
reticle color.
.TP
\fB\-\-rlz\fR <meters>
Specifies minimum radius of landing zone.
Defaults to 25 m.
.TP
\fB\-\-roi\fR <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.
.TP
\fB\-\-roughness\fR <meters>
Specifies the terrain roughness threshold
(meters). This is the maximum deviation from
a flat plane permitted. Defaults to 0.5 m.
Valid only with \fB\-\-ls\-fit\fR specified.
.TP
\fB\-\-simulation\fR
For engineering/debug purposes
.TP
\fB\-\-size\fR <int>
Instead of a radius of interest, directly
specifies the dimensions of the output
product in pixels (output is square).
Required unless \fB\-\-roi\fR is specified and/or an
inout DEM is specified.
.TP
\fB\-\-slope\fR <degrees>
Threshold for acceptable landing zone terrain
slope. Defaults to 7 deg.
.TP
\fB\-\-summary\fR
Causes a product summary to be output to the
console.
.TP
\fB\-\-target\fR <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.
.TP
\fB\-\-threads\fR <n>
Number of threads. Defaults to use single
core. For engineering/debug purposes.
.TP
\fB\-\-values\fR <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.
.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
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.
.SH EXAMPLES
.IP
ossim\-hlz [options] \-\-roi 5000 \-\-rlz 25 \-\-target 25.5000 \-80.000 output\-hlz.tif
ossim\-hlz [options] \-\-dem mydata.hgt \-\-rlz 25 output\-hlz.tif
.SH "SEE ALSO"
The full documentation for
.B ossim-hlz
is maintained as a Texinfo manual. If the
.B info
and
.B ossim-hlz
programs are properly installed at your site, the command
.IP
.B info ossim-hlz
.PP
should give you access to the complete manual.
|
