GRASS logo


r.pi.rectangle - Generates a rectangle based on a corner coordinate.


raster, landscape structure analysis, study area


r.pi.rectangle --help
r.pi.rectangle input=name output=name keyval=integer x=integer y=integer alignment=string [title="phrase"] [--overwrite] [--help] [--verbose] [--quiet] [--ui]


Allow output files to overwrite existing files
Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog


input=name [required]
Raster map with single pixels representing sampling points
output=name [required]
Name for output raster map
keyval=integer [required]
Pixel value in the input raster to be used
x=integer [required]
Extent of generated area on the x axis (width) in pixel
y=integer [required]
Extent of generated area on the y axis (height) in pixel
alignment=string [required]
Alignment of the rectangle relative to the input pixel. options: center, top-left, top-right, bottom
Options: center, top-left, top-right, bottom-left, bottom-right
Title for resultant raster map

Table of contents


r.pi.rectangle converts sampling points (e.g. GPS coordinates) of the corner of a sampling site into an area by generating a defined rectangle. Generates a rectangle based on a corner coordinate.

This modules aims at generating sampling areas which are only known by the coordinate of one corner. The input are single points, while the output are areas representing the corresponding area for each of the single points/coordinates.


The areas can only be generated horizontally, not diagonal. This can be added as wish and might be implemented in the future.


An example for the North Carolina sample dataset:
g.region -d


r.pi.corearea,,, r.pi.export, r.pi.graph, r.pi.graph.dec,,, r.pi.grow, r.pi.import, r.pi.index, r.pi.lm, r.pi.odc,, r.pi


Programming: Elshad Shirinov
Scientific concept: Dr. Martin Wegmann
Department of Remote Sensing
Remote Sensing and Biodiversity Unit
University of Wuerzburg, Germany

Port to GRASS GIS 7: Markus Metz


Available at: r.pi.rectangle source code (history)

Latest change: Tuesday Sep 19 09:59:22 2023 in commit: e76c325998c8cd9053ce012a5adbb79f33ab0779

Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

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