.TH r.clump 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBr.clump\fR\fR  - Recategorizes data in a raster map by grouping cells that form physically discrete areas into unique categories.
.SH KEYWORDS
raster, statistics, reclass
.SH SYNOPSIS
\fBr.clump\fR
.br
\fBr.clump help\fR
.br
\fBr.clump\fR [\-\fBq\fR] \fBinput\fR=\fIname\fR \fBoutput\fR=\fIname\fR  [\fBtitle\fR=\fI"string"\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-q\fR" 4m
.br
Run quietly
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBinput\fR=\fIname\fR" 4m
.br
Name of input raster map
.IP "\fBoutput\fR=\fIname\fR" 4m
.br
Name for output raster map
.IP "\fBtitle\fR=\fI"string"\fR" 4m
.br
Title for output raster map
.PP
.SH DESCRIPTION
\fIr.clump\fR finds all areas of contiguous cell category values in
the input raster map. It assigns a unique category value to each such
area ("clump") in the resulting output raster map.
.PP
Category distinctions in the input raster map are preserved.  This
means that if distinct category values are adjacent, they will NOT be
clumped together. The user can
run \fIr.reclass\fR prior
to \fIr.clump\fR to recategorize cells and reassign cell category
values.
.SH NOTES
\fIr.clump\fR moves a 2x2 matrix over the input raster map. The
lower right-hand corner of the matrix is grouped with the cells above
it, or to the left of it (diagonal cells are not considered.)
.PP
\fIr.clump\fR works properly with raster map that contain only
\(dqfat" areas (more than a single cell in width). Linear
elements (lines that are a single cell wide) may or may not be clumped
together depending on the direction of the line - horizontal and
vertical lines of cells are considered to be contiguous, but diagonal
lines of cells are not considered to be contiguous and are broken up
into separate clumps.
.PP
A random color table and other support files are generated for the
output raster map.
.SH SEE ALSO
\fI
r.average,
r.buffer,
r.distance,
r.grow,
r.mapcalc,
r.mfilter,
r.neighbors,
r.to.vect,
r.reclass,
r.statistics,
r.support
\fR
.SH AUTHOR
Michael Shapiro, U.S. Army Construction Engineering Research
Laboratory
.PP
\fILast changed: $Date: 2013-11-16 18:04:46 +0100 (Sat, 16 Nov 2013) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team