.TH r.object.geometry 1grass "" "GRASS 8.3.2" "GRASS GIS User's Manual"
.SH NAME
\fI\fBr.object.geometry\fR\fR  \- Calculates geometry parameters for raster objects.
.SH KEYWORDS
raster, statistics, reclass, clumps
.SH SYNOPSIS
\fBr.object.geometry\fR
.br
\fBr.object.geometry \-\-help\fR
.br
\fBr.object.geometry\fR [\-\fBm\fR] \fBinput\fR=\fIname\fR  [\fBoutput\fR=\fIname\fR]   [\fBseparator\fR=\fIcharacter\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBhelp\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR]  [\-\-\fBui\fR]
.SS Flags:
.IP "\fB\-m\fR" 4m
.br
Use meters as units instead of cells
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-help\fR" 4m
.br
Print usage summary
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.IP "\fB\-\-ui\fR" 4m
.br
Force launching GUI dialog
.SS Parameters:
.IP "\fBinput\fR=\fIname\fR \fB[required]\fR" 4m
.br
Name of input raster map
.IP "\fBoutput\fR=\fIname\fR" 4m
.br
Name for output file
.IP "\fBseparator\fR=\fIcharacter\fR" 4m
.br
Field separator
.br
Special characters: pipe, comma, space, tab, newline
.br
Default: \fIpipe\fR
.SH DESCRIPTION
.PP
\fIr.object.geometry\fR calculates form statistics of raster objects
in the \fBinput\fR map and writes it to the \fBoutput\fR text file
(or standard output if no output filename or \(cq\-\(cq is given),
with fields separated by the chosen \fBseparator\fR.  Objects are defined
as clumps of adjacent cells with the same category value (e.g. output of
\fIr.clump\fR or
\fIi.segment\fR).
.PP
By default, values are in pixels. If values in meters is desired, the user
can set the \fB\-m\fR flag. If the current working region is in lat\-long or
has non\-square pixels, using meters is recommended.
.PP
Statistics currently calculated are exactly the same as in
\fIv.to.db\fR (except for compact_square and
mean coordinates):
.RS 4n
.IP \(bu 4n
area
.IP \(bu 4n
perimeter
.IP \(bu 4n
compact_square (compactness compared to a square:
compact_square = 4 * sqrt(area) / perimeter)
.IP \(bu 4n
compact_circle (compactness compared to a circle:
compact_circle = perimeter / ( 2 * sqrt(PI * area) ))
.IP \(bu 4n
fractal dimension ( fd = 2 * ( log(perimeter) / log(area + 0.001) ) )
.IP \(bu 4n
mean x coordinate of object (in map units)
.IP \(bu 4n
mean y coordinate of object (in map units)
.RE
.SH EXAMPLE
.br
.nf
\fC
g.region raster=soilsID
r.object.geometry input=soilsID output=soils_geom.txt
\fR
.fi
.SH SEE ALSO
\fI
i.segment,
r.clump,
v.to.db
\fR
.SH AUTHORS
Moritz Lennert
.br
Markus Metz (diagonal clump tracing)
.SH SOURCE CODE
.PP
Available at:
r.object.geometry source code
(history)
.PP
Accessed: Thursday Mar 07 18:15:12 2024
.PP
Main index |
Raster index |
Topics index |
Keywords index |
Graphical index |
Full index
.PP
© 2003\-2024
GRASS Development Team,
GRASS GIS 8.3.2 Reference Manual