GRASS logo

Note: This addon document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade your GRASS GIS installation, and read the current addon manual page.

NAME

d.region.grid - Drapes a color raster over an shaded relief or aspect map.

KEYWORDS

display, elevation, relief, hillshade, visualization

SYNOPSIS

d.region.grid
d.region.grid --help
d.region.grid [-r] [region=name] [raster=name] [color=name] [width=float] [--help] [--verbose] [--quiet] [--ui]

Flags:

-r
Use the current computation region
This will not work in cases when region is handled in a special way such as GUI
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

region=name
Use an existing saved region
raster=name
Use a raster map
color=name
Color
Grid color
Default: gray
width=float
Grid line width

Table of contents

DESCRIPTION

d.region.grid plots a grid defined by the computational region or by a raster map. The computational region can be the current computational region or a saved computational region.

EXAMPLES

Comparing grids of two rasters

To compare how grids (resolutions) of two rasters align, here a digital elevation model and a Landsat image, you can zoom to an area of interest and show grids of both rasters. First, zoom close enough that the raster cells become visible. Here a small saved region is used and a negative value for grow causes g.region to zoom-in even more:
g.region region=rural_1m grow=-250 -p
Start a monitor (skip this in the GUI):
d.mon start=cairo width=600 height=400 output=two_rasters.png
Optionally, show the digital elevation model and its shaded relief raster:
d.shade shade=elevation_shade color=elevation
Add grid for the elevation raster using a subtle color:
d.region.grid raster=elevation color="#9B520D"
Add grid for the Landsat raster using a high-contrast color:
d.region.grid raster=lsat7_2002_10 color=black

Figure: Grids of two rasters which are not aligned

If you are using d.mon, you can stop the monitor using:
d.mon stop=cairo

Showing the current computational region grid

Let's say you want to render grid cells of a computational region you plan to resample a raster map into. First, set the computational region to the raster map, then start the monitor (here we use file-based rendering in the command line with the cairo driver), and finally, render the raster map:
g.region raster=elevation
d.mon start=cairo width=600 height=400 output=new_region_grid.png
d.rast map=elevation
Then change to the desired computational region, here the new region resolution is set to 1000 meters (map units) and fitted into the current region extent without modifying the 1000 meters value.
g.region res=1000 -a
Now, you are ready to plot the grid of the current computational region:
d.region.grid -r

Figure: Raster with resolution 10 meters and grid of a computational region with resolution 1000 meters

Assuming you used d.mon to start rendering as in the code above, you can stop it using:
d.mon stop=cairo

Using an existing saved region

Displaying a saved computational region is extremely helpful in GUI, were you save the current region first:
g.region save=study_area
Then, you use Add command layer to add the following command:
d.region.grid region=study_area

NOTES

SEE ALSO

g.region, d.grid, d.rast.num, d.mon, v.mkgrid

AUTHORS

Vaclav Petras, NCSU GeoForAll Lab

SOURCE CODE

Available at: d.region.grid source code (history)

Latest change: Wed Nov 24 16:10:40 2021 in commit: 7c25cc864df24e1b3d03aedf4d11e61c35b33594


Note: This addon document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade your GRASS GIS installation, and read the current addon manual page.

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

© 2003-2023 GRASS Development Team, GRASS GIS 7.8.8dev Reference Manual