<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>GRASS GIS: v.what.vect</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.what.vect</b></em> - Uploads vector values at positions of vector points to the table. <h2>KEYWORDS</h2> vector, database, attribute table <h2>SYNOPSIS</h2> <b>v.what.vect</b><br> <b>v.what.vect help</b><br> <b>v.what.vect</b> <b>vector</b>=<em>name</em> [<b>layer</b>=<em>integer</em>] <b>column</b>=<em>string</em> <b>qvector</b>=<em>name</em> [<b>qlayer</b>=<em>integer</em>] <b>qcolumn</b>=<em>string</em> [--<b>verbose</b>] [--<b>quiet</b>] <h3>Parameters:</h3> <DL> <DT><b>vector</b>=<em>name</em></DT> <DD>Points vector map to modify</DD> <DT><b>layer</b>=<em>integer</em></DT> <DD>Layer in the vector to be modified</DD> <DD>Default: <em>1</em></DD> <DT><b>column</b>=<em>string</em></DT> <DD>Column to be updated with the query result</DD> <DT><b>qvector</b>=<em>name</em></DT> <DD>Vector map to be queried</DD> <DT><b>qlayer</b>=<em>integer</em></DT> <DD>Layer of the query vector containg data</DD> <DD>Default: <em>1</em></DD> <DT><b>qcolumn</b>=<em>string</em></DT> <DD>Column to be queried</DD> </DL> <h2>DESCRIPTION</h2> <em>v.what.vect</em> transfers attributes from the <b>qvector</b>'s map attribute table into the attribute table of <u>points</u> present in the <b>vector</b> map. The script is based on <em>v.distance</em>. <h2>NOTES</h2> The upload <b>column</b>, into which the query results are stored, must be present in the <b>vector</b> map. Use <em>v.db.addcol</em> to add one if needed. <p> This module only uploads attributes which exist at the exact positions of the input's <b>vector</b> points. For a "nearest feature" fit, use <em>v.distance</em> instead. <P> In case of a multipoint input <b>vector</b> map, with several points having the same category number, it can happen, that the query result is NULL, if the same category number falls into different <b>qvector</b> polygons. <h2>EXAMPLE</h2> In this example, the 'archsites' point map in the Spearfish location is copied to the current mapset, a new attribute column is added and the owner names from the 'fields' polygon map are transferred to the 'myarchsites' map at points' locations: <div class="code"><pre> g.copy vect=archsites,myarchsites v.db.addcol myarchsites col="owner varchar(25)" v.what.vect myarchsites qvect=fields column=owner qcolumn=label # verification: v.db.select myarchsites </pre></div> <h2>SEE ALSO</h2> <em> <a HREF="v.db.addcol.html">v.db.addcol</a>, <a HREF="v.db.select.html">v.db.select</a>, <a HREF="v.distance.html">v.distance</a>, <a HREF="v.rast.stats.html">v.rast.stats</a>, <a HREF="v.what.rast.html">v.what.rast</a> </em> <h2>AUTHOR</h2> Markus Neteler <p> <i>Last changed: $Date: 2007-06-10 13:23:21 +0200 (Sun, 10 Jun 2007) $</i></p> <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>