.TH v.label.sa 1grass "" "GRASS 6.4.2" "Grass User's Manual"
.SH NAME
\fI\fBv.label.sa\fR\fR  - Create optimally placed labels for vector map(s)
.SH KEYWORDS
vector, paint labels
.SH SYNOPSIS
\fBv.label.sa\fR
.br
\fBv.label.sa help\fR
.br
\fBv.label.sa map\fR=\fIname\fR  [\fBtype\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBlayer\fR=\fIinteger\fR]  \fBcolumn\fR=\fIname\fR \fBlabels\fR=\fIname\fR \fBfont\fR=\fIstring\fR  [\fBsize\fR=\fIfloat\fR]   [\fBisize\fR=\fIfloat\fR]   [\fBcharset\fR=\fIstring\fR]   [\fBcolor\fR=\fIstring\fR]   [\fBhcolor\fR=\fIstring\fR]   [\fBhwidth\fR=\fIfloat\fR]   [\fBbackground\fR=\fIstring\fR]   [\fBopaque\fR=\fIyes|no\fR]   [\fBborder\fR=\fIstring\fR]   [\fBwidth\fR=\fIfloat\fR]   [\fBoverlap\fR=\fIname\fR]   [--\fBverbose\fR]  [--\fBquiet\fR] 
.SS Parameters:
.IP "\fBmap\fR=\fIname\fR" 4m
.br
Name of input vector map
.IP "\fBtype\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Feature type
.br
Options: \fIpoint,line,area\fR
.br
Default: \fIpoint,line,area\fR
.IP "\fBlayer\fR=\fIinteger\fR" 4m
.br
Layer number
.br
A single vector map can be connected to multiple database tables. This number determines which table to use.
.br
Default: \fI1\fR
.IP "\fBcolumn\fR=\fIname\fR" 4m
.br
Name of attribute column to be used for labels
.IP "\fBlabels\fR=\fIname\fR" 4m
.br
Name for new paint-label file
.IP "\fBfont\fR=\fIstring\fR" 4m
.br
Name of TrueType font (as listed in the fontcap)
.IP "\fBsize\fR=\fIfloat\fR" 4m
.br
Label size (in map-units)
.br
Default: \fI100\fR
.IP "\fBisize\fR=\fIfloat\fR" 4m
.br
Icon size of point features (in map-units)
.br
Default: \fI10\fR
.IP "\fBcharset\fR=\fIstring\fR" 4m
.br
Character encoding (default: UTF-8)
.br
Default: \fIUTF-8\fR
.IP "\fBcolor\fR=\fIstring\fR" 4m
.br
Text color
.br
Options: \fIaqua,black,blue,brown,cyan,gray,green,grey,indigo,magenta,orange,purple,red,violet,white,yellow\fR
.br
Default: \fIblack\fR
.IP "\fBhcolor\fR=\fIstring\fR" 4m
.br
Highlight color for text
.br
Options: \fInone,aqua,black,blue,brown,cyan,gray,green,grey,indigo,magenta,orange,purple,red,violet,white,yellow\fR
.br
Default: \fInone\fR
.IP "\fBhwidth\fR=\fIfloat\fR" 4m
.br
Width of highlight coloring
.br
Default: \fI0\fR
.IP "\fBbackground\fR=\fIstring\fR" 4m
.br
Background color
.br
Options: \fInone,aqua,black,blue,brown,cyan,gray,green,grey,indigo,magenta,orange,purple,red,violet,white,yellow\fR
.br
Default: \fInone\fR
.IP "\fBopaque\fR=\fIyes|no\fR" 4m
.br
Opaque to vector (only relevant if background color is selected)
.br
Options: \fIyes,no\fR
.br
Default: \fIyes\fR
.IP "\fBborder\fR=\fIstring\fR" 4m
.br
Border color
.br
Options: \fInone,aqua,black,blue,brown,cyan,gray,green,grey,indigo,magenta,orange,purple,red,violet,white,yellow\fR
.br
Default: \fInone\fR
.IP "\fBwidth\fR=\fIfloat\fR" 4m
.br
Border width (only for ps.map output)
.br
Default: \fI0\fR
.IP "\fBoverlap\fR=\fIname\fR" 4m
.br
Numeric column to give precedence in case of overlapping labels. The label with a smaller weight is hidden.
.br
Default: \fI\fR
.PP
.SH DESCRIPTION
\fIv.label.sa\fR makes a label-file from a GRASS vector map
with labels created from attributes in the attached table. The labels are
placed in as optimal place as possible. The label file has the same syntax
as the one created by v.label
.SH EXAMPLE
North Carolina example:
.PP
\fC
.DS
.br
# get font names:
.br
d.font -L
.br
.br
v.label.sa roadsmajor labels=roads_labels column=ROAD_NAME color=red \(rs
.br
           background=white size=250 font=Vera
.br
.br
# set region:
.br
g.region rast=lsat7_2002_10 -p
.br
.br
# display:
.br
d.rgb b=lsat7_2002_10 g=lsat7_2002_20 r=lsat7_2002_30
.br
d.vect roadsmajor col=yellow
.br
d.labels roads_labels
.br
.DE
\fR
.PP
\fIRoad labeling with v.label.sa (Raleigh, North Carolina, USA, area)\fR
.SH REFERENCES
Edmondson, Christensen, Marks and Shieber: A General Cartographic
Labeling Algorithm, Cartographica, Vol. 33, No. 4, Winter 1996, pp. 13-23
The algorithm works by the principle of Simulated Annealing.
.SH SEE ALSO
\fI
d.label
.br
d.labels
.br
ps.map
Wikipedia article on simulated annealing
\fR
.br
.SH AUTHOR
Wolf Bergenheim
.br
.PP
\fILast changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2011 GRASS Development Team