← Back to branch summary

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

« back to all changes in this revision

Viewing changes to debian/man/txt2las.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:
debian/man/txt2las.1.xml
 
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='txt2las'>
 
4
 
 
5
  <refmeta>
 
6
    <refentrytitle>txt2las</refentrytitle>
 
7
    <manvolnum>1</manvolnum>
 
8
  </refmeta>
 
9
 
 
10
  <refnamediv>
 
11
    <refname>txt2las</refname>
 
12
    <refpurpose>converts LIDAR data from ASCII format into LAS representation</refpurpose>
 
13
  </refnamediv>
 
14
 
 
15
  <refsynopsisdiv id='synopsis'>
 
16
    <cmdsynopsis>
 
17
      <command>txt2las</command>
 
18
      <group>
 
19
        <arg choice='plain'><option>-h</option></arg>
 
20
        <arg choice='plain'><option>-parse</option> <literal>tsxyz</literal>
 
21
          <replaceable>lidar.txt</replaceable>
 
22
        </arg>
 
23
        <arg choice='plain'><option>-parse</option> <literal>txyzar</literal>
 
24
          <replaceable>lidar.txt.gz lidar.laz</replaceable>
 
25
        </arg>
 
26
        <arg choice='plain'><option>-parse</option> <literal>xyz</literal>
 
27
          <arg choice='opt'><option>-scale</option>
 
28
            <replaceable>0.02</replaceable>
 
29
          </arg>
 
30
          <option>-i</option> <replaceable>lidar.txt</replaceable>
 
31
          <option>-o</option> <replaceable>lidar.laz</replaceable>
 
32
        </arg>
 
33
        <arg choice='plain'><option>-parse</option> <literal>xyzsst</literal>
 
34
          <arg choice='opt'><option>-verbose</option></arg>
 
35
          <arg choice='opt'><option>-scale</option> <replaceable>0.05</replaceable></arg>
 
36
          <replaceable>lidar.txt</replaceable>
 
37
        </arg>
 
38
        <arg choice='plain'><option>-parse</option> <literal>xsysz</literal>
 
39
          <arg choice='opt'><option>-xyz_scale</option> <replaceable>0.02 0.02 0.01</replaceable></arg>
 
40
          <replaceable>lidar.txt</replaceable>
 
41
        </arg>
 
42
      </group>
 
43
    </cmdsynopsis>
 
44
  </refsynopsisdiv>
 
45
 
 
46
  <refsect1 id='description'>
 
47
    <title>DESCRIPTION</title>
 
48
    <para>
 
49
      <command>txt2las</command> converts LIDAR data from a standard
 
50
      ASCII format into the more efficient binary LAS representation.
 
51
    </para>
 
52
  </refsect1>
 
53
 
 
54
  <refsect1 id='options'>
 
55
    <title>OPTIONS</title>
 
56
 
 
57
    <variablelist>
 
58
 
 
59
      <varlistentry>
 
60
        <term><option>-h</option></term>
 
61
        <listitem>
 
62
          <para>
 
63
            produce help message
 
64
          </para>
 
65
        </listitem>
 
66
      </varlistentry>
 
67
 
 
68
      <varlistentry>
 
69
        <term><option>-parse</option> <replaceable>arg</replaceable></term>
 
70
        <listitem>
 
71
          <para>Parsing Flags</para>
 
72
          <para>
 
73
            The '<option>-parse tsxyz</option>' flag specifies how to interpret
 
74
            each line of the ASCII file.
 
75
          </para>
 
76
          <para>
 
77
            For example, '<literal>tsxyzssa</literal>' means that the first
 
78
            number is the gpstime, the next number should be skipped,
 
79
            the next three numbers are the x, y, and z coordinate,
 
80
            the next two should be skipped,
 
81
            and the next number is the scan angle.
 
82
          </para>
 
83
          <para>
 
84
            The other supported entries are:
 
85
            <itemizedlist>
 
86
              <listitem>
 
87
                <para>i - intensity</para>
 
88
              </listitem>
 
89
              <listitem>
 
90
                <para>n - number of returns of given pulse</para>
 
91
              </listitem>
 
92
              <listitem>
 
93
                <para>r - number of return</para>
 
94
              </listitem>
 
95
              <listitem>
 
96
                <para>c - classification</para>
 
97
              </listitem>
 
98
              <listitem>
 
99
                <para>u - user data</para>
 
100
              </listitem>
 
101
              <listitem>
 
102
                <para>p - point source ID</para>
 
103
              </listitem>
 
104
              <listitem>
 
105
                <para>e - edge of flight line flag</para>
 
106
              </listitem>
 
107
              <listitem>
 
108
                <para>d - direction of scan flag.</para>
 
109
              </listitem>
 
110
            </itemizedlist>
 
111
          </para>
 
112
        </listitem>
 
113
      </varlistentry>
 
114
 
 
115
      <varlistentry>
 
116
        <term><option>-scale</option> <replaceable>arg</replaceable></term>
 
117
        <listitem>
 
118
          <para>Scale</para>
 
119
          <para>
 
120
            The '<option>-scale 0.02</option>' flag specifies the quantization.
 
121
          <para>
 
122
          </para>
 
123
            The default value of 0.01 means that the smallest increment two
 
124
            between coordinates is 0.01.
 
125
          <para>
 
126
          </para>
 
127
            If measurements are in meters this corresponds to centimeter
 
128
            accuracy, which is commonly considered sufficient for LIDAR data.
 
129
          </para>
 
130
        </listitem>
 
131
      </varlistentry>
 
132
 
 
133
      <varlistentry>
 
134
        <term><option>-i</option> <replaceable>arg</replaceable></term>
 
135
        <listitem>
 
136
          <para>
 
137
            input LAS file.
 
138
          </para>
 
139
        </listitem>
 
140
      </varlistentry>
 
141
 
 
142
      <varlistentry>
 
143
        <term><option>-o</option> <replaceable>arg</replaceable></term>
 
144
        <listitem>
 
145
          <para>
 
146
            output text file.
 
147
          </para>
 
148
        </listitem>
 
149
      </varlistentry>
 
150
 
 
151
      <varlistentry>
 
152
        <term><option>-xyz_offset</option> <replaceable>500000 2000000 0</replaceable></term>
 
153
      </varlistentry>
 
154
 
 
155
      <varlistentry>
 
156
        <term><option>-xyz_scale</option> <replaceable>0.02 0.02 0.01</replaceable></term>
 
157
      </varlistentry>
 
158
 
 
159
      <varlistentry>
 
160
        <term><option>-file_creation</option> <replaceable>67 2003</replaceable></term>
 
161
      </varlistentry>
 
162
 
 
163
      <varlistentry>
 
164
        <term><option>-system_identifier</option> <replaceable>"Airborne One Leica 50,000 Hz"</replaceable></term>
 
165
      </varlistentry>
 
166
 
 
167
      <varlistentry>
 
168
        <term><option>-generating_software</option> <replaceable>"TerraScan"</replaceable></term>
 
169
      </varlistentry>
 
170
 
 
171
    </variablelist>
 
172
 
 
173
  </refsect1>
 
174
 
 
175
  <refsect1 id='example'>
 
176
    <title>EXAMPLE</title>
 
177
 
 
178
    <example>
 
179
      <title>Simple conversion to text file</title>
 
180
 
 
181
      <screen>
 
182
$ txt2las -i lidar.las -o lidar.txt -parse xyz
 
183
      </screen>
 
184
 
 
185
      converts LAS file to ASCII and places the x, y, and z coordinate
 
186
      of each point at the 1st, 2nd, and 3rd entry of each line.
 
187
      The entries are separated by a space.
 
188
    </example>
 
189
 
 
190
    <example>
 
191
      <screen>
 
192
$ txt2las -i lidar.taxyz -o lidar.las -parse ssxyz
 
193
      </screen>
 
194
 
 
195
      converts ASCII file and uses the 3rd, 4th, and 5th entry of each
 
196
      line as the x, y, and z coordinate of each point.
 
197
    </example>
 
198
 
 
199
    <example>
 
200
      <screen>
 
201
$ txt2las -i lidar.txt.gz -o lidar.las -parse txyzsa
 
202
      </screen>
 
203
 
 
204
      converts a gzipped ASCII file and uses the 1st entry of each line
 
205
      as the gps time, the 3rd, 4th, and 5th entry as the x, y, and z
 
206
      coordinate of each point, and the 6th entry as the scan angle
 
207
    </example>
 
208
 
 
209
  </refsect1>
 
210
 
 
211
</refentry>