1v.label.sa(1)               GRASS GIS User's Manual              v.label.sa(1)
2
3
4

NAME

6       v.label.sa  - Create optimally placed labels for vector map(s)
7

KEYWORDS

9       vector, paint labels
10

SYNOPSIS

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

DESCRIPTION

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

EXAMPLE

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

REFERENCES

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

SEE ALSO

136        d.label
137       d.labels
138       ps.map Wikipedia article on simulated annealing
139

AUTHOR

141       Wolf Bergenheim
142

SOURCE CODE

144       Available at: v.label.sa source code (history)
145
146       Main index | Vector index | Topics index | Keywords index  |  Graphical
147       index | Full index
148
149       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
150
151
152
153GRASS 7.8.5                                                      v.label.sa(1)
Impressum