[pktools] 03/06: Add man page for pkascii2ogr.
Bas Couwenberg
sebastic at xs4all.nl
Fri Dec 5 23:19:32 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 a9f3bf18d2b0d1ce99016cb6e67a52d4e82158a9
Author: Bas Couwenberg <sebastic at 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 <sebastic at 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
More information about the Pkg-grass-devel
mailing list