[liblas] 19/23: Add manpage for lasmerge.

[Bas Couwenberg]

This is an automated email from the git hooks/post-receive script.

sebastic-guest pushed a commit to branch master
in repository liblas.

commit faf0f059a0eb441dda5427e8fac4534aa97ec5d8
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date:   Fri Feb 7 22:50:34 2014 +0100

    Add manpage for lasmerge.
---
 debian/liblas-bin.manpages |   1 +
 debian/man/lasmerge.1.xml  | 174 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 175 insertions(+)

diff --git a/debian/liblas-bin.manpages b/debian/liblas-bin.manpages
index 28508be..273e1ef 100644
--- a/debian/liblas-bin.manpages
+++ b/debian/liblas-bin.manpages
@@ -2,3 +2,4 @@ debian/man/las2las.1
 debian/man/las2ogr.1
 debian/man/las2txt.1
 debian/man/lasinfo.1
+debian/man/lasmerge.1
diff --git a/debian/man/lasmerge.1.xml b/debian/man/lasmerge.1.xml
new file mode 100644
index 0000000..75dc1f5
--- /dev/null
+++ b/debian/man/lasmerge.1.xml
@@ -0,0 +1,174 @@
+<?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='lasmerge'>
+
+  <refmeta>
+    <refentrytitle>lasmerge</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>lasmerge</refname>
+    <refpurpose>merge multiple LAS files into a single file</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv id='synopsis'>
+    <cmdsynopsis>
+      <command>lasmerge</command>
+      <group>
+        <arg choice='plain'><option>-h</option></arg>
+        <arg choice='plain'>
+          <arg choice='plain' rep='repeat'><option>-i</option> <replaceable>arg</replaceable></arg>
+          <arg choice='opt'><option>-scale</option> <replaceable>0.01</replaceable></arg>
+          <arg choice='opt'><option>-verbose</option></arg>
+          <arg choice='opt'><option>-olas</option></arg>
+          <arg choice='opt'><option>-o</option> <replaceable>arg</replaceable></arg>
+        </arg>
+      </group>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id='description'>
+    <title>DESCRIPTION</title>
+    <para>
+      <command>lasmerge</command> reads multiple LIDAR data files in the
+      LAS format and merges them into a single file.
+      The filenames can either be provided one by one or in form of a text file.
+    </para>
+    <para>
+      All the header information of the first file provided is used including
+      variable and user_defined headers.
+      But some records are updated by integrating the corresponding information
+      from other headers.
+      These are:
+      <itemizedlist>
+        <listitem>
+          <para>number_of_point_records</para>
+        </listitem>
+        <listitem>
+          <para>number_of_points_by_return[5]</para>
+        </listitem>
+        <listitem>
+          <para>max_x, min_x, max_y, min_y, max_z, and min_z</para>
+        </listitem>
+      </itemizedlist>
+    </para>
+    <para>
+      In addition x_scale_factor, y_scale_factor, z_scale_factor may need to be
+      increased to accommodate a possibly larger bounding box.
+      The user can also set those in the command line with
+    </para>
+    <para>
+      <option>-scale 0.01</option> or <option>-scale_xyz  0.01 0.01 0.001</option>
+    </para>
+    <para>
+      Similarly a new offset can be specified
+    </para>
+    <para>
+      <option>-xyz_offset 63025000 483450000 0</option>
+    </para>
+  </refsect1>
+
+  <refsect1 id='options'>
+    <title>OPTIONS</title>
+
+    <variablelist>
+
+      <varlistentry>
+        <term><option>-h</option></term>
+        <listitem>
+          <para>
+            produce help message
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-i</option> <replaceable>arg</replaceable></term>
+        <listitem>
+          <para>
+            input LAS file.
+            Can be specified multiple times.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-scale</option> <replaceable>0.01</replaceable></term>
+        <listitem>
+          <para>
+            scale input file(s)
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-verbose</option></term>
+        <listitem>
+          <para>
+            verbose output
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-olas</option></term>
+        <listitem>
+          <para>
+            output to STDOUT.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-o</option> <replaceable>arg</replaceable></term>
+        <listitem>
+          <para>
+            output LAS file.
+          </para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </refsect1>
+
+  <refsect1 id='example'>
+    <title>EXAMPLE</title>
+
+    <example>
+      <screen>
+$ lasmerge -i in1.las -i in2.las -i in3.las -o out.las
+      </screen>
+
+      merge the three inX.las files into one out.las file. 
+    </example>
+
+    <example>
+      <screen>
+$ lasmerge -i las_file_list.txt -o out.las
+      </screen>
+
+      merges all LAS files listed in the text file into one out.las file
+    </example>
+
+    <example>
+      <screen>
+$ lasmerge -i las_file_list.txt -o out.las -scale 0.01 -verbose
+      </screen>
+
+      merges the file and stores the LIDAR points with 0.01 accuracy in x, y,
+      and z and prints out control information.
+    </example>
+
+    <example>
+      <screen>
+$ lasmerge -i las_file_list.txt -o out.las -scale_xyz 0.01 0.01 0.001
+      </screen>
+
+      same but with a different accuracy for z.
+    </example>
+
+  </refsect1>
+
+</refentry>

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/liblas.git