.TH d.grid 1grass "" "GRASS 7.2.0" "Grass User's Manual"
.SH NAME
\fI\fBd.grid\fR\fR  \- Overlays a user\-specified grid in the active display frame on the graphics monitor.
.SH KEYWORDS
display, cartography, graticule, grid
.SH SYNOPSIS
\fBd.grid\fR
.br
\fBd.grid \-\-help\fR
.br
\fBd.grid\fR [\-\fBagwcdfnbt\fR] \fBsize\fR=\fIvalue\fR  [\fBorigin\fR=\fIeast,north\fR]   [\fBdirection\fR=\fIstring\fR]   [\fBwidth\fR=\fIfloat\fR]   [\fBcolor\fR=\fIname\fR]   [\fBborder_color\fR=\fIname\fR]   [\fBtext_color\fR=\fIname\fR]   [\fBbgcolor\fR=\fIname\fR]   [\fBfontsize\fR=\fIinteger\fR]   [\-\-\fBhelp\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR]  [\-\-\fBui\fR]
.SS Flags:
.IP "\fB\-a\fR" 4m
.br
Align the origin to the east\-north corner of the current region
.IP "\fB\-g\fR" 4m
.br
Draw geographic grid (referenced to current ellipsoid)
.IP "\fB\-w\fR" 4m
.br
Draw geographic grid (referenced to WGS84 ellipsoid)
.IP "\fB\-c\fR" 4m
.br
Draw \(cq+\(cq marks instead of grid lines
.IP "\fB\-d\fR" 4m
.br
Draw \(cq.\(cq marks instead of grid lines
.IP "\fB\-f\fR" 4m
.br
Draw fiducial marks instead of grid lines
.IP "\fB\-n\fR" 4m
.br
Disable grid drawing
.IP "\fB\-b\fR" 4m
.br
Disable border drawing
.IP "\fB\-t\fR" 4m
.br
Disable text drawing
.IP "\fB\-\-help\fR" 4m
.br
Print usage summary
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.IP "\fB\-\-ui\fR" 4m
.br
Force launching GUI dialog
.SS Parameters:
.IP "\fBsize\fR=\fIvalue\fR \fB[required]\fR" 4m
.br
Size of grid to be drawn (in map units)
.br
0 for north\-south resolution of the current region. In map units or DDD:MM:SS format. Example: \(dq1000\(dq or \(dq0:10\(dq
.IP "\fBorigin\fR=\fIeast,north\fR" 4m
.br
Lines of the grid pass through this coordinate
.br
Default: \fI0,0\fR
.IP "\fBdirection\fR=\fIstring\fR" 4m
.br
Draw only east\-west lines, north\-south lines, or both
.br
Options: \fIboth, east\-west, north\-south\fR
.br
Default: \fIboth\fR
.IP "\fBwidth\fR=\fIfloat\fR" 4m
.br
Grid line width
.IP "\fBcolor\fR=\fIname\fR" 4m
.br
Grid color
.br
Either a standard color name or R:G:B triplet
.br
Default: \fIgray\fR
.IP "\fBborder_color\fR=\fIname\fR" 4m
.br
Border color
.br
Either a standard color name or R:G:B triplet
.br
Default: \fIblack\fR
.IP "\fBtext_color\fR=\fIname\fR" 4m
.br
Text color
.br
Either a standard color name or R:G:B triplet
.br
Default: \fIgray\fR
.IP "\fBbgcolor\fR=\fIname\fR" 4m
.br
Background color
.br
Either a standard color name, R:G:B triplet, or \(dqnone\(dq
.br
Default: \fInone\fR
.IP "\fBfontsize\fR=\fIinteger\fR" 4m
.br
Font size for gridline coordinate labels
.br
Options: \fI1\-72\fR
.br
Default: \fI9\fR
.SH DESCRIPTION
\fId.grid\fR overlays a grid of user\-defined size and
color in the active display frame on the graphics monitor.
The grid can be created as a standard rectangular grid or
a geographic grid.
.PP
If the user provides a \fB\-g\fR flag a geographic (projected) grid
will be drawn. With the \fB\-g\fR flag the \fBsize\fR
argument accepts both decimal degrees and colon separated
ddd:mm:ss coordinates (eg. 00:30:00 for half of a degree).
A geographic grid cannot be drawn for a \fIlatitude/longitude\fR
or \fIXY\fR projection.
.PP
Colors may be standard named GRASS colors (red, green, aqua, etc.) or
a numerical R:G:B triplet, where component values range from 0\-255.
Grid color can be set with option \fBcolor\fR. Options \fBtext_color\fR and
\fBbgcolor\fR set the color of the text and its background.
.PP
The grid drawing may be turned off by using the \fB\-n\fR flag.
.br
The border drawing may be turned off by using the \fB\-b\fR flag.
.br
The coordinate text may be turned off by using the \fB\-t\fR flag.
.br
.PP
To draw grid lines at different intervals, e.g. at high latitudes, you
can run the module twice, once with \fBdirection\fR=\fIeast\-west\fR
at one interval \fBsize\fR, and again with
\fBdirection\fR=\fInorth\-south\fR at another interval \fBsize\fR.
.SH EXAMPLES
To draw a red geographic grid with 30 minute grid spacing, run
either of the following:
.br
.nf
\fC
d.grid \-g size=00:30:00 color=red
\fR
.fi
or
.br
.nf
\fC
d.grid \-g size=0.5 color=255:0:0
\fR
.fi
To draw a blue standard rectangular grid at a 500 (meter) spacing run the following:
.br
.nf
\fC
d.grid size=500 color=blue
\fR
.fi
.SH SEE ALSO
\fI
d.barscale,
d.legend,
d.geodesic,
d.rhumbline,
d.erase,
d.frame,
d.rast,
v.mkgrid
\fR
.SH AUTHORS
James Westervelt, U.S. Army Construction Engineering Research Laboratory
.br
Geogrid support: Bob Covill
.br
Border support: Markus Neteler
.br
Text and RGB support: Hamish Bowman
.br
Background color implemented as part of GSoC 2016 by Adam Laza, CTU in Prague
.PP
\fILast changed: $Date: 2016\-09\-15 14:15:36 +0200 (Thu, 15 Sep 2016) $\fR
.SH SOURCE CODE
.PP
Available at: d.grid source code (history)
.PP
Main index |
Display index |
Topics index |
Keywords index |
Graphical index |
Full index
.PP
© 2003\-2016
GRASS Development Team,
GRASS GIS 7.2.0 Reference Manual