d.rhumbline

NAME

d.rhumbline - Displays the rhumbline joining two user-specified points, in the active frame on the user's graphics monitor.
(GRASS Display Program)

SYNOPSIS

d.rhumbline
d.rhumbline help
d.rhumbline coor=lon1,lat1,lon2,lat2 [lcolor=name]

DESCRIPTION

A rhumbline is a line following a constant angle of the compass (i.e., a line of constant direction). There are 32 points on the compass (points are roughly 11 degrees 15 minutes apart). d.rhumbline displays the rhumbline joining any two user-specified points in the active frame on the user's graphics monitor. The named coordinate locations must fall within the boundaries of the user's current geographic region.

The user can run this program either interactively or non-interactively. If the user simply types d.rhumbline on the command line without specifying parameter values, the mouse will be activated and the user will be asked to use the mouse to indicate the two endpoints of the rhumbline. The rhumbline is then drawn in the default color (white). The program also outputs the coordinate locations of the two endpoints on the user's terminal and the number associated with the mouse button depressed by the user in a format useful for input to other programs.

Alternately, the user can specify the starting and ending longitude/latitude coordinates of the rhumbline and (optionally) the color in which the rhumbline will be displayed; in this case, the program will run non-interactively.

OPTIONS

Parameters:

coor=lon1,lat1,lon2,lat2: Starting and ending coordinates of the rhumblines to be displayed, given as longitudes and latitudes.
lcolor=name: Rhumbline color.
Options: red, orange, yellow, green, blue, magenta, indigo, violet, gray, white, black
Default: white

NOTES

This program works only with longitude-latitude data bases.

AUTHOR

Michael Shapiro, U.S. Army Construction Engineering Research Laboratory