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 <sebas...@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 <sebas...@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 _______________________________________________ Pkg-grass-devel mailing list Pkg-grass-devel@lists.alioth.debian.org http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pkg-grass-devel