[pktools] 02/15: Add man page for pklas2img.

Bas Couwenberg sebastic at xs4all.nl
Fri Dec 12 16:05:17 UTC 2014


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

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

commit f0c6ed9b9af0d925cea866004ba87f4f178060cf
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date:   Sun Dec 7 14:03:11 2014 +0100

    Add man page for pklas2img.
---
 debian/changelog           |   2 +-
 debian/man/pklas2img.1.xml | 302 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 303 insertions(+), 1 deletion(-)

diff --git a/debian/changelog b/debian/changelog
index 6b431f2..92040f1 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -6,7 +6,7 @@ pktools (2.6.1-1) UNRELEASED; urgency=medium
   * Add man page for pkann, pkascii2img, pkascii2ogr, pkcomposite, pkcreatect,
     pkcrop, pkdiff, pkdsm2shadow, pkdumpimg, pkdumpogr, pkegcs, pkextract,
     pkfillnodata, pkfilter, pkfilterascii, pkfilterdem, pkfsann, pkfssvm,
-    pkgetmask, pkinfo.
+    pkgetmask, pkinfo, pklas2img.
 
  -- Bas Couwenberg <sebastic at xs4all.nl>  Wed, 03 Dec 2014 21:16:31 +0100
 
diff --git a/debian/man/pklas2img.1.xml b/debian/man/pklas2img.1.xml
new file mode 100644
index 0000000..0d459b7
--- /dev/null
+++ b/debian/man/pklas2img.1.xml
@@ -0,0 +1,302 @@
+<?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='pklas2img'>
+
+  <refmeta>
+    <refentrytitle>pklas2img</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>pklas2img</refname>
+    <refpurpose>Rasterize LAS/LAZ point clouds with filtering/compositing options</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv id='synopsis'>
+    <cmdsynopsis>
+      <command>pklas2img</command>
+      <arg choice='plain'><option>-i</option> <replaceable>lasfile</replaceable></arg>
+      <arg choice='plain'><option>-o</option> <replaceable>output</replaceable></arg>
+      <arg choice='opt'><replaceable>options</replaceable></arg>
+      <arg choice='opt'><replaceable>advanced options</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id='description'>
+    <title>DESCRIPTION</title>
+    <para>
+      <command>pklas2img</command> converts a las/laz point cloud into a
+      gridded raster dataset.
+      The implementation is based on
+      <ulink url="http://www.liblas.org/">liblas</ulink> API.
+      You can define the bounding box, grid cell size and spatial reference
+      set.
+      The composite rule for multiple returns within a single grid cell can be
+      set with the option <option>-comp</option>.
+      The default attribute is z (heiht), but can also be intensity
+      (if available), the return number (<option>-n</option> return) or the
+      total number of returns in that grid cell (<option>-n</option> nreturn).
+      To select specific returns only, set the option <option>-fir</option>
+      (first, last, single, multiple, or all).
+    </para>
+  </refsect1>
+
+  <refsect1 id='options'>
+    <title>OPTIONS</title>
+    <variablelist>
+
+      <varlistentry>
+        <term><option>-i</option> <replaceable>filename</replaceable></term>
+        <term><option>--input</option> <replaceable>filename</replaceable></term>
+        <listitem>
+          <para>
+            Input las file
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-o</option> <replaceable>filename</replaceable></term>
+        <term><option>--output</option> <replaceable>filename</replaceable></term>
+        <listitem>
+          <para>
+            Output image file
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-n</option> <replaceable>attribute</replaceable></term>
+        <term><option>--name</option> <replaceable>attribute</replaceable></term>
+        <listitem>
+          <para>
+            names of the attribute to select: intensity, return, nreturn, z
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-comp</option> <replaceable>composite</replaceable></term>
+        <term><option>--comp</option> <replaceable>composite</replaceable></term>
+        <listitem>
+          <para>
+            composite for multiple points in cell (min, max, median, mean, sum,
+            first, last, profile (percentile height values), number (point
+            density)).
+            Last: overwrite cells with latest point
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-fir</option> <replaceable>type</replaceable></term>
+        <term><option>--filter</option> <replaceable>type</replaceable></term>
+        <listitem>
+          <para>
+            filter las points (first,last,single,multiple,all).
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-a_srs</option> <replaceable>EPSG:number</replaceable></term>
+        <term><option>--a_srs</option> <replaceable>EPSG:number</replaceable></term>
+        <listitem>
+          <para>
+            assign the projection for the output file in epsg code,
+            e.g., epsg:3035 for European LAEA projection
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-ulx</option> <replaceable>value</replaceable></term>
+        <term><option>--ulx</option> <replaceable>value</replaceable></term>
+        <listitem>
+          <para>
+            Upper left x value bounding box
+            (in geocoordinates if georef is true).
+            0 is read from input file
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-uly</option> <replaceable>value</replaceable></term>
+        <term><option>--uly</option> <replaceable>value</replaceable></term>
+        <listitem>
+          <para>
+            Upper left y value bounding box
+            (in geocoordinates if georef is true).
+            0 is read from input file
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-lrx</option> <replaceable>value</replaceable></term>
+        <term><option>--lrx</option> <replaceable>value</replaceable></term>
+        <listitem>
+          <para>
+            Lower right x value bounding box
+            (in geocoordinates if georef is true).
+            0 is read from input file
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-lry</option> <replaceable>value</replaceable></term>
+        <term><option>--lry</option> <replaceable>value</replaceable></term>
+        <listitem>
+          <para>
+            Lower right y value bounding box
+            (in geocoordinates if georef is true).
+            0 is read from input file
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-dx</option> <replaceable>value</replaceable></term>
+        <term><option>--dx</option> <replaceable>value</replaceable></term>
+        <listitem>
+          <para>
+            Output resolution in x (in meter)
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-dy</option> <replaceable>value</replaceable></term>
+        <term><option>--dy</option> <replaceable>value</replaceable></term>
+        <listitem>
+          <para>
+            Output resolution in y (in meter)
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-ot</option> <replaceable>type</replaceable></term>
+        <term><option>--otype</option> <replaceable>type</replaceable></term>
+        <listitem>
+          <para>
+            Data type for output image
+            ({Byte/Int16/UInt16/UInt32/Int32/Float32/Float64/CInt16/CInt32/CFloat32/CFloat64}).
+            Empty string: inherit type from input image
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-of</option> <replaceable>out_format</replaceable></term>
+        <term><option>--oformat</option> <replaceable>out_format</replaceable></term>
+        <listitem>
+          <para>
+            Output image format (see also
+            <citerefentry>
+              <refentrytitle>gdal_translate</refentrytitle>
+              <manvolnum>1</manvolnum>
+            </citerefentry>).
+            Empty string: inherit from input image
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-ret</option> <replaceable>value</replaceable></term>
+        <term><option>--ret</option> <replaceable>value</replaceable></term>
+        <listitem>
+          <para>
+            number(s) of returns to include
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-class</option> <replaceable>number</replaceable></term>
+        <term><option>--class</option> <replaceable>number</replaceable></term>
+        <listitem>
+          <para>
+            classes to keep:
+             0 (created, never classified),
+             1 (unclassified),
+             2 (ground),
+             3 (low vegetation),
+             4 (medium vegetation),
+             5 (high vegetation),
+             6 (building),
+             7 (low point, noise),
+             8 (model key-point),
+             9 (water),
+            10 (reserved),
+            11 (reserved),
+            12 (overlap)
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-v</option> <replaceable>level</replaceable></term>
+        <term><option>--verbose</option> <replaceable>level</replaceable></term>
+        <listitem>
+          <para>
+            verbose mode
+          </para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+    
+    <para>Advanced options</para>
+    <variablelist>
+
+      <varlistentry>
+        <term><option>-nbin</option> <replaceable>value</replaceable></term>
+        <term><option>--nbin</option> <replaceable>value</replaceable></term>
+        <listitem>
+          <para>
+            Number of percentile bins for calculating percentile height value
+            profile (=number of output bands)
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-nodata</option> <replaceable>value</replaceable></term>
+        <term><option>--nodata</option> <replaceable>value</replaceable></term>
+        <listitem>
+          <para>
+            nodata value to put in image if not valid
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-co</option> <replaceable>option</replaceable></term>
+        <term><option>--co</option> <replaceable>option</replaceable></term>
+        <listitem>
+          <para>
+            Creation option for output file.
+            Multiple options can be specified.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-ct</option> <replaceable>filename</replaceable></term>
+        <term><option>--ct</option> <replaceable>filename</replaceable></term>
+        <listitem>
+          <para>
+            colour table in ASCII format having 5 columns:
+            id R G B ALFA (0: transparent, 255: solid)
+          </para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </refsect1>
+
+</refentry>

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



More information about the Pkg-grass-devel mailing list