.TH v.in.gns 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBv.in.gns\fR\fR  - Imports US-NGA GEOnet Names Server (GNS) country files into a GRASS vector points map.
.SH KEYWORDS
vector, import, gazetteer
.SH SYNOPSIS
\fBv.in.gns\fR
.br
\fBv.in.gns help\fR
.br
\fBv.in.gns file\fR=\fIstring\fR  [\fBvect\fR=\fIstring\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBfile\fR=\fIstring\fR" 4m
.br
Uncompressed GNS file from NGA (with .txt extension)
.IP "\fBvect\fR=\fIstring\fR" 4m
.br
Name for output vector map
.PP
.SH DESCRIPTION
\fIv.in.gns\fR imports US-NGA GEOnet Names Server (GNS) country 
files (Gazetteer data) into a GRASS vector points map. The country files
can be downloaded from the NGA GNS Web Server (see below). The script
generates a vector point map. Only original files can be processed
(unzip compressed file first). These GNS files are encoded in UTF-8 which
is maintained in the GRASS database.
.SH NOTES
The current DB connection is used to write the database table.
.PP
Generally, column names longer that 10 characters are shortened to
10 characters to meet the DBF column name restrictions. If this is a
problem consider choosing another database driver with \fIdb.connect\fR.
.PP
To filter outliers (points outside of a country), the \fIv.select\fR
module can be used to perform point-in-polygon tests. \fIv.select\fR
saves only the GNS points falling into a country polygon into the new
points map.
.SH SEE ALSO
\fI
db.connect,
v.select
\fR
.SH REFERENCES
GEOnet Names Server files for countries and territories
.br
Column names explanations
.SH AUTHOR
Markus Neteler, MPBA Group, ITC-irst, Trento, Italy
.PP
\fILast changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team