d.grid(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

✨ d.grid(1) ✨

okay bestie, welcome to the GRASS GIS User's Manual entry for d.grid(1) — she's a display module and she's literally here to put a grid on your screen 💅

🎀 NAME 🎀

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

🏷️ KEYWORDS 🏷️

display, cartography, graticule, grid

🌈 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]
[bgcolor=name]   [fontsize=integer]   [--help]  [--verbose]  [--quiet]
[--ui]

🚩 Flags 🚩

  • -a — aligns the origin to the east-north corner of the current region
  • -g — draws a geographic grid (referenced to the current ellipsoid)
  • -w — draws a geographic grid (referenced to the WGS84 ellipsoid)
  • -c — draws '+' marks instead of grid lines
  • -d — draws '.' marks instead of grid lines
  • -f — draws fiducial marks instead of grid lines
  • -n — disables grid drawing
  • -b — disables border drawing
  • -t — disables text drawing
  • --help — prints the usage summary
  • --verbose — verbose module output
  • --quiet — quiet module output
  • --ui — forces the GUI dialog to launch

🧚 Parameters 🧚

  • size=value [required] — the size of the grid to be drawn, in map units. 0 means use the north-south resolution of the current region. Accepts map units or DDD:MM:SS format. Example: "1000" or "0:10"
  • origin=east,north — the 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 an R:G:B triplet. Default: gray
  • border_color=name — border color. Either a standard color name or an R:G:B triplet. Default: black
  • text_color=name — text color. Either a standard color name or an R:G:B triplet. Default: gray
  • bgcolor=name — background color. Either a standard color name, an R:G:B triplet, or "none". Default: none
  • fontsize=integer — font size for the 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 as a geographic grid. no cap 🫶

If you hand her the -g flag, a geographic (projected) grid gets drawn. With -g on, the size argument accepts both decimal degrees and colon separated ddd:mm:ss coordinates (eg. 00:30:00 for half of a degree). And listen — a geographic grid cannot be drawn for a latitude/longitude or XY projection. That's just how it is, bestie. 😭

Colors can be standard named GRASS colors (red, green, aqua, etc.) or a numerical R:G:B triplet, where the component values range from 0-255. Grid color is set with the color option. The text_color and bgcolor options set the color of the text and its background.

  • 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.

Wanna draw grid lines at different intervals, like at high latitudes? Run the module twice: once with direction=east-west at one interval size, and again with direction=north-south at another interval size. two passes, one slay ✨

🦋 EXAMPLES 🦋

To draw a red geographic grid with 30 minute grid spacing, run one of the following commands:

d.grid -g size=00:30:00 color=red

or

d.grid -g size=0.5 color=255:0:0
Figure: Showing a geographic grid in red line color

To draw a blue standard rectangular grid at a 500 (meter) spacing run the following:

d.grid size=500 color=blue
Figure: Showing a rectangular grid in blue line color

👀 SEE ALSO 👀

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

👑 AUTHORS 👑

  • James Westervelt, U.S. Army Construction Engineering Research Laboratory
  • Geogrid support: Bob Covill
  • Border support: Markus Neteler
  • Text and RGB support: Hamish Bowman
  • Background color implemented as part of GSoC 2016 by Adam Laza, CTU in Prague

💻 SOURCE CODE 💻

Available at: d.grid source code (history)

Accessed: Saturday Jan 17 05:40:35 2026

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

and that's the whole page, bestie 🫶 she's serving GRASS 8.4.2, the reference manual is © 2003-2025 GRASS Development Team, and honestly? iconic behavior. periodt. 💅✨

📦 where this page comes from