Geografic-Information-System/vector/v.sample/v.sample.html

<h2>DESCRIPTION</h2>

<em>v.sample</em> samples a GRASS raster map at the point
locations in the input file by either cubic convolution
interpolation, bilinear interpolation, or nearest neighbor
sampling (default).

<p>This program may be especially useful when sampling for
cross validation of interpolations whose output is a raster
map.

<h2>NOTES</h2>

The output points will have the easting and northing of the input points.
The input category value is used. The input attribute, raster value 
and difference is written to output.

<p>When NULL values are encountered for a cell, zero value is used
instead.  In these cases, more acurrate results may be obtained
by using the default nearest neighbor comparisons.

<p>This program may not work properly with lat-long data when
the <b>-BC</b> flags are used.

<p>When interpolation is done (i.e., the <b>-BC</b> flags are
used), values are assumed to be located at the centroid of
grid cells.  Therefore, current resolution settings are
important.

<h2>EXAMPLE</h2>

Comparison of "elevation.dem" and "elevation.10m" Spearfish maps
at random places:

<div class="code"><pre>
#generate random points:
 v.random output=random n=100
#add table with one column:
 v.db.addtable random col="el10 double"
#transfer elevations at random points into table:
 v.what.rast rast=elevation.10m vect=random col=el10
#verify:
 v.db.select random

#generate sampling from other elevation map:
 v.sample in=random col=el10 rast=elevation.dem out=elev_sample

#verify:
 v.db.select elev_sample

#univariate statistics of differences between elevation maps:
 v.univar elev_sample col=diff type=point
</pre></div>


<h2>SEE ALSO</h2>

<em>
<a href="v.random.html">v.random</a>,
<a href="g.region.html">g.region</a>
</em>


<em>Image Sampling Methods</em> - GRASS Tutorial on <em>s.sample</em>
(available as 
<a href="http://grass.osgeo.org/gdp/sites/">s.sample-tutorial.ps.gz</a>) 


<h2>AUTHOR</h2>

<a href="http://mccauley-usa.com/">James Darrell McCauley</a>
<br>when he was at: 
<a href="http://ABE.www.ecn.purdue.edu/ABE/">Agricultural Engineering</a>
<a href="http://www.purdue.edu/">Purdue University</a>
<p>Updated for GRASS 5.0 by Eric G. Miller
<br>
Updated for GRASS 5.7 by Radim Blazek

<p><i>Last changed: $Date$</i>