File: lasblock.1.xml

package info (click to toggle)
liblas 1.8.0-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 7,888 kB
  • ctags: 4,614
  • sloc: cpp: 31,630; xml: 4,195; python: 2,928; ansic: 2,439; cs: 2,411; sh: 143; makefile: 37
file content (149 lines) | stat: -rw-r--r-- 4,383 bytes parent folder | download | duplicates (3)
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
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<refentry id='lasblock'>

  <refmeta>
    <refentrytitle>lasblock</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>lasblock</refname>
    <refpurpose>pre-process LAS files into blocks</refpurpose>
  </refnamediv>

  <refsynopsisdiv id='synopsis'>
    <cmdsynopsis>
      <command>lasblock</command>
      <group>
        <arg choice='opt'><option>-h</option></arg>
        <arg choice='plain'>
          <arg choice='opt'><option>-c</option> <replaceable>arg</replaceable></arg>
          <arg choice='opt'><option>-p</option> <replaceable>arg</replaceable></arg>
          <option>-i</option> <replaceable>arg</replaceable>
          <arg choice='opt'><option>-o</option> <replaceable>arg</replaceable></arg>
          <arg choice='opt'><option>-v</option></arg>
        </arg>
      </group>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1 id='description'>
    <title>DESCRIPTION</title>
    <para>
      <command>lasblock</command> displays LAS file details with optional
      output filters.
      While <command>lasblock</command> can do a few simple operations like
      updating header information, more drastic changes, like removing points
      or altering values, will require
      <citerefentry>
        <refentrytitle>las2las</refentrytitle>
        <manvolnum>1</manvolnum>
      </citerefentry>.
    </para>
  </refsect1>

  <refsect1 id='options'>
    <title>OPTIONS</title>

    <variablelist>

      <varlistentry>
        <term><option>-h</option></term>
        <term><option>--help</option></term>
        <listitem>
          <para>
            Produce help message
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-c</option> <replaceable>arg</replaceable></term>
        <term><option>--capacity</option> <replaceable>arg</replaceable></term>
        <listitem>
          <para>
            Number of points to nominally put into each block
            (note that this number will not be exact).
            Default: 3000
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-p</option> <replaceable>arg</replaceable></term>
        <term><option>--precision</option> <replaceable>arg</replaceable></term>
        <listitem>
          <para>
            Number of decimal points to write for each bbox. Default: 8
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-i</option> <replaceable>arg</replaceable></term>
        <term><option>--input</option> <replaceable>arg</replaceable></term>
        <listitem>
          <para>
            input LAS file
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-o</option> <replaceable>arg</replaceable></term>
        <term><option>--output</option> <replaceable>arg</replaceable></term>
        <listitem>
          <para>
            The output .kdx file (defaults to input filename + .kdx)
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-v</option></term>
        <term><option>--verbose</option></term>
        <listitem>
          <para>
            Verbose message output
          </para>
        </listitem>
      </varlistentry>

    </variablelist>

  </refsect1>

  <refsect1 id='example'>
    <title>EXAMPLE</title>

    <example>
      Block a file, and write out blocks with 6 decimals of precision with a
      nominal capacity of 3000 points per block:

      <screen>
lasblock -c 3001 -p 6 myfile.las
      </screen>
     
      <formalpara> 
        <title>Note</title>
        <para>
          If no capacity is specified with <option>-c</option>,
          <literal>10000</literal> is assumed.
        </para>
      </formalpara> 
      
      <formalpara> 
        <title>Note</title>
        <para> 
          <command>lasblock</command> will always write out a
          <filename>myfile.las.kdx</filename> file name by default,
          but you can override the output name with a
          <option>-o</option> command-line switch.
        </para> 
      </formalpara> 
    </example>

  </refsect1>

</refentry>