GRASS logo

Note: A new GRASS GIS stable version has been released: GRASS GIS 7.4, available here.
Updated manual page: here

NAME

d.grid - Overlays a user-specified grid in the active display frame on the graphics monitor.

KEYWORDS

display, cartography, graticule

SYNOPSIS

d.grid
d.grid --help
d.grid [-agwcdfnbt] size=value [origin=east,north] [direction=string] [width=float] [color=name] [border_color=name] [text_color=name] [fontsize=integer] [--help] [--verbose] [--quiet] [--ui]

Flags:

-a
Align the origin to the east-north corner of the current region
-g
Draw geographic grid (referenced to current ellipsoid)
-w
Draw geographic grid (referenced to WGS84 ellipsoid)
-c
Draw '+' marks instead of grid lines
-d
Draw '.' marks instead of grid lines
-f
Draw fiducial marks instead of grid lines
-n
Disable grid drawing
-b
Disable border drawing
-t
Disable text drawing
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

size=value [required]
Size of grid to be drawn (in map units)
0 for north-south resolution of the current region. In map units or DDD:MM:SS format. Example: "1000" or "0:10"
origin=east,north
Lines of the grid pass through this coordinate
Default: 0,0
direction=string
Draw only east-west lines, north-south lines, or both
Options: both, east-west, north-south
Default: both
width=float
Grid line width
color=name
Grid color
Either a standard color name or R:G:B triplet
Default: gray
border_color=name
Border color
Either a standard color name or R:G:B triplet
Default: black
text_color=name
Text color
Either a standard color name or R:G:B triplet
Default: gray
fontsize=integer
Font size for gridline coordinate labels
Options: 1-72
Default: 9

Table of contents

DESCRIPTION

d.grid 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. The grid will overlay, not overwrite, the contents of the active display frame.

d.grid can be run non-interactively or interactively. If the user specifies the grid size and (optionally) the grid color on the command line the program will run non-interactively; if no grid color is given the default will be used. Alternately, the user may simply type d.grid on the command line; in this case, the program will prompt the user for parameter values using the standard GRASS graphical user interface.

NOTES

d.grid will not erase grids already displayed in the active graphics display frame by previous invocations of d.grid; multiple invocations of d.grid will therefore result in the drawing of multiple grids inside the active graphics frame. (A command like d.erase, which erases the entire contents of the active display frame, must be run to erase previously drawn grids from the display frame.)

If the user provides a -g flag a geographic (projected) grid will be drawn. With the -g flag the size 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 latitude/longitude or XY projection.

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.

The grid drawing may be turned off by using the -n flag.
The border drawing may be turned off by using the -b flag.
The coordinate text may be turned off by using the -t flag.

To draw grid lines at different intervals, e.g. at high latitudes, you can run the module twice, once with direction=east-west at one interval size, and again with direction=north-south at another interval size.

EXAMPLES

To draw a red geographic grid with 30 minute grid spacing, run either of the following:
d.grid -g size=00:30:00 color=red
or
d.grid -g size=0.5 color=255:0:0
To draw a blue standard rectangular grid at a 500 (meter) spacing run the following:
d.grid size=500 color=blue

SEE ALSO

d.barscale, d.legend, d.geodesic, d.rhumbline, d.erase, d.frame, d.rast

AUTHORS

James Westervelt, U.S. Army Construction Engineering Research Laboratory
Geogrid support: Bob Covill
Border support: Markus Neteler
Text and RGB support: Hamish Bowman

Last changed: $Date: 2014-11-28 01:58:18 -0800 (Fri, 28 Nov 2014) $

SOURCE CODE

Available at: d.grid source code (history)


Note: A new GRASS GIS stable version has been released: GRASS GIS 7.4, available here.
Updated manual page: here

Main index | Display index | Topics index | Keywords index | Full index

© 2003-2018 GRASS Development Team, GRASS GIS 7.0.7svn Reference Manual