← Back to branch summary

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

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2014-02-21 11:52:35 UTC
  • mfrom: (7.1.3 sid)
  • Revision ID: package-import@ubuntu.com-20140221115235-b5no1jxy0p4oyj9i
Tags: 1.7.0+dfsg-4
Move python dependencies from Build-Depends-Indep to Build-Depends.

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/man/lasmerge.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='lasmerge'>
 
4
 
 
5
  <refmeta>
 
6
    <refentrytitle>lasmerge</refentrytitle>
 
7
    <manvolnum>1</manvolnum>
 
8
  </refmeta>
 
9
 
 
10
  <refnamediv>
 
11
    <refname>lasmerge</refname>
 
12
    <refpurpose>merge multiple LAS files into a single file</refpurpose>
 
13
  </refnamediv>
 
14
 
 
15
  <refsynopsisdiv id='synopsis'>
 
16
    <cmdsynopsis>
 
17
      <command>lasmerge</command>
 
18
      <group>
 
19
        <arg choice='plain'><option>-h</option></arg>
 
20
        <arg choice='plain'>
 
21
          <arg choice='plain' rep='repeat'><option>-i</option> <replaceable>arg</replaceable></arg>
 
22
          <arg choice='opt'><option>-scale</option> <replaceable>0.01</replaceable></arg>
 
23
          <arg choice='opt'><option>-verbose</option></arg>
 
24
          <arg choice='opt'><option>-olas</option></arg>
 
25
          <arg choice='opt'><option>-o</option> <replaceable>arg</replaceable></arg>
 
26
        </arg>
 
27
      </group>
 
28
    </cmdsynopsis>
 
29
  </refsynopsisdiv>
 
30
 
 
31
  <refsect1 id='description'>
 
32
    <title>DESCRIPTION</title>
 
33
    <para>
 
34
      <command>lasmerge</command> reads multiple LIDAR data files in the
 
35
      LAS format and merges them into a single file.
 
36
      The filenames can either be provided one by one or in form of a text file.
 
37
    </para>
 
38
    <para>
 
39
      All the header information of the first file provided is used including
 
40
      variable and user_defined headers.
 
41
      But some records are updated by integrating the corresponding information
 
42
      from other headers.
 
43
      These are:
 
44
      <itemizedlist>
 
45
        <listitem>
 
46
          <para>number_of_point_records</para>
 
47
        </listitem>
 
48
        <listitem>
 
49
          <para>number_of_points_by_return[5]</para>
 
50
        </listitem>
 
51
        <listitem>
 
52
          <para>max_x, min_x, max_y, min_y, max_z, and min_z</para>
 
53
        </listitem>
 
54
      </itemizedlist>
 
55
    </para>
 
56
    <para>
 
57
      In addition x_scale_factor, y_scale_factor, z_scale_factor may need to be
 
58
      increased to accommodate a possibly larger bounding box.
 
59
      The user can also set those in the command line with
 
60
    </para>
 
61
    <para>
 
62
      <option>-scale 0.01</option> or <option>-scale_xyz  0.01 0.01 0.001</option>
 
63
    </para>
 
64
    <para>
 
65
      Similarly a new offset can be specified
 
66
    </para>
 
67
    <para>
 
68
      <option>-xyz_offset 63025000 483450000 0</option>
 
69
    </para>
 
70
  </refsect1>
 
71
 
 
72
  <refsect1 id='options'>
 
73
    <title>OPTIONS</title>
 
74
 
 
75
    <variablelist>
 
76
 
 
77
      <varlistentry>
 
78
        <term><option>-h</option></term>
 
79
        <listitem>
 
80
          <para>
 
81
            produce help message
 
82
          </para>
 
83
        </listitem>
 
84
      </varlistentry>
 
85
 
 
86
      <varlistentry>
 
87
        <term><option>-i</option> <replaceable>arg</replaceable></term>
 
88
        <listitem>
 
89
          <para>
 
90
            input LAS file.
 
91
            Can be specified multiple times.
 
92
          </para>
 
93
        </listitem>
 
94
      </varlistentry>
 
95
 
 
96
      <varlistentry>
 
97
        <term><option>-scale</option> <replaceable>0.01</replaceable></term>
 
98
        <listitem>
 
99
          <para>
 
100
            scale input file(s)
 
101
          </para>
 
102
        </listitem>
 
103
      </varlistentry>
 
104
 
 
105
      <varlistentry>
 
106
        <term><option>-verbose</option></term>
 
107
        <listitem>
 
108
          <para>
 
109
            verbose output
 
110
          </para>
 
111
        </listitem>
 
112
      </varlistentry>
 
113
 
 
114
      <varlistentry>
 
115
        <term><option>-olas</option></term>
 
116
        <listitem>
 
117
          <para>
 
118
            output to STDOUT.
 
119
          </para>
 
120
        </listitem>
 
121
      </varlistentry>
 
122
 
 
123
      <varlistentry>
 
124
        <term><option>-o</option> <replaceable>arg</replaceable></term>
 
125
        <listitem>
 
126
          <para>
 
127
            output LAS file.
 
128
          </para>
 
129
        </listitem>
 
130
      </varlistentry>
 
131
 
 
132
    </variablelist>
 
133
 
 
134
  </refsect1>
 
135
 
 
136
  <refsect1 id='example'>
 
137
    <title>EXAMPLE</title>
 
138
 
 
139
    <example>
 
140
      <screen>
 
141
$ lasmerge -i in1.las -i in2.las -i in3.las -o out.las
 
142
      </screen>
 
143
 
 
144
      merge the three inX.las files into one out.las file. 
 
145
    </example>
 
146
 
 
147
    <example>
 
148
      <screen>
 
149
$ lasmerge -i las_file_list.txt -o out.las
 
150
      </screen>
 
151
 
 
152
      merges all LAS files listed in the text file into one out.las file
 
153
    </example>
 
154
 
 
155
    <example>
 
156
      <screen>
 
157
$ lasmerge -i las_file_list.txt -o out.las -scale 0.01 -verbose
 
158
      </screen>
 
159
 
 
160
      merges the file and stores the LIDAR points with 0.01 accuracy in x, y,
 
161
      and z and prints out control information.
 
162
    </example>
 
163
 
 
164
    <example>
 
165
      <screen>
 
166
$ lasmerge -i las_file_list.txt -o out.las -scale_xyz 0.01 0.01 0.001
 
167
      </screen>
 
168
 
 
169
      same but with a different accuracy for z.
 
170
    </example>
 
171
 
 
172
  </refsect1>
 
173
 
 
174
</refentry>