---
name: "r.region"
section: "1grass"
platform: "linux"
package: "grass-doc"
version: "8.4.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/r.region"
---

# r.region(1grass)

Sets the boundary definitions for a raster map.

## NAME

**r.region**  - Sets the boundary definitions for a raster map.

## KEYWORDS

raster, metadata, geometry

## SYNOPSIS

**r.region**\
 **r.region --help**\
 **r.region** \[-**cda**\] **map**=*name*  \[**region**=*name*\]   \[**raster**=*name*\]   \[**vector**=*name*\]   \[**n**=*value*\]   \[**s**=*value*\]   \[**e**=*value*\]   \[**w**=*value*\]   \[**align**=*name*\]   \[--**help**\]  \[--**verbose**\]  \[--**quiet**\]  \[--**ui**\]

### Flags:

- **-c**

  Set from current region

- **-d**

  Set from default region

- **-a**

  Auto-adjustment for lat/lon\
   Attempt to fix small precision errors in resolution and extents

- **--help**

  Print usage summary

- **--verbose**

  Verbose module output

- **--quiet**

  Quiet module output

- **--ui**

  Force launching GUI dialog

### Parameters:

- **map**=*name* **\[required\]**

  Name of raster map to change

- **region**=*name*

  Set region from named region

- **raster**=*name*

  Set region to match this raster map

- **vector**=*name*

  Name of vector map\
   Set region to match this vector map

- **n**=*value*

  Value for the northern edge

- **s**=*value*

  Value for the southern edge

- **e**=*value*

  Value for the eastern edge

- **w**=*value*

  Value for the western edge

- **align**=*name*

  Raster map to align to

## DESCRIPTION

The *r.region* program allows the user to manage the boundaries of a raster map. These boundaries can be set by the user directly and/or set from a region definition file (stored under the `windows` directory in the user’s current mapset), a raster or vector map, or a 3dview file.

The **align** parameter sets the current resolution equal to that of the named raster map, and align the boundaries to a row and column edge in the named map.  Alignment only moves the existing boundaries outward to the edges of the next nearest cell in the named raster map -- not to the named map’s edges.  To perform the latter function, use the **raster=***name* option.

## NOTES

After all updates have been applied, the raster map’s resolution settings are recomputed from the boundaries and the number of rows and columns in the raster map.

The n=*value* may also be specified as a function of its current value:  n=n+*value* increases the current northing, while n=n-*value* decreases it.  This is also true for s=*value*, e=*value*, and w=*value*.

## EXAMPLES

Assign absolute coordinates to map:\

```
r.region map=mymap n=220750 s=220000 w=638300 e=639000
```

Shift map (using offset, here by +100 map units in the NS direction, -50 in the EW direction):\

```
r.region map=mymap n=n+100 e=e-50 w=w-50 s=s+100
```

## SEE ALSO

*r.support,* *g.region,* *v.transform*

## AUTHOR

Glynn Clements\
 Based upon *g.region*

## SOURCE CODE

Available at: r.region source code (history)

Accessed: Monday Feb 24 17:50:48 2025

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

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.1 Reference Manual