1r.object.geometry(1)        GRASS GIS User's Manual       r.object.geometry(1)
2
3
4

NAME

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

KEYWORDS

9       raster, statistics, reclass, clumps
10

SYNOPSIS

12       r.object.geometry
13       r.object.geometry --help
14       r.object.geometry  [-m]  input=name  [output=name]   [separator=charac‐
15       ter]   [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]
16
17   Flags:
18       -m
19           Use meters as units instead of cells
20
21       --overwrite
22           Allow output files to overwrite existing files
23
24       --help
25           Print usage summary
26
27       --verbose
28           Verbose module output
29
30       --quiet
31           Quiet module output
32
33       --ui
34           Force launching GUI dialog
35
36   Parameters:
37       input=name [required]
38           Name of input raster map
39
40       output=name
41           Name for output file
42
43       separator=character
44           Field separator
45           Special characters: pipe, comma, space, tab, newline
46           Default: pipe
47

DESCRIPTION

49       r.object.geometry calculates form statistics of raster objects  in  the
50       input  map and writes it to the output text file (or standard output if
51       no output filename or ’-’ is given), with fields separated by the  cho‐
52       sen  separator.   Objects  are defined as clumps of adjacent cells with
53       the same category value (e.g. output of r.clump or i.segment).
54
55       By default, values are in pixels. If values in meters is  desired,  the
56       user  can set the -m flag. If the current working region is in lat-long
57       or has non-square pixels, using meters is recommended.
58
59       Statistics currently calculated are exactly the same as in v.to.db (ex‐
60       cept for compact_square and mean coordinates):
61
62           •   area
63
64           •   perimeter
65
66           •   compact_square   (compactness   compared   to  a  square:  com‐
67               pact_square = 4 * sqrt(area) / perimeter)
68
69           •   compact_circle (compactness compared to a circle:  compact_cir‐
70               cle = perimeter / ( 2 * sqrt(PI * area) ))
71
72           •   fractal  dimension  (  fd  =  2 * ( log(perimeter) / log(area +
73               0.001) ) )
74
75           •   mean x coordinate of object (in map units)
76
77           •   mean y coordinate of object (in map units)
78

EXAMPLE

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

SEE ALSO

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

AUTHORS

87       Moritz Lennert
88       Markus Metz (diagonal clump tracing)
89

SOURCE CODE

91       Available at: r.object.geometry source code (history)
92
93       Accessed: Saturday Jan 21 21:14:48 2023
94
95       Main index | Raster index | Topics index | Keywords index  |  Graphical
96       index | Full index
97
98       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
99
100
101
102GRASS 8.2.1                                               r.object.geometry(1)
Impressum