## DESCRIPTION

v.select allows the user to select features from a vector map by features from another one.

Supported operators (without GEOS):

- overlap - features partially or completely overlap

Supported operators (with GEOS):

- equals - features are spatially equals
- disjoint - features do not spatially intersect
- intersects - features spatially intersect
- touches - features spatially touches
- crosses - features spatially crosses
- within - feature A is completely inside feature B
- contains - feature B is completely inside feature A
- overlaps - features spatially overlap
- relate - feature A is spatially related to feature B

## NOTES

Only features with category numbers will be considered. If required the v.category module can be used to add them. Typically boundaries do not need to be given a category number, as an area's attributes are inherited from the centroid. Typically points, lines, and centroids will always want to have a cat number. E.g. take a road which separates two farms. It is ambiguous as to which farm an attribute that is attached to the road belongs to. The boundary only needs a cat number if it will hold its own attributes, such as road name or pavement form. A centroid in each paddock holds the information with respect to ownership, area, etc.

## EXAMPLES

Extract fire stations (points) from urban area map (polygon) - North Carolina data set:

    v.select ainput=firestations binput=urbanarea output=urban_firestations \
             operator=overlap

Extract Italian rivers from VMAP0 watercourses map:

    v.select ainput=watrcrsl_eurnasia_wgs84 binput=italy_area \
             output=watrcrsl_italy operator=overlap

## TODO

Processing areas with GEOS is currently incredibly slow. Significant speed-up is required.

## SEE ALSO

v.category, v.overlay, v.extract

GRASS SQL interface

## AUTHORS

Radim Blazek
GEOS support by Martin Landa, Czech Technical University in Prague, Czech Republic

Last changed: $Date: 2012-12-10 02:32:07 -0800 (Mon, 10 Dec 2012) $