~ubuntu-branches/ubuntu/wily/liblas/wily-proposed

« back to all changes in this revision

Viewing changes to debian/man/lasinfo.1.xml

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2014-02-21 11:52:35 UTC
  • mto: (2.1.2 experimental)
  • mto: This revision was merged to the branch mainline in revision 11.
  • Revision ID: package-import@ubuntu.com-20140221115235-ebiz60klt5y0g8d3
Move python dependencies from Build-Depends-Indep to Build-Depends.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="UTF-8"?>
 
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 
3
<refentry id='lasinfo'>
 
4
 
 
5
  <refmeta>
 
6
    <refentrytitle>lasinfo</refentrytitle>
 
7
    <manvolnum>1</manvolnum>
 
8
  </refmeta>
 
9
 
 
10
  <refnamediv>
 
11
    <refname>lasinfo</refname>
 
12
    <refpurpose>display LAS file details</refpurpose>
 
13
  </refnamediv>
 
14
 
 
15
  <refsynopsisdiv id='synopsis'>
 
16
    <cmdsynopsis>
 
17
      <command>lasinfo</command>
 
18
      <group>
 
19
        <arg choice='plain'><option>-h</option></arg>
 
20
        <arg choice='plain'>
 
21
          <option>-i</option> <replaceable>arg</replaceable>
 
22
          <arg choice='opt'><option>-v</option></arg>
 
23
          <arg choice='opt'><option>--no-vlrs</option></arg>
 
24
          <arg choice='opt'><option>--no-schema</option></arg>
 
25
          <arg choice='opt'><option>--no-check</option></arg>
 
26
          <arg choice='opt'><option>--xml</option></arg>
 
27
          <arg choice='opt'><option>-p</option> <replaceable>arg</replaceable></arg>
 
28
          <arg choice='opt'><replaceable>Filtering options</replaceable></arg>
 
29
        </arg>
 
30
      </group>
 
31
    </cmdsynopsis>
 
32
  </refsynopsisdiv>
 
33
 
 
34
  <refsect1 id='description'>
 
35
    <title>DESCRIPTION</title>
 
36
    <para>
 
37
      <command>lasinfo</command> displays LAS file details with optional
 
38
      output filters.
 
39
      While <command>lasinfo</command> can do a few simple operations like
 
40
      updating header information, more drastic changes, like removing points
 
41
      or altering values, will require
 
42
      <citerefentry>
 
43
        <refentrytitle>las2las</refentrytitle>
 
44
        <manvolnum>1</manvolnum>
 
45
      </citerefentry>.
 
46
    </para>
 
47
  </refsect1>
 
48
 
 
49
  <refsect1 id='options'>
 
50
    <title>OPTIONS</title>
 
51
 
 
52
    lasinfo options:
 
53
    <variablelist>
 
54
 
 
55
      <varlistentry>
 
56
        <term><option>-h</option></term>
 
57
        <term><option>--help</option></term>
 
58
        <listitem>
 
59
          <para>
 
60
            produce help message
 
61
          </para>
 
62
        </listitem>
 
63
      </varlistentry>
 
64
 
 
65
      <varlistentry>
 
66
        <term><option>-i</option> <replaceable>arg</replaceable></term>
 
67
        <term><option>--input</option> <replaceable>arg</replaceable></term>
 
68
        <listitem>
 
69
          <para>
 
70
            input LAS file
 
71
          </para>
 
72
        </listitem>
 
73
      </varlistentry>
 
74
 
 
75
      <varlistentry>
 
76
        <term><option>-v</option></term>
 
77
        <term><option>--verbose</option></term>
 
78
        <listitem>
 
79
          <para>
 
80
            Verbose message output
 
81
          </para>
 
82
        </listitem>
 
83
      </varlistentry>
 
84
 
 
85
      <varlistentry>
 
86
        <term><option>--no-vlrs</option></term>
 
87
        <listitem>
 
88
          <para>
 
89
            Don't show VLRs
 
90
          </para>
 
91
        </listitem>
 
92
      </varlistentry>
 
93
 
 
94
      <varlistentry>
 
95
        <term><option>--no-schema</option></term>
 
96
        <listitem>
 
97
          <para>
 
98
            Don't show schema
 
99
          </para>
 
100
        </listitem>
 
101
      </varlistentry>
 
102
 
 
103
      <varlistentry>
 
104
        <term><option>--no-check</option></term>
 
105
        <listitem>
 
106
          <para>
 
107
            Don't scan points
 
108
          </para>
 
109
        </listitem>
 
110
      </varlistentry>
 
111
 
 
112
      <varlistentry>
 
113
        <term><option>--xml</option></term>
 
114
        <listitem>
 
115
          <para>
 
116
            Output as XML
 
117
          </para>
 
118
        </listitem>
 
119
      </varlistentry>
 
120
 
 
121
      <varlistentry>
 
122
        <term><option>-p</option> <replaceable>arg</replaceable></term>
 
123
        <term><option>--point</option> <replaceable>arg</replaceable></term>
 
124
        <listitem>
 
125
          <para>
 
126
            Display a point with a given id.
 
127
            <option>--point 44</option>
 
128
          </para>
 
129
        </listitem>
 
130
      </varlistentry>
 
131
 
 
132
    </variablelist>
 
133
 
 
134
    Filtering options:
 
135
    <variablelist>
 
136
 
 
137
      <varlistentry>
 
138
        <term><option>-e</option> <replaceable>arg</replaceable></term>
 
139
        <term><option>--extent</option> <replaceable>arg</replaceable></term>
 
140
        <listitem>
 
141
          <para>
 
142
            Extent window that points must fall within to keep.
 
143
            Use a comma-separated or quoted, space-separated list,
 
144
            for example, 
 
145
            <option>-e minx, miny, maxx, maxy</option>
 
146
            or 
 
147
            <option>-e minx, miny, minz, maxx, maxy, maxz</option>
 
148
            <option>-e "minx miny minz maxx maxy maxz"</option>
 
149
          </para>
 
150
        </listitem>
 
151
      </varlistentry>
 
152
 
 
153
      <varlistentry>
 
154
        <term><option>--minx</option> <replaceable>arg</replaceable></term>
 
155
        <listitem>
 
156
          <para>
 
157
            Extent must be greater than or equal to minx to be kept. 
 
158
            <option>--minx 1234.0</option>
 
159
          </para>
 
160
        </listitem>
 
161
      </varlistentry>
 
162
 
 
163
      <varlistentry>
 
164
        <term><option>--miny</option> <replaceable>arg</replaceable></term>
 
165
        <listitem>
 
166
          <para>
 
167
            Extent must be greater than or equal to miny to be kept. 
 
168
            <option>--miny 5678.0</option>
 
169
          </para>
 
170
        </listitem>
 
171
      </varlistentry>
 
172
 
 
173
      <varlistentry>
 
174
        <term><option>--minz</option> <replaceable>arg</replaceable></term>
 
175
        <listitem>
 
176
          <para>
 
177
            Extent must be greater than or equal to minz to be kept.
 
178
            If maxx and maxy are set but not minz *and maxz,
 
179
            all z values are kept.
 
180
            <option>--minz 0.0</option>
 
181
          </para>
 
182
        </listitem>
 
183
      </varlistentry>
 
184
 
 
185
      <varlistentry>
 
186
        <term><option>--maxx</option> <replaceable>arg</replaceable></term>
 
187
        <listitem>
 
188
          <para>
 
189
            Extent must be less than or equal to maxx to be kept. 
 
190
            <option>--maxx 1234.0</option>
 
191
          </para>
 
192
        </listitem>
 
193
      </varlistentry>
 
194
 
 
195
      <varlistentry>
 
196
        <term><option>--maxy</option> <replaceable>arg</replaceable></term>
 
197
        <listitem>
 
198
          <para>
 
199
            Extent must be less than or equal to maxy to be kept. 
 
200
            <option>--maxy 5678.0</option>
 
201
          </para>
 
202
        </listitem>
 
203
      </varlistentry>
 
204
 
 
205
      <varlistentry>
 
206
        <term><option>--maxz</option> <replaceable>arg</replaceable></term>
 
207
        <listitem>
 
208
          <para>
 
209
            Extent must be less than or equal to maxz to be kept. 
 
210
            If maxx and maxy are set but not maxz *and minz,
 
211
            all z values are kept. 
 
212
            <option>--maxz 10.0</option>
 
213
          </para>
 
214
        </listitem>
 
215
      </varlistentry>
 
216
 
 
217
      <varlistentry>
 
218
        <term><option>-t</option> <replaceable>arg</replaceable></term>
 
219
        <term><option>--thin</option> <replaceable>arg</replaceable> (=0)</term>
 
220
        <listitem>
 
221
          <para>
 
222
            Simple decimation-style thinning.
 
223
            Thin the file by removing every t'th point from the file.
 
224
          </para>
 
225
        </listitem>
 
226
      </varlistentry>
 
227
 
 
228
      <varlistentry>
 
229
        <term><option>--last_return_only</option></term>
 
230
        <listitem>
 
231
          <para>
 
232
            Keep last returns
 
233
            (cannot be used with <option>--first_return_only</option>)
 
234
          </para>
 
235
        </listitem>
 
236
      </varlistentry>
 
237
 
 
238
      <varlistentry>
 
239
        <term><option>--first_return_only</option></term>
 
240
        <listitem>
 
241
          <para>
 
242
            Keep first returns
 
243
            (cannot be used with <option>--last_return_only</option>)
 
244
          </para>
 
245
        </listitem>
 
246
      </varlistentry>
 
247
 
 
248
      <varlistentry>
 
249
        <term><option>--keep-returns</option> <replaceable>arg</replaceable></term>
 
250
        <listitem>
 
251
          <para>
 
252
            A list of return numbers to keep in the output file: 
 
253
            <option>--keep-returns 1 2 3</option>
 
254
          </para>
 
255
        </listitem>
 
256
      </varlistentry>
 
257
 
 
258
      <varlistentry>
 
259
        <term><option>--drop-returns</option> <replaceable>arg</replaceable></term>
 
260
        <listitem>
 
261
          <para>
 
262
            Return numbers to drop.
 
263
            For example, <option>--drop-returns 2 3 4 5</option>
 
264
          </para>
 
265
        </listitem>
 
266
      </varlistentry>
 
267
 
 
268
      <varlistentry>
 
269
        <term><option>--valid_only</option></term>
 
270
        <listitem>
 
271
          <para>
 
272
            Keep only valid points
 
273
          </para>
 
274
        </listitem>
 
275
      </varlistentry>
 
276
 
 
277
      <varlistentry>
 
278
        <term><option>--keep-classes</option> <replaceable>arg</replaceable></term>
 
279
        <listitem>
 
280
          <para>
 
281
            A list of classifications to keep:
 
282
            <option>--keep-classes 2 4 12</option>
 
283
            <option>--keep-classes 2</option>
 
284
          </para>
 
285
        </listitem>
 
286
      </varlistentry>
 
287
 
 
288
      <varlistentry>
 
289
        <term><option>--drop-classes</option> <replaceable>arg</replaceable></term>
 
290
        <listitem>
 
291
          <para>
 
292
            A comma-separated list of classifications to drop:
 
293
            <option>--drop-classes 1,7,8</option>
 
294
            <option>--drop-classes 2</option>
 
295
          </para>
 
296
        </listitem>
 
297
      </varlistentry>
 
298
 
 
299
      <varlistentry>
 
300
        <term><option>--keep-intensity</option> <replaceable>arg</replaceable></term>
 
301
        <listitem>
 
302
          <para>
 
303
            Range in which to keep intensity.
 
304
            The following expression types are supported:  
 
305
            <option>--keep-intensity 0-100</option>
 
306
            <option>--keep-intensity &lt;200</option>
 
307
            <option>--keep-intensity &gt;400</option>
 
308
            <option>--keep-intensity &gt;=200</option>
 
309
          </para>
 
310
        </listitem>
 
311
      </varlistentry>
 
312
 
 
313
      <varlistentry>
 
314
        <term><option>--drop-intensity</option> <replaceable>arg</replaceable></term>
 
315
        <listitem>
 
316
          <para>
 
317
            Range in which to drop intensity.
 
318
            The following expression types are supported:  
 
319
            <option>--drop-intensity &lt;200</option>
 
320
            <option>--drop-intensity &gt;400</option>
 
321
            <option>--drop-intensity &gt;=200</option>
 
322
          </para>
 
323
        </listitem>
 
324
      </varlistentry>
 
325
 
 
326
      <varlistentry>
 
327
        <term><option>--keep-time</option> <replaceable>arg</replaceable></term>
 
328
        <listitem>
 
329
          <para>
 
330
            Range in which to keep time.
 
331
            The following expression types are supported:  
 
332
            <option>--keep-time 413665.2336-414092.8462</option>
 
333
            <option>--keep-time &lt;414094.8462</option>
 
334
            <option>--keep-time &gt;413665.2336</option>
 
335
            <option>--keep-time &gt;=413665.2336</option>
 
336
          </para>
 
337
        </listitem>
 
338
      </varlistentry>
 
339
 
 
340
      <varlistentry>
 
341
        <term><option>--drop-time</option> <replaceable>arg</replaceable></term>
 
342
        <listitem>
 
343
          <para>
 
344
            Range in which to drop time.
 
345
            The following expression types are supported:  
 
346
            <option>--drop-time &lt;413666.2336</option>
 
347
            <option>--drop-time &gt;413665.2336</option>
 
348
            <option>--drop-time &gt;=413665.2336</option>
 
349
          </para>
 
350
        </listitem>
 
351
      </varlistentry>
 
352
 
 
353
      <varlistentry>
 
354
        <term><option>--keep-scan-angle</option> <replaceable>arg</replaceable></term>
 
355
        <listitem>
 
356
          <para>
 
357
            Range in which to keep scan angle.
 
358
            The following expression types are supported:  
 
359
            <option>--keep-scan-angle 0-100</option>
 
360
            <option>--keep-scan-angle &lt;100</option>
 
361
            <option>--keep-scan-angle &lt;=100</option>
 
362
          </para>
 
363
        </listitem>
 
364
      </varlistentry>
 
365
 
 
366
      <varlistentry>
 
367
        <term><option>--drop-scan-angle</option> <replaceable>arg</replaceable></term>
 
368
        <listitem>
 
369
          <para>
 
370
            Range in which to drop scan angle.
 
371
            The following expression types are supported:  
 
372
            <option>--drop-scan-angle &lt;30</option>
 
373
            <option>--drop-scan-angle &gt;100</option>
 
374
            <option>--drop-scan-angle &gt;=100</option>
 
375
          </para>
 
376
        </listitem>
 
377
      </varlistentry>
 
378
 
 
379
      <varlistentry>
 
380
        <term><option>--keep-color</option> <replaceable>arg</replaceable></term>
 
381
        <listitem>
 
382
          <para>
 
383
            Range in which to keep colors.
 
384
            Define colors as two 3-tuples (R,G,B-R,G,B):  
 
385
            <option>--keep-color '0,0,0-125,125,125'</option>
 
386
          </para>
 
387
        </listitem>
 
388
      </varlistentry>
 
389
 
 
390
      <varlistentry>
 
391
        <term><option>--drop-color</option> <replaceable>arg</replaceable></term>
 
392
        <listitem>
 
393
          <para>
 
394
            Range in which to drop colors.
 
395
            Define colors as two 3-tuples (R,G,B-R,G,B):  
 
396
            <option>--drop-color '255,255,255-65536,65536,65536'</option>
 
397
          </para>
 
398
        </listitem>
 
399
      </varlistentry>
 
400
 
 
401
    </variablelist>
 
402
 
 
403
  </refsect1>
 
404
 
 
405
  <refsect1 id='example'>
 
406
    <title>EXAMPLE</title>
 
407
 
 
408
    <example>
 
409
      <title>Example data</title>
 
410
 
 
411
      Visit the libLAS sample library for LiDAR data in LAS format:
 
412
 
 
413
      <ulink url="http://liblas.org/samples/">http://liblas.org/samples/</ulink>
 
414
    </example>
 
415
 
 
416
  </refsect1>
 
417
 
 
418
</refentry>