~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to vector/v.select/description.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<h2>DESCRIPTION</h2>
2
 
 
3
 
<em>v.select</em> allows the user to select features from a vector 
4
 
map by features from another one.
5
 
 
6
 
<p>Supported operators (without GEOS):
7
 
<ul>
8
 
  <li><b>overlap</b> - features partially or completely overlap
9
 
</ul>
10
 
 
11
 
Supported operators (with GEOS):
12
 
<ul>
13
 
  <li><b>equals</b> - features are spatially equals</li>
14
 
  <li><b>disjoint</b> - features do not spatially intersect</li>
15
 
  <li><b>intersects</b> - features spatially intersect</li>
16
 
  <li><b>touches</b> - features spatially touches</li>
17
 
  <li><b>crosses</b> - features spatially crosses</li>
18
 
  <li><b>within</b> - feature A is completely inside feature B</li>
19
 
  <li><b>contains</b> - feature B is completely inside feature A</li>
20
 
  <li><b>overlaps</b> - features spatially overlap</li>
21
 
  <li><b>relate</b> - feature A is spatially related to feature B</li>
22
 
</ul>
23
 
 
24
 
<h2>NOTES</h2>
25
 
 
26
 
Only features with category numbers will be considered. If required
27
 
the <em><a href="v.category.html">v.category</a></em> module can be
28
 
used to add them. Typically boundaries do not need to be given a
29
 
category number, as an area's attributes are inherited from the
30
 
centroid. Typically points, lines, and centroids will always want to
31
 
have a cat number. E.g. take a road which separates two farms. It is
32
 
ambiguous as to which farm an attribute that is attached to the road
33
 
belongs to. The boundary only needs a cat number if it will hold its
34
 
own attributes, such as road name or pavement form. A centroid in each
35
 
paddock holds the information with respect to ownership, area, etc.
36
 
 
37
 
 
38
 
<h2>EXAMPLES</h2>
39
 
 
40
 
Extract fire stations (points) from urban area map (polygon) - North Carolina
41
 
data set:
42
 
 
43
 
<div class="code"><pre>
44
 
v.select ainput=firestations binput=urbanarea output=urban_firestations \
45
 
         operator=overlap
46
 
</pre></div>
47
 
 
48
 
Extract Italian rivers from VMAP0 watercourses map:
49
 
 
50
 
<div class="code"><pre>
51
 
v.select ainput=watrcrsl_eurnasia_wgs84 binput=italy_area \
52
 
         output=watrcrsl_italy operator=overlap
53
 
</pre></div>
54
 
 
55
 
<h2>TODO</h2>
56
 
 
57
 
Processing areas with GEOS is currently incredibly slow. Significant
58
 
speed-up is required.
59
 
 
60
 
<h2>SEE ALSO</h2>
61
 
 
62
 
<em>
63
 
<a href="v.category.html">v.category</a>,
64
 
<a href="v.overlay.html">v.overlay</a>,
65
 
<a href="v.extract.html">v.extract</a>
66
 
</em>
67
 
 
68
 
<p>
69
 
<a href="sql.html">GRASS SQL interface</a>
70
 
 
71
 
<h2>AUTHORS</h2>
72
 
 
73
 
Radim Blazek<br>
74
 
 
75
 
GEOS support by Martin Landa, Czech Technical University in Prague, Czech Republic
76
 
 
77
 
<p>
78
 
<i>Last changed: $Date: 2012-12-10 11:32:07 +0100 (Mon, 10 Dec 2012) $</i>