r.info(1)

πŸ’– r.info β€” okay bestie, let's read your raster's diary πŸ’–

GRASS GIS User's Manual ✨ this is the r.info(1) page, and it's literally just "tell me everything about my raster map" energy πŸ¦‹


🌸 NAME 🌸

r.info β€” outputs basic information about a raster map. That's it, that's the whole vibe. πŸ’…


πŸŽ€ KEYWORDS πŸŽ€

raster, metadata, extent, history


✨ SYNOPSIS ✨

r.info
r.info --help
r.info [-grseh] map=name  [--help]  [--verbose]  [--quiet]  [--ui]

πŸ”₯ Flags:

  • -g β€” print raster array information in shell script style 🐚
  • -r β€” print range in shell script style πŸ“
  • -s β€” print stats in shell script style πŸ“Š
  • -e β€” print extended metadata information in shell script style πŸ—‚οΈ
  • -h β€” print raster history instead of info πŸ“œ
  • --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. You gotta give it one, bestie, no skipping. πŸ™ˆ

πŸ’œ DESCRIPTION πŸ’œ

r.info reports some basic information about a user-specified raster map layer. That map layer has to exist in the user's current mapset search path β€” no phantom maps, we don't do that here. πŸ‘‘

It takes all the deets β€” the map's boundaries, resolution, projection, data type, category number, project, mapset, project parent directory (database directory), the timestamp and history β€” and puts them into a table, then writes that table to standard output. 🫢

Fun fact: all of that same info is also chillin' in the cats, cellhd, and hist directories under the mapset where the named map is stored. iykyk. 🧚

And bestie, you can save that tabular output to a file using the classic UNIX redirection mechanism (>). For example, if you wanted to save a report on the soils map layer into a file called soil.txt, you'd type:

r.info map=soils > soil.txt

⭐ NOTES ⭐

  • On large maps, the total number of cells in the map may not be displayed with an accurate number. This is only cosmetic β€” it's giving "aesthetic rounding", not a bug. πŸ’…
  • Some standards (ISO-C90) and compilers do not support the 'long long' type as a 64-bit type. If GRASS GIS was built with such a compiler, an accuracy message may be displayed in the output of r.info after Total Cells. πŸ‘€

🌈 EXAMPLES 🌈

Below is a full report produced by r.info for the raster map slope in the North Carolina sample data base:

r.info slope
 +----------------------------------------------------------------------------+
 | Map:      slope                          Date: Tue Nov  7 01:11:23 2006    |
 | Mapset:   PERMANENT                      Login of Creator: helena          |
 | Project:  nc_spm_08_grass7                                                 |
 | DataBase: /grassdata                                                       |
 | Title:    South-West Wake county: slope in degrees ( slope_ned10m )        |
 | Timestamp: none                                                            |
 |----------------------------------------------------------------------------|
 |                                                                            |
 |   Type of Map:  raster               Number of Categories: 255             |
 |   Data Type:    FCELL                                                      |
 |   Rows:         1350                                                       |
 |   Columns:      1500                                                       |
 |   Total Cells:  2025000                                                    |
 |        Projection: Lambert Conformal Conic                                 |
 |            N:     228500    S:     215000   Res:    10                     |
 |            E:     645000    W:     630000   Res:    10                     |
 |   Range of data:    min = 0  max = 38.68939                                |
 |                                                                            |
 |   Data Source:                                                             |
 |    raster elevation file elev_ned10m                                       |
 |                                                                            |
 |                                                                            |
 |   Data Description:                                                        |
 |    generated by r.slope.aspect                                             |
 |                                                                            |
 |   Comments:                                                                |
 |    slope map elev = elev_ned10m                                            |
 |    zfactor = 1.00 format = degrees                                         |
 |    min_slope = 0.000000                                                    |
 |                                                                            |
 +----------------------------------------------------------------------------+

Alternatively, the output from r.info may be confined to a more terse subset of the available information by passing various flags to the module. Less yapping, more vibes. ✨

Output in shell script style, useful for eval (eval \r.info -g slope``):

r.info -g slope
north=228500
south=215000
east=645000
west=630000
nsres=10
ewres=10
rows=1350
cols=1500
cells=2025000
datatype=FCELL
ncats=255

Output the map data range:

r.info -r slope
min=0
max=38.68939

Output the extended map data metadata in shell style:

r.info -e slope
map=slope
mapset=PERMANENT
project=nc_spm_08_grass7
database=/grassdata
date="Tue Nov  7 01:11:23 2006"
creator="helena"
title="South-West Wake county: slope in degrees (slope_ned10m)"
timestamp="none"
units="none"
vdatum="none"
semantic_label="none"
source1="raster elevation file elev_ned10m"
source2=""
description="generated by r.slope.aspect"
comments="slope map elev = elev_ned10mzfactor = 1.00 format = degreesmin_slp_allowed = 0.000000"

πŸ‘‘ SEE ALSO πŸ‘‘

g.mapsets, r.coin, r.describe, r.report, r.stats, r.support, r.univar, r.what


πŸ’– AUTHOR πŸ’–

Michael O'Shea, U.S. Army Construction Engineering Research Laboratory 🫑


πŸ¦‹ SOURCE CODE πŸ¦‹

Available at: r.info source code (history)

Accessed: Saturday Jan 17 05:40:48 2026

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


Β© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual πŸ’–

And that's the whole page, bestie!! This was GRASS 8.4.2, r.info(1), and it's all documented in the GRASS GIS User's Manual β€” go read your rasters' metadata, they deserve the attention. slay, periodt, bye!! πŸ’…βœ¨πŸŽ€

πŸ“¦ where this page comes from