<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>GRASS GIS: v.in.gns</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <link rel="stylesheet" href="grassdocs.css" type="text/css"> </head> <body bgcolor="white"> <img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade> <h2>NAME</h2> <em><b>v.in.gns</b></em> - Imports US-NGA GEOnet Names Server (GNS) country files into a GRASS vector points map. <h2>KEYWORDS</h2> vector, import, gazetteer <h2>SYNOPSIS</h2> <b>v.in.gns</b><br> <b>v.in.gns help</b><br> <b>v.in.gns</b> <b>file</b>=<em>string</em> [<b>vect</b>=<em>string</em>] [--<b>overwrite</b>] [--<b>verbose</b>] [--<b>quiet</b>] <h3>Flags:</h3> <DL> <DT><b>--overwrite</b></DT> <DD>Allow output files to overwrite existing files</DD> <DT><b>--verbose</b></DT> <DD>Verbose module output</DD> <DT><b>--quiet</b></DT> <DD>Quiet module output</DD> </DL> <h3>Parameters:</h3> <DL> <DT><b>file</b>=<em>string</em></DT> <DD>Uncompressed GNS file from NGA (with .txt extension)</DD> <DT><b>vect</b>=<em>string</em></DT> <DD>Name for output vector map</DD> </DL> <h2>DESCRIPTION</h2> <em>v.in.gns</em> 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. <h2>NOTES</h2> The current DB connection is used to write the database table. <P> Generally, column names longer that 10 characters are shortened to 10 characters to meet the DBF column name restrictions. <P> To filter outliers (points outside of a country), the <em>v.select</em> module can be used to perform point-in-polygon tests. <em>v.select</em> saves only the GNS points falling into a country polygon into the new points map. <h2>SEE ALSO</h2> <em> <a HREF="db.connect.html">db.connect</a>, <a HREF="v.select.html">v.select</a> </em> <H2>REFERENCES</H2> <a href="http://earth-info.nga.mil/gns/html/">GEOnet Names Server files for countries and territories</a><br> <a href="http://earth-info.nga.mil/gns/html/help.htm">Column names explanations</a> <h2>AUTHOR</h2> Markus Neteler, <a href=http://mpa.itc.it>MPBA Group, ITC-irst</a> <p><i>Last changed: $Date: 2007-07-09 16:05:01 +0200 (Mon, 09 Jul 2007) $</i> <HR> <P><a href="index.html">Main index</a> - <a href="vector.html">vector index</a> - <a href="full_index.html">Full index</a></P> <P>© 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p> </body> </html>