NAME
r.describe - Prints terse list of category values found in a raster map layer.
(GRASS Raster Program)
SYNOPSIS
r.describe
r.describe help
r.describe [-1rqd] map=name[nv=string][nsteps=value]
DESCRIPTION
r.describe prints a terse listing of category values found in
a user-specified raster map layer.
OPTIONS
The program will be run non-interactively, if the user specifies
the name of a raster map layer and any desired flags on the
command line, using the form
-
r.describe [-1rqd] map=name
where the map name is the name of a raster map
layer whose categories are to be described, and the
(optional) flags -1, -r, -q, and
-d have the meanings described below.
Alternately, the user can simply type r.describe on the command line,
without program arguments. In this case, the user will be prompted for
needed flag settings and the parameter value using the standard GRASS
parser.
PROGRAM USE
The user can select one of the following two output reports
from r.describe:
- (1) RANGE.
- A range of category values found in the raster map
layer will be printed. The range is divided into three
groups: negative, positive, and zero. If negative values
occur, the minimum and maximum negative values will be
printed. If positive values occur, the minimum and maximum
positive values will be printed. If zero occurs, this will
be indicated.
- (2) FULL LIST.
- A list of all category values that were found in the
raster map layer will be printed.
The following sample output from r.describe:
- 0 2-4 10-13
means that category data values 0, 2 through 4, and 10
through 13 occurred in the named map layer.
The user must choose to read the map layer in one of two ways:
- (1) DIRECTLY.
- The current geographic region and mask are ignored and the full
raster map layer is read. This method is useful if the
user intends to reclassify or
rescale the data, since these functions
(r.reclass and
r.rescale)
also ignore the current geographic region
and mask.
- (2) REGIONED and MASKED.
- The map layer is read within the current geographic region,
masked by the current mask.
NON-INTERACTIVE PROGRAM USE
r.describe examines a user-chosen raster map
layer. If run non-interactively, the layer name must be
supplied on the command line.
A compact list of category values that were found in the
data layer will be printed.
Following is a sample output:
- 0 2-4 10-13
Flags:
- -l
- Print the output one value per line, instead of the
default short form. In the above example, the -1
option would output:
0
2
3
4
10
11
12
13
- -r
- Only print the range of the data. The highest and
lowest positive values, and the highest and lowest negative
values, are output. In the above example, the -r
option would output:
- 0 2 13
If the -1 option is also specified, the output
appears with one category value per line.
- -q
- Quiet. The -q option will tell r.describe to be
silent while reading the raster file. If not specified,
program percentage-completed messages are printed.
- -d
- Use the current geographic region settings. Normally,
r.describe will read the data layer directly,
ignoring both the current region settings and mask. The
-d option tells r.describe to read the map
layer in the current region masked by the current mask (if
any).
Parameters:
- map=name
- Name of raster map.
- nv=string
- String representing no data cell value.
- nsteps=value
- Number of quantization steps.
NOTES
The range report will generally run faster than the full list.
SEE ALSO
g.region, r.mask, r.reclass, r.rescale, parser
AUTHOR
Michael Shapiro, U.S. Army Construction Engineering Research Laboratory