This is an automated email from the git hooks/post-receive script. sebastic-guest pushed a commit to branch master in repository pktools.
commit a9f3bf18d2b0d1ce99016cb6e67a52d4e82158a9 Author: Bas Couwenberg <sebas...@xs4all.nl> Date: Fri Dec 5 19:55:10 2014 +0100 Add man page for pkascii2ogr. --- debian/changelog | 2 +- debian/man/pkascii2ogr.1.xml | 204 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 205 insertions(+), 1 deletion(-) diff --git a/debian/changelog b/debian/changelog index 9f8840d..c166952 100644 --- a/debian/changelog +++ b/debian/changelog @@ -3,7 +3,7 @@ pktools (2.6.1-1) UNRELEASED; urgency=medium * New upstream release. * Refresh patches. * Remove libbase package, library no longer installed. - * Add man page for pkann, pkascii2img. + * Add man page for pkann, pkascii2img, pkascii2ogr. -- Bas Couwenberg <sebas...@xs4all.nl> Wed, 03 Dec 2014 21:16:31 +0100 diff --git a/debian/man/pkascii2ogr.1.xml b/debian/man/pkascii2ogr.1.xml new file mode 100644 index 0000000..c3cd6a8 --- /dev/null +++ b/debian/man/pkascii2ogr.1.xml @@ -0,0 +1,204 @@ +<?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='pkascii2ogr'> + + <refmeta> + <refentrytitle>pkascii2ogr</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>pkascii2ogr</refname> + <refpurpose>program to create vector points or polygons from text file</refpurpose> + </refnamediv> + + <refsynopsisdiv id='synopsis'> + <cmdsynopsis> + <command>pkascii2ogr</command> + <arg choice='opt'><option>-i</option> <replaceable>input</replaceable></arg> + <arg choice='opt'><option>-o</option> <replaceable>output</replaceable></arg> + <arg choice='opt'><option>-f</option> <replaceable>OGRformat</replaceable></arg> + <arg choice='opt'><option>-x</option> <replaceable>col</replaceable></arg> + <arg choice='opt'><option>-y</option> <replaceable>col</replaceable></arg> + <arg choice='opt'><option>-line</option></arg> + <arg choice='opt'><option>-n</option> <replaceable>fieldname</replaceable></arg> + <arg choice='opt'><option>-ot</option> <replaceable>type</replaceable></arg> + <arg choice='opt'><option>-fs</option> <replaceable>separator</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1 id='description'> + <title>DESCRIPTION</title> + <para> + <command>pkascii2ogr</command> creates a vector dataset (points or single + polygon) from an ASCII textfile. + A better alternative is to use + <ulink url="http://www.gdal.org/drv_vrt.html">virtual vector datasets</ulink>. + Specify the position of the vertices (x and y) in the columns defined by + the options (<option>-x</option> <option>-y</option>), starting from 0. + The default is to use the first (<option>-dx</option> 0) and second + (<option>-dx</option> 1) columns for x and y respectvely. + Specify the names and types of the remaining columns in your input file + via the option pairs <option>-n</option> and <option>-ot</option> + respectively. + The default field separator is space. + </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 ASCII file + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-o</option> <replaceable>filename</replaceable></term> + <term><option>--output</option> <replaceable>filename</replaceable></term> + <listitem> + <para> + Output file + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-f</option> <replaceable>OGRformat</replaceable></term> + <term><option>--f</option> <replaceable>OGRformat</replaceable></term> + <listitem> + <para> + Output sample file format + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-x</option> <replaceable>col</replaceable></term> + <term><option>--x</option> <replaceable>col</replaceable></term> + <listitem> + <para> + column number of x (0) + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-y</option> <replaceable>col</replaceable></term> + <term><option>--y</option> <replaceable>col</replaceable></term> + <listitem> + <para> + column number of y (1) + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-l</option></term> + <term><option>--line</option></term> + <listitem> + <para> + create OGRPolygon as geometry instead of points. + Fields are taken from first point and polygon is automatically + closed (no need to repeat first point at last line). + (false: use OGRPoint) + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-n</option> <replaceable>fieldname</replaceable></term> + <term><option>--name</option> <replaceable>fieldname</replaceable></term> + <listitem> + <para> + Field names for the columns in the input ascii file + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-ot</option> <replaceable>type</replaceable></term> + <term><option>--otype</option> <replaceable>type</replaceable></term> + <listitem> + <para> + Field type (Real, Integer, String) for each of the fields as + defined by name + </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> + Override the projection for the output file, + use epsg: or Wkt string + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-fs</option> <replaceable>separator</replaceable></term> + <term><option>--fs</option> <replaceable>separator</replaceable></term> + <listitem> + <para> + field separator. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-v</option> <replaceable>n</replaceable></term> + <term><option>--verbose</option> <replaceable>n</replaceable></term> + <listitem> + <para> + verbose (0) + </para> + </listitem> + </varlistentry> + + </variablelist> + + </refsect1> + + <refsect1 id='example'> + <title>EXAMPLE</title> + + <example> + <para> + Create a vector shape file (<filename>output.shp</filename>) from + input ASCII file (<filename>input.txt</filename>). + The coordinates x (longitude) and y (latitude) can be found in + <filename>input.txt</filename> as columns 3 and 2 respectively + (columns start counting from 0). + The remaining 2 columns in <filename>input.txt</filename> are used + as fields (attributes) of type integer: id (column 0) and + label (column 3). + The projection is set to lat lon (epsg:4326). + </para> + <screen> +<command>pkascii2ogr</command> <option>-i</option> <replaceable>input.txt</replaceable> <option>-o</option> <replaceable>output.shp</replaceable> <option>-x</option> <replaceable>2</replaceable> <option>-x</option> <replaceable>1</replaceable> <option>-n</option> <replaceable>id</replaceable> <option>-ot</option> <replaceable>Integer</replaceable> <option>-n</option> <replaceable>label</replaceable> <option>-ot</option> <replaceable>Integer</replaceable> <option>-a_srs</option> <replacea [...] + </screen> + + </example> + + </refsect1> + + <refsect1 id='see-also'> + <title>SEE ALSO</title> + + <citerefentry> + <refentrytitle> pkascii2img</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + + </refsect1> + +</refentry> -- Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/pktools.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