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

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 10:58:18 +0100 (Fri, 28 Nov 2014) $

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

       © 2003-2016 GRASS Development Team, GRASS GIS 7.0.3 Reference Manual

GRASS 7.0.3                                                                                       d.grid(1grass)