← Back to branch summary

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

« back to all changes in this revision

Viewing changes to display/d.vect/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:
display/d.vect/description.html
1
 
<h2>DESCRIPTION</h2>
2
 
 
3
 
<em>d.vect</em> displays GRASS vector data in the active frame on the graphics 
4
 
monitor.
5
 
 
6
 
<h2>NOTES</h2>
7
 
 
8
 
<em>d.vect</em> can simply be used typing <tt>d.vect
9
 
map=vector_map</tt>.  There are a large variety of optional parameters
10
 
which allow the user to specify vector type, colors, data fields, SQL
11
 
queries, label size and justification, etc.
12
 
 
13
 
<p>
14
 
By default <em>d.vect</em> fills in holes in polygons (islands).  If
15
 
you only want to show active areas limit the features with, e.g.,
16
 
<div class="code"><pre>
17
 
d.vect map=vector_map cats=1-999999
18
 
</pre></div>
19
 
 
20
 
<p>
21
 
In order to display attributes in the map, <tt>display=attr</tt> must be
22
 
specified in addition to the column name (<b>attrcol</b> parameter).
23
 
 
24
 
<p>
25
 
Colors may be specified in an attribute table column named 'GRASSRGB'
26
 
(which is a <tt>varchar(11)</tt> column
27
 
containing <tt>RRR:GGG:BBB</tt> values), see the flag <b>-a</b>.
28
 
 
29
 
<p>
30
 
A table for a vector map might look like this:
31
 
 
32
 
<div class="code"><pre>
33
 
db.select sql="select * from testisola"
34
 
cat|label|GRASSRGB
35
 
0|no data|255:255:255
36
 
90|FRASSILONGO|23:245:67
37
 
104|LEVICO|23:145:67
38
 
139|PERGINE VALSUGANA|223:45:237
39
 
168|SANT'ORSOLA|223:45:67
40
 
190|TENNA|123:45:67
41
 
</pre></div>
42
 
 
43
 
<p>
44
 
To add the GRASSRGB color column, use <em><a href="v.db.addcol.html">v.db.addcol</a></em>:
45
 
<div class="code"><pre>
46
 
v.db.addcol map=testisola columns="GRASSRGB varchar(11)"
47
 
</pre></div>
48
 
 
49
 
<p>
50
 
To add/change a color, use <em><a href="v.db.update.html">v.db.update</a></em>:
51
 
<div class="code"><pre>
52
 
v.db.update map=testisola column=GRASSRGB value="123:45:237" where="cat=139"
53
 
</pre></div>
54
 
 
55
 
<p>
56
 
A much simpler method of color coding is by using the <b>-c</b> flag
57
 
which displays vector elements of like category number with a random
58
 
color.
59
 
 
60
 
<p>
61
 
This module can use FreeType/TrueType fonts if they have already been selected with
62
 
<em><a href="d.font.html">d.font</a></em>.
63
 
 
64
 
<p>
65
 
Parameter <b>width</b> is set by default to '0'. XDRIVER specifies the
66
 
precise behaviour for non-zero line width, but drivers have some
67
 
freedom as to how zero-width lines are handled, so they can use the
68
 
hardware's &quot;thin line&quot; drawing primitive, if it has one. A
69
 
width of zero can potentially result in significantly faster operation. On
70
 
drivers where there is no such thing as a "thin" line, the driver will
71
 
use a sensible default (which might not be the same as '1').
72
 
 
73
 
<h2>EXAMPLES</h2>
74
 
 
75
 
Spearfish examples:
76
 
 
77
 
<div class="code"><pre>
78
 
# display roads with category numbers:
79
 
d.vect map=roads display=shape,cat lcolor=green
80
 
 
81
 
# display randomly colorized soils map with attributes
82
 
d.vect -c map=soils display=attr attrcol=label
83
 
 
84
 
# display randomly colorized selected vectors from soils map
85
 
d.vect -c map=soils where="label='VBF'" display=shape,attr attrcol=label
86
 
</pre></div>
87
 
 
88
 
<p>
89
 
3D points, 3D lines and 3D polygons colorized according to z height:
90
 
<div class="code"><pre>
91
 
g.region rast=elevation.10m
92
 
r.random input=elevation.10m n=5000 vector=random3d -d
93
 
d.mon start=x0
94
 
# display as black points
95
 
d.vect map=random3d
96
 
# display 3D points colorized according to z height
97
 
d.vect -z map=random3d zcolor=gyr
98
 
 
99
 
# 3D contour lines
100
 
r.contour input=elevation.10m output=contour20m step=20
101
 
d.vect -z map=contour20m zcolor=gyr
102
 
 
103
 
# generate 3D triangles
104
 
v.delaunay input=random3d output=random3d_del
105
 
# display 3D polygons colorized according to z height
106
 
d.vect -z map=random3d_del type=area zcolor=gyr
107
 
</pre></div>
108
 
 
109
 
<h2>SEE ALSO</h2>
110
 
 
111
 
<em>
112
 
<a href="d.erase.html">d.erase</a>,
113
 
<a href="d.what.vect.html">d.what.vect</a>,
114
 
<a href="d.rast.html">d.rast</a>,
115
 
<a href="d.font.freetype.html">d.font.freetype</a>,
116
 
<a href="v.colors.html">v.colors</a>,
117
 
<a href="v.db.addcol.html">v.db.addcol</a>,
118
 
<a href="v.db.update.html">v.db.update</a><br>
119
 
<a href="sql.html">GRASS SQL interface</a>
120
 
</em>
121
 
 
122
 
<h2>AUTHORS</h2>
123
 
 
124
 
CERL<br>
125
 
Radim Blazek, ITC-Irst, Trento, Italy<br>
126
 
other GRASS developers
127
 
 
128
 
<p>
129
 
<i>Last changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $</i>