GRASS logo

Note: A new GRASS GIS stable version has been released: GRASS GIS 7, available here. And see the new manual page here

NAME - Output basic information about a raster map layer.


raster, metadata

SYNOPSIS help [-rstghudmp] map=name [--verbose] [--quiet]


Print range only
Print raster map resolution (NS-res, EW-res) only
Print raster map type only
Print map region only
Print raster history instead of info
Print raster map data units only
Print raster map vertical datum only
Print map title only
Print raster map timestamp (day.month.year hour:minute:seconds) only
Verbose module output
Quiet module output


Name of input raster map

DESCRIPTION reports some basic information about a user-specified raster map layer. This map layer must exist in the user's current mapset search path. Information about the map's boundaries, resolution, projection, data type, category number, data base location and mapset, the timestamp and history are put into a table and written to standard output. The types of information listed can also be found in the cats, cellhd, and hist directories under the mapset in which the named map is stored.

The user can save the tabular output to a file by using the UNIX redirection mechanism (>); for example, the user might save a report on the soils map layer in a file called soil.rpt by typing: map=soils > soil.rpt


On large maps, the total number of cells in the map may not be displayed with an accurate number. This is only cosmetic.

Some standards (ISO-C90) and compilers do not support the 'long long' type as a 64-bit type. In the case that GRASS was built with such a compiler, an accuracy message may be displayed in the output of after Total Cells:


Below is a full report produced by for the raster map slope in the Spearfish sample data base:
 | Layer:    slope                          Date: Mon Nov  5 10:55:57 2001    |
 | Mapset:   PERMANENT                      Login of Creator: neteler         |
 | Location: spearfish60                                                      |
 | DataBase: /home/neteler/grassdaten                                         |
 | Title:    slope in degrees ( slope )                                       |
 | Timestamp: 20 Mar 1984 10:30 -0600 / 21 Mar 2020 10:30 -0600               |
 |                                                                            |
 |   Type of Map:  raster               Number of Categories: 255             |
 |   Data Type:    FCELL                                                      |
 |   Rows:         477                                                        |
 |   Columns:      634                                                        |
 |   Total Cells:  302418                                                     |
 |        Projection: UTM (zone 13)                                           |
 |            N:    4928010    S:    4913700   Res:    30                     |
 |            E:     609000    W:     589980   Res:    30                     |
 |   Range of data:    min =  0.000000 max = 52.520164                        |
 |                                                                            |
 |   Data Source:                                                             |
 |    raster elevation file elevation.dem                                     |
 |                                                                            |
 |                                                                            |
 |   Data Description:                                                        |
 |    generated by r.slope.aspect                                             |
 |                                                                            |
 |   Comments:                                                                |
 |    slope map elev = elevation.dem                                          |
 |    zfactor = 1.00 format = degrees                                         |
 |    min_slp_allowed = 0.000000                                              |
 |                                                                            |
Alternatively, the output from may be confined to a more terse subset of the available information by passing various flags to the module: -rst slope
datatype=FCELL -g slope


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


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

Last changed: $Date: 2008-05-20 11:26:19 -0700 (Tue, 20 May 2008) $

Main index - raster index - Full index

© 2003-2016 GRASS Development Team