r.object.geometry(1grass)

Usage

r.object.geometry

r.object.geometry --help

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

Keywords

raster, statistics, reclass, clumps

Overview

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. If the current working region is in lat-long or has non-square pixels, using meters is recommended.

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

•: area

•: perimeter

•: compact_square (compactness compared to a square: compact_square = 4 * sqrt(area) / perimeter)

•: compact_circle (compactness compared to a circle: compact_circle = perimeter / ( 2 * sqrt(PI * area) ))

•: fractal dimension ( fd = 2 * ( log(perimeter) / log(area + 0.001) ) )

•: mean x coordinate of object (in map units)

•: mean y coordinate of object (in map units)

Examples

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

Source code

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

Accessed: Monday Feb 24 17:50:42 2025

Releases

2 releases since Debian 12 (Bookworm); the text changed 1 time.

12
13