[liblas] 07/08: Also include las2las-old program in liblas-bin.
Bas Couwenberg
sebastic at xs4all.nl
Sat Jun 7 16:44:09 UTC 2014
This is an automated email from the git hooks/post-receive script.
sebastic-guest pushed a commit to branch master
in repository liblas.
commit cc2b4e1164046620642e2bc13611556f61a30ff5
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date: Sat Jun 7 16:39:06 2014 +0200
Also include las2las-old program in liblas-bin.
---
debian/changelog | 3 +-
debian/liblas-bin.install | 1 +
debian/liblas-bin.manpages | 1 +
debian/man/las2las-old.1.xml | 528 +++++++++++++++++++++++++++++++++++++++++++
4 files changed, 532 insertions(+), 1 deletion(-)
diff --git a/debian/changelog b/debian/changelog
index a89ed38..443559f 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,7 +2,8 @@ liblas (1.7.0+dfsg-6) UNRELEASED; urgency=medium
* Add build dependency on liblaszip-dev for compression support.
* Use dh_install --list-install.
- * Also include lasblock, ts2las & lasinfo-old programs in liblas-bin.
+ * Also include lasblock, ts2las, las2las-old & lasinfo-old
+ programs in liblas-bin.
-- Bas Couwenberg <sebastic at xs4all.nl> Fri, 06 Jun 2014 13:56:59 +0200
diff --git a/debian/liblas-bin.install b/debian/liblas-bin.install
index e723d1d..e73b788 100644
--- a/debian/liblas-bin.install
+++ b/debian/liblas-bin.install
@@ -1,4 +1,5 @@
/usr/bin/las2las
+/usr/bin/las2las-old
/usr/bin/las2ogr
/usr/bin/las2txt
/usr/bin/lasblock
diff --git a/debian/liblas-bin.manpages b/debian/liblas-bin.manpages
index fcfeda6..942210e 100644
--- a/debian/liblas-bin.manpages
+++ b/debian/liblas-bin.manpages
@@ -1,4 +1,5 @@
debian/man/las2las.1
+debian/man/las2las-old.1
debian/man/las2ogr.1
debian/man/las2txt.1
debian/man/lasblock.1
diff --git a/debian/man/las2las-old.1.xml b/debian/man/las2las-old.1.xml
new file mode 100644
index 0000000..6bf1fe8
--- /dev/null
+++ b/debian/man/las2las-old.1.xml
@@ -0,0 +1,528 @@
+<?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='las2las-old'>
+
+ <refmeta>
+ <refentrytitle>las2las-old</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>las2las-old</refname>
+ <refpurpose>display LAS file details</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>las2las-old</command>
+ <group>
+ <arg choice='plain'><option>-h</option></arg>
+ <arg choice='plain'>
+ <arg choice='opt'><option>-v</option></arg>
+ <arg choice='opt'><option>-s</option></arg>
+ <arg choice='opt'><option>-b</option></arg>
+ <option>--input</option> <replaceable>arg</replaceable>
+ <arg choice='opt'><option>-o</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--stdout</option></arg>
+ <arg choice='opt'><option>--clip</option></arg>
+ <arg choice='opt'><option>--format</option></arg>
+ <arg choice='opt'><option>--eliminate_return</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--eliminate_scan_angle_above</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--eliminate_class</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--eliminate_intensity_below</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--stdin</option></arg>
+ <arg choice='opt'><option>--first_only</option></arg>
+ <arg choice='opt'><option>--last_only</option></arg>
+ <arg choice='opt'><option>--s_srs</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--t_srs</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--a_srs</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--a_vertcs</option> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--scale</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--xyz_scale</option> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--xyz_offset</option> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--pad-header</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--thin</option> <replaceable>arg</replaceable></arg>
+ </arg>
+ </group>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>las2las-old</command> reads and writes LiDAR data in the
+ ASPRS LAS 1.0 and 1.1 formats while modifying its contents.
+ While
+ <citerefentry>
+ <refentrytitle>lasinfo-old</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+ can do a few simple operations like updating header information,
+ more drastic changes, like removing points or altering values,
+ will require <command>las2las-old</command>.
+ <command>las2las-old</command> is expected to be used for modifying
+ single files at a time, and all las2las: Advanced LAS filtering and
+ manipulation operations require multiple read passes through the points.
+ Some examples of operations las2las can be used for include:
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ clipping of points to those that lie within a certain region
+ specified by a bounding box (<option>--clip</option>)
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ eliminating points that are the second return
+ (<option>--eliminate_return 2</option>),
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ eliminating points that have a scan angle above some threshold
+ (<option>--eliminate_scan_angle_above 5</option>)
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ eliminating points that have an intensity below some threshold
+ (<option>--eliminate_intensity_below 15</option>)
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ extracting only first (<option>--first-only</option>)
+ or last (<option>--last-only</option>) returns
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ changing the format from LAS 1.0 to 1.1 or vice versa
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ eliminating points of a given classification
+ (<option>--eliminate_class 2</option>)
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ </para>
+ <para>
+ <command>las2las-old</command> is a port of Martin Isenburg's
+ <command>las2las-old</command> utility from
+ <ulink url="http://www.cs.unc.edu/~isenburg/lastools/">LASTools</ulink>
+ to the libLAS library.
+ For the most part, it is unchanged from Martin's utility except
+ for a few differences:
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ Text output describing the operation(s) is only provided when the
+ <option>--verbose</option> switch is provided.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Provides some point validation
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Variable Length Records (VLRs) are carried forward by default.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Supports format (1.1->1.0 & 1.0->1.1) conversion.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ GNU-style arguments and switches (although most of the switches
+ used by Martin's utilities should continue to work).
+ </para>
+ </listitem>
+
+ </itemizedlist>
+ </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>-v</option></term>
+ <term><option>--verbose</option></term>
+ <listitem>
+ <para>
+ Text output describing the operation(s)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-s</option></term>
+ <term><option>--skip_invalid</option></term>
+ <listitem>
+ <para>
+ Throw out invalid data
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-b</option></term>
+ <term><option>--bulk</option></term>
+ <listitem>
+ <para>
+ Use bulk copy
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--input</option> <replaceable>arg</replaceable></term>
+ <term><option>-input</option> <replaceable>arg</replaceable></term>
+ <term><option>-i</option> <replaceable>arg</replaceable></term>
+ <term><option>-in</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ input LAS file
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--stdout</option></term>
+ <term><option>-olas</option></term>
+ <listitem>
+ <para>
+ Use STDOUT instead of file
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--clip</option> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable></term>
+ <term><option>-clip</option> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable></term>
+ <term><option>-clip_xy</option> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Clipping with a rectangle
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--format</option> <replaceable>arg</replaceable></term>
+ <term><option>-f</option> <replaceable>arg</replaceable></term>
+ <term><option>-format</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Convert to specific version format
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--eliminate_return</option> <replaceable>arg</replaceable></term>
+ <term><option>-eliminate_return</option> <replaceable>arg</replaceable></term>
+ <term><option>-elim_return</option> <replaceable>arg</replaceable></term>
+ <term><option>-elim_ret</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Eliminating specified returns
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--eliminate_scan_angle_above</option> <replaceable>arg</replaceable></term>
+ <term><option>-eliminate_scan_angle_above</option> <replaceable>arg</replaceable></term>
+ <term><option>-elim_scan_angle_above</option> <replaceable>arg</replaceable></term>
+ <term><option>--clip_scan_above</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Limiting based on scan angle
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--eliminate_class</option> <replaceable>arg</replaceable></term>
+ <term><option>-eliminate_class</option> <replaceable>arg</replaceable></term>
+ <term><option>-elim_class</option> <replaceable>arg</replaceable></term>
+ <term><option>--class</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Eliminate ground points
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--eliminate_intensity_below</option> <replaceable>arg</replaceable></term>
+ <term><option>-eliminate_intensity_below</option> <replaceable>arg</replaceable></term>
+ <term><option>-elim_intensity_below</option> <replaceable>arg</replaceable></term>
+ <term><option>--clip_intensity_below</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Limiting based on intensity
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--stdin</option></term>
+ <term><option>-ilas</option></term>
+ <listitem>
+ <para>
+ Read input from STDIN instead of file
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--first_only</option></term>
+ <term><option>-first_only</option></term>
+ <listitem>
+ <para>
+ Eleminate only the first point
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--last_only</option></term>
+ <term><option>-last_only</option></term>
+ <listitem>
+ <para>
+ Eleminate only the last point
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--s_srs</option> <replaceable>arg</replaceable></term>
+ <term><option>-s_srs</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Import assigned SRS
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--t_srs</option> <replaceable>arg</replaceable></term>
+ <term><option>-t_srs</option> <replaceable>arg</replaceable></term>
+ <term><option>-t</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Import output SRS and reproject
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--a_srs</option> <replaceable>arg</replaceable></term>
+ <term><option>-a_srs</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Import output SRS
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--a_vertcs</option> <replaceable>CS Type</replaceable> <replaceable>Citation</replaceable> <replaceable>Datum</replaceable> <replaceable>Units</replaceable></term>
+ <term><option>-a_vertcs</option> <replaceable>CS Type</replaceable> <replaceable>Citation</replaceable> <replaceable>Datum</replaceable> <replaceable>Units</replaceable></term>
+ <listitem>
+ <para>
+ Vertical CS
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--scale</option> <replaceable>arg</replaceable></term>
+ <term><option>-scale</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Set XYZ scale
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--xyz_scale</option> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable></term>
+ <term><option>-xyz_scale</option> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Set XYZ scale
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--xyz_offset</option> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable></term>
+ <term><option>-xyz_offset</option> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Set XYZ offset
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--pad-header</option> <replaceable>arg</replaceable></term>
+ <term><option>-pad-header</option> <replaceable>arg</replaceable></term>
+ <term><option>-ph</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Set header padding
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--thin</option> <replaceable>arg</replaceable></term>
+ <term><option>-y</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Thin output
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+ <refsect1 id='example'>
+ <title>EXAMPLE</title>
+
+ <example>
+ <title>Clipping with a rectangle</title>
+
+ <screen>
+las2las-old --input in.las --output out.las --clip 63025000 483450000 63050000 483475000
+ </screen>
+
+ clips points of <filename>in.las</filename> with x<63025000 or
+ y<483450000 or x>63050000 or y>483475000 and stores surviving
+ points to <filename>out.las</filename>.
+ Note that clip expects the scaled integer values that the points are
+ stored with (not the floating point coordinates they represent).
+ </example>
+
+ <example>
+ <title>Eliminating specified returns</title>
+
+ <screen>
+las2las-old --input in.las --output out.las --eliminate_return 1
+ </screen>
+
+ eliminates all points of <filename>in.las</filename> that are designated
+ first returns by the value in their <literal>return_number</literal>
+ field and stores surviving points to <filename>out.las</filename>.
+ </example>
+
+ <example>
+ <title>Limiting based on scan angle</title>
+
+ <screen>
+las2las-old --input in.las --output out.las --eliminate_scan_angle_above 15
+ </screen>
+
+ eliminates all points of <filename>in.las</filename> whose scan angle is
+ above 15 or below \-15 and stores surviving points to
+ <filename>out.las</filename>.
+ </example>
+
+ <example>
+ <title>Limiting based on intensity</title>
+
+ <screen>
+las2las-old --input in.las --output out.las --eliminate_intensity_below 1000
+ </screen>
+
+ eliminates all points of <filename>in.las</filename> whose intensity is
+ below 1000 and stores surviving points to <filename>out.las</filename>.
+ </example>
+
+ <example>
+ <title>Extract last returns</title>
+
+ <screen>
+las2las-old --input in.las --output out.las --last_only
+ </screen>
+
+ extracts all last return points from <filename>in.las</filename> and
+ stores them to <filename>out.las</filename>.
+ </example>
+
+ <example>
+ <title>Throw out invalid data</title>
+
+ <screen>
+las2las-old --input in.las --output out.las --skip_invalid
+ </screen>
+
+ removes invalid (according to the ASPRS LAS file format specification)
+ points.
+ This switch should only be required in a few special circumstances.
+ </example>
+
+ <example>
+ <title>Eliminate ground points</title>
+
+ <screen>
+las2las-old --input in.las --output out.las --eliminate_class 2
+ </screen>
+
+ removes points with that have a classification of 2.
+ Points with a classification of 2 are conventionally called ground
+ points, but that convention may not be followed for older LAS 1.0 files.
+ </example>
+
+ <example>
+ <title>Convert to 1.1</title>
+
+ <screen>
+las2las-old --input in.las --output out.las --format 1.1
+ </screen>
+
+ converts the in.las file to a 1.1-formatted file.
+ For the most part, this conversion is "in name only".
+ </example>
+
+ </refsect1>
+
+</refentry>
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/liblas.git
More information about the Pkg-grass-devel
mailing list