v.label.sa(1grass)

v.label.sa1grass

Create optimally placed labels for vector map(s)

Usage

v.label.sa

v.label.sa --help

v.label.sa map=name [type=string [,string, ...]] [layer=string] column=string labels=name font=string [size=float] [isize=float] [charset=string] [color=string] [hcolor=string] [hwidth=float] [background=string] [{opaque=yes | no}] [border=string] [width=float] [--help] [--verbose] [--quiet] [--ui]

Keywords

vector, paint labels

Overview

v.label.sa 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

Examples

North Carolina example:

# get font names:
d.font -L
v.label.sa roadsmajor labels=roads_labels column=ROAD_NAME color=red \
           background=white size=250 font=Vera
# set region:
g.region raster=lsat7_2002_10 -p
# display:
d.rgb b=lsat7_2002_10 g=lsat7_2002_20 r=lsat7_2002_30
d.vect roadsmajor col=yellow
d.labels roads_labels

Road labeling with v.label.sa (Raleigh, North Carolina, USA, area)

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.

Source code

Available at: v.label.sa source code (history)

Accessed: Monday Feb 24 17:51:16 2025

Main index | Vector index | Topics index | Keywords index | Graphical index | Full index

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.1 Reference Manual

Releases

7 releases since Debian 6.0 (Squeeze); the text changed 6 times.

  1. 6.0
  2. 7
  3. 8
  4. 10
  5. 11
  6. 12
  7. 13

Author

Wolf Bergenheim

From grass-doc 8.4.1-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.