GRASS logo

NAME

r.object.geometry - Calculates geometry parameters for raster objects.

KEYWORDS

raster, statistics, reclass, clumps

SYNOPSIS

r.object.geometry
r.object.geometry --help
r.object.geometry [-m] input=name [output=name] [separator=character] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-m
Use meters as units instead of cells
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

input=name [required]
Name of input raster map
output=name
Name for output file
separator=character
Field separator
Special characters: pipe, comma, space, tab, newline
Default: pipe

Table of contents

DESCRIPTION

r.object.geometry calculates form statistics of raster objects in the input map and writes it to the output text file (or standard output if no output filename or '-' is given), with fields separated by the chosen separator. Objects are defined as clumps of adjacent cells with the same category value (e.g. output of r.clump or i.segment).

By default, values are in pixels. If values in meters is desired, the user can set the -m flag.

Statistics currently calculated are exactly the same as in v.to.db (except for compact_square):

NOTES

More statistics might be added in the future.

EXAMPLE

g.region raster=soilsID
r.object.geometry input=soilsID output=soils_geom.txt

SEE ALSO

i.segment, r.clump, v.to.db

AUTHORS

Moritz Lennert
Markus Metz (diagonal clump tracing)

Last changed: $Date: 2016-12-03 22:38:19 +0100 (Sat, 03 Dec 2016) $

SOURCE CODE

Available at: r.object.geometry source code (history)


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

© 2003-2017 GRASS Development Team, GRASS GIS 7.2.3svn Reference Manual