NAME

d.points - Displays point graphics in the active frame on the graphics display monitor.
(GRASS Display Program)

SYNOPSIS

d.points
d.points help
d.points [color=name] [size=value] [type=name] [file=name]

DESCRIPTION

d.points displays points whose coordinate locations are specified by the user and located within the current geographic region in the active display frame on the graphics monitor. Point coordinates are read either from standard input or from a file stated by the file=name option. When entering coordinates through standard input, the user presses control-d to signal the end of input to d.points.

OPTIONS

The program can be run interactively or non-interactively. The user can run the program completely non-interactively by specifying the name of a points file (containing the geographic coordinates of icons to be sited) and the values of all needed parameters on the command line. If the name of an input file to d.points is given on the command line, any other parameter values left unspecified on the command line (e.g., the icon color, size, and/or type) are set to their default values.

The user can instead elect to run the program partially interactively, by specifying any/all of the parameters except the points file=name parameter on the command line. In this case, d.points will expect the user to enter icon locations from standard input (i.e., at the keyboard) and will prompt the user for these locations. Each icon location should be entered as an easting and northing pair separated by a space, followed by a carriage return. Coordinates should be stated in whatever map coordinate system is used by the user's current GRASS location. The user presses control-d to signal the end of standard input to d.points.

Alternately, the user can simply type d.points on the command line, and be prompted for the values of all parameters (the user can still input icon coordinates from an input file using this form). In this case, the user is presented with the standard GRASS parser interface.

Parameters:

color=name
Sets the current color to the name stated.
Options: red, orange, yellow, green, blue, indigo, violet, gray, white, and black
Default: gray
size=value
Size of icon in pixels.
Options: 0-1000 (pixels)
Default: 5 (pixels)
type=name
Sets the shape (type) of the icon to be drawn to name.
Options: x, diamond, box, +
Default: +
file=name
Take input from the UNIX file name. (Note: This file must be in the user's current directory or given by its full path name.)
Default: Standard input.
The file contents should consist of a series of geographic coordinates that fit within the boundaries of the current geographic region falling within the active display frame (refer to d.where or g.region for these coordinates). Each icon location should be specified by an easting and northing (in that order) separated by a single blank space, and followed by a carriage return. Eastings and northings should be stated in whatever map coordinate system is being used by the user's current GRASS location.

NOTES

d.points will display a point at the location specified in the active frame, even if the point lies outside the boundaries of current geographic region.

SEE ALSO

d.frame
d.where
d.sites
g.region
s.out.ascii
parser

AUTHOR

James Westervelt, U.S. Army Construction Engineering Research Laboratory