1v.label.sa(1) Grass User's Manual v.label.sa(1)
2
3
4
6 v.label.sa - Create optimally placed labels for vector map(s)
7
9 vector, paint labels
10
12 v.label.sa
13 v.label.sa --help
14 v.label.sa map=name [type=string[,string,...]] [layer=string] col‐
15 umn=string labels=name font=string [size=float] [isize=float]
16 [charset=string] [color=string] [hcolor=string] [hwidth=float]
17 [background=string] [opaque=yes|no] [border=string] [width=float]
18 [--help] [--verbose] [--quiet] [--ui]
19
20 Flags:
21 --help
22 Print usage summary
23
24 --verbose
25 Verbose module output
26
27 --quiet
28 Quiet module output
29
30 --ui
31 Force launching GUI dialog
32
33 Parameters:
34 map=name [required]
35 Name of vector map
36 Or data source for direct OGR access
37
38 type=string[,string,...]
39 Input feature type
40 Options: point, line, area
41 Default: point,line,area
42
43 layer=string
44 Layer number or name
45 Vector features can have category values in different layers. This
46 number determines which layer to use. When used with direct OGR
47 access this is the layer name.
48 Default: 1
49
50 column=string [required]
51 Name of attribute column to be used for labels
52
53 labels=name [required]
54 Name for new paint-label file
55
56 font=string [required]
57 Name of TrueType font (as listed in the fontcap)
58
59 size=float
60 Label size (in map-units)
61 Default: 100
62
63 isize=float
64 Icon size of point features (in map-units)
65 Default: 10
66
67 charset=string
68 Character encoding (default: UTF-8)
69 Default: UTF-8
70
71 color=string
72 Text color
73 Options: aqua, black, blue, brown, cyan, gray, green, grey, indigo,
74 magenta, orange, purple, red, violet, white, yellow
75 Default: black
76
77 hcolor=string
78 Highlight color for text
79 Options: none, aqua, black, blue, brown, cyan, gray, green, grey,
80 indigo, magenta, orange, purple, red, violet, white, yellow
81 Default: none
82
83 hwidth=float
84 Width of highlight coloring
85 Default: 0
86
87 background=string
88 Background color
89 Options: none, aqua, black, blue, brown, cyan, gray, green, grey,
90 indigo, magenta, orange, purple, red, violet, white, yellow
91 Default: none
92
93 opaque=yes|no
94 Opaque to vector (only relevant if background color is selected)
95 Options: yes, no
96 Default: yes
97
98 border=string
99 Border color
100 Options: none, aqua, black, blue, brown, cyan, gray, green, grey,
101 indigo, magenta, orange, purple, red, violet, white, yellow
102 Default: none
103
104 width=float
105 Border width (only for ps.map output)
106 Default: 0
107
109 v.label.sa makes a label-file from a GRASS vector map with labels cre‐
110 ated from attributes in the attached table. The labels are placed in as
111 optimal place as possible. The label file has the same syntax as the
112 one created by v.label
113
115 North Carolina example:
116
117 # get font names:
118 d.font -L
119 v.label.sa roadsmajor labels=roads_labels column=ROAD_NAME color=red \
120 background=white size=250 font=Vera
121 # set region:
122 g.region raster=lsat7_2002_10 -p
123 # display:
124 d.rgb b=lsat7_2002_10 g=lsat7_2002_20 r=lsat7_2002_30
125 d.vect roadsmajor col=yellow
126 d.labels roads_labels
127
128 Road labeling with v.label.sa (Raleigh, North Carolina, USA, area)
129
131 Edmondson, Christensen, Marks and Shieber: A General Cartographic
132 Labeling Algorithm, Cartographica, Vol. 33, No. 4, Winter 1996, pp.
133 13-23 The algorithm works by the principle of Simulated Annealing.
134
136 d.label
137 d.labels
138 ps.map Wikipedia article on simulated annealing
139
141 Wolf Bergenheim
142
143 Last changed: $Date: 2014-12-19 22:17:36 +0100 (Fri, 19 Dec 2014) $
144
146 Available at: v.label.sa source code (history)
147
148 Main index | Vector index | Topics index | Keywords index | Graphical
149 index | Full index
150
151 © 2003-2019 GRASS Development Team, GRASS GIS 7.4.4 Reference Manual
152
153
154
155GRASS 7.4.4 v.label.sa(1)