[liblas] 06/08: Also include lasinfo-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 06c70bd1820d266b3369935abe52797d3e8e786f
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date: Fri Jun 6 21:16:50 2014 +0200
Also include lasinfo-old program in liblas-bin.
---
debian/changelog | 2 +-
debian/liblas-bin.install | 1 +
debian/liblas-bin.manpages | 1 +
debian/man/lasinfo-old.1.xml | 362 +++++++++++++++++++++++++++++++++++++++++++
4 files changed, 365 insertions(+), 1 deletion(-)
diff --git a/debian/changelog b/debian/changelog
index b7a9403..a89ed38 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,7 +2,7 @@ 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 programs in liblas-bin.
+ * Also include lasblock, ts2las & 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 dca6fcd..e723d1d 100644
--- a/debian/liblas-bin.install
+++ b/debian/liblas-bin.install
@@ -3,6 +3,7 @@
/usr/bin/las2txt
/usr/bin/lasblock
/usr/bin/lasinfo
+/usr/bin/lasinfo-old
/usr/bin/lasmerge
/usr/bin/ts2las
/usr/bin/txt2las
diff --git a/debian/liblas-bin.manpages b/debian/liblas-bin.manpages
index 96570cd..fcfeda6 100644
--- a/debian/liblas-bin.manpages
+++ b/debian/liblas-bin.manpages
@@ -3,6 +3,7 @@ debian/man/las2ogr.1
debian/man/las2txt.1
debian/man/lasblock.1
debian/man/lasinfo.1
+debian/man/lasinfo-old.1
debian/man/lasmerge.1
debian/man/ts2las.1
debian/man/txt2las.1
diff --git a/debian/man/lasinfo-old.1.xml b/debian/man/lasinfo-old.1.xml
new file mode 100644
index 0000000..e7c3231
--- /dev/null
+++ b/debian/man/lasinfo-old.1.xml
@@ -0,0 +1,362 @@
+<?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='lasinfo-old'>
+
+ <refmeta>
+ <refentrytitle>lasinfo-old</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>lasinfo-old</refname>
+ <refpurpose>display LAS file details</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>lasinfo-old</command>
+ <group>
+ <arg choice='plain'><option>-h</option></arg>
+ <arg choice='plain'><option>-v</option></arg>
+ <arg choice='plain'>
+ <option>--input</option> <replaceable>arg</replaceable>
+ <arg choice='opt'><option>--[no]check</option></arg>
+ <arg choice='opt'><option>--stdin</option></arg>
+ <arg choice='opt'><option>--repair</option></arg>
+ <arg choice='opt'><option>--repair_bb</option></arg>
+ <arg choice='opt'><option>--system_identifier</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--generating_software</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--file_creation</option> <replaceable>arg</replaceable></arg>
+ <arg choice='opt'><option>--skip_vlr</option></arg>
+ </arg>
+ </group>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>lasinfo-old</command> prints the header contents by default,
+ and with a switch, can be used to print a short summary of the points.
+ When in summary mode (using the <option>--check</option> switch),
+ differences between header info and point content are reported as
+ warnings.
+ <command>lasinfo-old</command> prints its information to stderr,
+ and you can use pipes to redirect the output of
+ <command>lasinfo-old</command> as necessary.
+ <command>lasinfo-old</command> supports reading from stdin,
+ but it does not attempt to read from stdin if the
+ <option>--stdin</option> switch is not used.
+ <command>lasinfo-old</command> can also be used to modify a few header
+ entries in-place as described in the examples.
+ </para>
+ <para>
+ <command>lasinfo-old</command> is a port of Martin Isenburg's
+ <command>lasinfo-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>
+ It does <emphasis>not</emphasis> scan the points by default and
+ instead you must use the <option>--check</option> switch to have
+ them scanned.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ It <emphasis>does</emphasis> print the Variable Length Records
+ (VLRs) by default.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Slightly different (and tidier) output format.
+ </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>--version</option></term>
+ <listitem>
+ <para>
+ Display version number
+ </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>--points</option></term>
+ <term><option>--check</option></term>
+ <term><option>--check_points</option></term>
+ <term><option>-c</option></term>
+ <term><option>-points</option></term>
+ <term><option>-check</option></term>
+ <term><option>-check_points</option></term>
+ <listitem>
+ <para>
+ Check the points for header inconsistencies
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--nocheck</option></term>
+ <term><option>-nocheck</option></term>
+ <listitem>
+ <para>
+ Don't check the points for header inconsistencies
+ </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>--repair</option></term>
+ <term><option>-r</option></term>
+ <term><option>-repair_header</option></term>
+ <term><option>-repair</option></term>
+ <listitem>
+ <para>
+ Repair missing or inconsistent header information
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--repair_bb</option></term>
+ <term><option>--repair_bounding_box</option></term>
+ <term><option>--repair_boundingbox</option></term>
+ <term><option>-repair_bb</option></term>
+ <term><option>-repair_bounding_box</option></term>
+ <term><option>-repair_boundingbox</option></term>
+ <term><option>-repair</option></term>
+ <term><option>-rb</option></term>
+ <listitem>
+ <para>
+ Update bounding box of LAS file
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--system_identifier</option> <replaceable>arg</replaceable></term>
+ <term><option>-system_identifier</option> <replaceable>arg</replaceable></term>
+ <term><option>-s</option> <replaceable>arg</replaceable></term>
+ <term><option>-sys_id</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Set system identifier
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--generating_software</option> <replaceable>arg</replaceable></term>
+ <term><option>-generating_software</option> <replaceable>arg</replaceable></term>
+ <term><option>-g</option> <replaceable>arg</replaceable></term>
+ <term><option>-gen_soft</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Set generating software header field
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--file_creation</option> <replaceable>arg</replaceable></term>
+ <term><option>-file_creation</option> <replaceable>arg</replaceable></term>
+ <listitem>
+ <para>
+ Set file creation date
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--skip_vlr</option></term>
+ <term><option>--no_vlr</option></term>
+ <listitem>
+ <para>
+ Skip the printing of Variable Record Headers (VLRs)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--wkt</option></term>
+ <listitem>
+ <para>
+ Also display WKT for SRS
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+ <refsect1 id='example'>
+ <title>EXAMPLE</title>
+
+ <example>
+ <title>Simple header inspection</title>
+
+ <screen>
+lasinfo-old lidar.las
+lasinfo-old --input lidar.las
+ </screen>
+ </example>
+
+ <example>
+ <title>Read from STDIN</title>
+
+ <screen>
+lasinfo-old --stdin < lidar.las
+ </screen>
+ </example>
+
+ <example>
+ <title>Variable Header Records</title>
+
+ <screen>
+lasinfo-old --input lidar.las -skip_vlr
+ </screen>
+
+ will skip the printing of Variable Record Headers (VLRs) for the file.
+ </example>
+
+ <example>
+ <title>Check the points for header inconsistencies</title>
+
+ <screen>
+lasinfo-old --input lidar.las --check
+ </screen>
+
+ scans over all the points and reports any differences with the header.
+ Descriptive information like minimums and maximums of various variables
+ (time, x, y, z, etc) and some basic histograms are also reported.
+ </example>
+
+ <example>
+ <title>Repair missing or inconsistent header information</title>
+
+ <screen>
+lasinfo-old --input lidar.las --repair
+ </screen>
+
+ will add missing or repair inconsistent header entries with respect to
+ the points.
+ Items that are repaired with <option>--repair</option> include the
+ bounding box header entries and the point records by return count.
+ Future versions of the software may include other header repair types if
+ they can be done in such a way as to not require rewriting of the file.
+ </example>
+
+ <example>
+ <title>Update bounding box of LAS file</title>
+
+ <screen>
+lasinfo-old --input lidar.las --repair_boundingbox
+ </screen>
+
+ reads all points, computes their bounding box, and updates it in the header.
+ </example>
+
+ <example>
+ <title>Set file creation date</title>
+
+ <screen>
+lasinfo-old -i lidar.las --file_creation 8 2007
+ </screen>
+
+ sets the file creation day/year in the header to 8/2007.
+ With accordance to the ASPRS LAS specification,
+ this literally means the 8th day of 2007.
+ </example>
+
+ <example>
+ <title>Set system identifier</title>
+
+ <screen>
+lasinfo-old -i lidar.las --system_identifier "hello world"
+ </screen>
+
+ copies the first 31 characters of the string into the
+ <literal>system_identifier</literal> field of the header.
+ </example>
+
+ <example>
+ <title>Set generating software header field</title>
+
+ <screen>
+lasinfo-old -i lidar.las -generating_software "this is a test (-:"
+ </screen>
+
+ copies the first 31 characters of the string into the
+ <literal>generating_software</literal> field of the header.
+ </example>
+
+ <example>
+ <title>Example data</title>
+
+ Visit the libLAS sample library for LiDAR data in LAS format:
+
+ <ulink url="http://liblas.org/samples/">http://liblas.org/samples/</ulink>
+ </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