## NAME

d.site.labels - Interactively label sites using a string or double attribute value or the category value on the current graphics monitor.
(GRASS Display Program)

## SYNOPSIS

d.site.labels
d.site.labels -m file=name [attr=string|cat|double|coords|dim] [index=number] [xref=left|center|right] [yref=top|center|bottom] [size=number] [color=colorname] [backgr=colorname] [border=colorname] [font=fontname]

## DESCRIPTION

d.site.labels performs interactive placement of labels for a GRASS sites_list on the current graphics monitor. Labels can be chosen from the category value, a double attribute or a string attribute, the coordinates, or a dimension. The default uses the first string attribute. The index is a number greater than zero for the attribute to use as a label. The user may select the position, color and sizing of the labels. Labels are only drawn within the current region.

This program can be run non-interactively or interactively. If the user gives the name of a GRASS sites_list and (optionally) any other parameters, the command will be run non-interactively. Any parameter left unspecified will be set to its default value (see below). Alternatively, the user can type d.site.labels at the command line and be prompted for the parameter values using the standard GRASS parser interface.

### Parameters:

-m
  Use the mouse to place labels interactively. If the user chooses no, this program behaves similarly to d.sites.label.
  Default: No
file=name
  Name of a GRASS sites_list map in the user's current mapset search path.
attr=string|cat|double|coords|dim
  Type of attribute to use for the label.
  Default: string
index=number
  Index number to the attribute. For instance, 3 would request values from the third attribute column. This option is ignored if the attr option is set to cat or coords.
  Default: 1
xref=left|center|right
  Horizontal label placement in relation to the site point.
  Default: center
yref=top|center|bottom
  Vertical label placement in relation to the site point.
size=number
  The size of letters in pixels.
  Default: 10
color=colorname
  The GRASS colorname to use for the label text.
  Options: red, orange, yellow, green, blue, indigo, violet, magenta, brown, gray, white or black
  Default: white
backgr=colorname
  Color to use for text box background.
  Options: grey, red, white, magenta, brown, blue, indigo, yellow, black, orange, green, violet, none
  Default: none
border=colorname
  Color to use for text box border.
  Options: grey, red, white, magenta, brown, blue, indigo, yellow, black, orange, green, violet, none
  Default: none
font=fontname
  The GRASS fontname to use for the label.
  Options: cyrilc, gothgbt, gothgrt, gothitt, greekc, greekcs, greekp, greeks, italicc, italiccs, italict, romanc, romancs, romand, romans, romant, scriptc or scripts
  Default: romans

## SEE ALSO

d.display
d.icons
d.sites
d.sites.label
d.points
d.rast
d.vect
g.region
parser

## AUTHOR

Eric G. Miller, Unknown others

$Id: d.site.labels.html,v 1.6 2002/01/25 05:45:33 glynn Exp $

Last changed: $Date: 2002/01/25 05:45:33 $