'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH pkdumpogr 1 "14 June 2016" "" ""
.SH NAME
pkdumpogr \- dump ogr file to text file or standard output
.SH SYNOPSIS
'nh
.fi
.ad l
\fBpkdumpogr\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
\fB-i\fR \fIinput.txt\fR [\fB-o\fR \fIoutput\fR] [\fIoptions\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBpkdumpogr\fR dumps the content of a vector dataset to
(standard) output (screen or filename).
The default is to dump all the attributes.
Individual attributes can be selected with the option
\*(T<\fB\-n\fR\*(T>.
The X and Y positions can be printed with the option
\*(T<\fB\-pos\fR\*(T>.
Use the option \*(T<\fB\-transpose\fR\*(T> to transpose the output
(only in combination with the option \*(T<\fB\-n\fR\*(T> attribute).
.SH OPTIONS
.TP 
\*(T<\fB\-i\fR\*(T> \fIfilename\fR, \*(T<\fB\-\-input\fR\*(T> \fIfilename\fR
Input shape file
.TP 
\*(T<\fB\-o\fR\*(T> \fIfilename\fR, \*(T<\fB\-\-output\fR\*(T> \fIfilename\fR
Output ASCII file
.TP 
\*(T<\fB\-ln\fR\*(T> \fIlayername\fR, \*(T<\fB\-\-lname\fR\*(T> \fIlayername\fR
Layer name(s) in sample (leave empty to select all)
.TP 
\*(T<\fB\-n\fR\*(T> \fIattribute\fR, \*(T<\fB\-\-name\fR\*(T> \fIattribute\fR
names of the attributes to select.
Each attribute is stored in a separate band.
Default is ALL: write all attributes
.TP 
\*(T<\fB\-pos\fR\*(T>, \*(T<\fB\-\-pos\fR\*(T>
include position (x and y)
.TP 
\*(T<\fB\-t\fR\*(T>, \*(T<\fB\-\-transpose\fR\*(T>
transpose output
(does not work for \*(T<\fB\-n\fR\*(T> ALL)
.TP 
\*(T<\fB\-v\fR\*(T> \fIlevel\fR, \*(T<\fB\-\-verbose\fR\*(T> \fIlevel\fR
verbose (Default: 0)
.SH EXAMPLE
Dump the attributes label and description for the vector dataset
\fIsample.sqlite\fR to standard output (screen)
.PP
.nf
\*(T<
\fBpkdumpogr\fR \fB\-i\fR \fIsample.sqlite\fR \fB\-n\fR \fIlabel\fR \fB\-n\fR \fIdescription\fR

0 2 noforest
1 2 noforest
2 2 noforest
3 2 noforest
4 2 noforest
5 2 noforest
6 2 noforest
7 2 noforest
8 2 noforest
9 2 noforest
10 1 forest
11 2 noforest
      \*(T>
.fi
.PP
Similar to previous example, but transpose output (does not work
without explicitly defining options \*(T<\fB\-n\fR\*(T> for attributes)
.PP
.nf
\*(T<
\fBpkdumpogr\fR \fB\-i\fR \fIsample.sqlite\fR \fB\-n\fR \fIlabel\fR \fB\-n\fR \fIdescription\fR \fB\-t\fR

0 2 2 2 2 2 2 2 2 2 2 1 2
1 noforest noforest noforest noforest noforest noforest noforest noforest noforest noforest forest noforest
      \*(T>
.fi
.PP
Dump the entire content of vector dataset
\fIinput.sqlite\fR to standard output
.PP
.nf
\*(T<
\fBpkdumpogr\fR \fB\-i\fR \fIinput.sqlite\fR
      \*(T>
.fi
.PP
Dump only ATTRIBUTE of vector dataset
\fIinput.sqlite\fR including x and y position and
output to ASCII file \fIoutput.txt\fR
.PP
.nf
\*(T<
\fBpkdumpogr\fR \fB\-i\fR \fIinput.sqlite\fR \fB\-o\fR \fIoutput.txt\fR \fB\-n\fR \fIATTRIBUTE\fR \fB\-pos\fR
      \*(T>
.fi
.SH "SEE ALSO"
\fBpkascii2img\fR(1)