Geografic-Information-System/raster/r.object.geometry/r.object.geometry.html

<h2>DESCRIPTION</h2>

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

<p>
By default, values are in pixels. If values in meters is desired, the user
can set the <b>-m</b> flag. If the current working region is in lat-long or 
has non-square pixels, using meters is recommended.

<p>
Statistics currently calculated are exactly the same as in
<em><a href="v.to.db.html">v.to.db</a></em> (except for compact_square and 
mean coordinates):

<ul>
<li>area</li>
<li>perimeter</li>
<li>compact_square (compactness compared to a square: 
  <tt>compact_square = 4 * sqrt(area) / perimeter</tt>)
<li>compact_circle (compactness compared to a circle: 
  <tt>compact_circle = perimeter / ( 2 * sqrt(PI * area) )</tt>)</li>
<li>fractal dimension ( <tt>fd = 2 * ( log(perimeter) / log(area + 0.001) )</tt> )</li>
<li>mean x coordinate of object (in map units)</li>
<li>mean y coordinate of object (in map units)</li>
</ul>

<h2>EXAMPLE</h2>

<div class="code"><pre>
g.region raster=soilsID
r.object.geometry input=soilsID output=soils_geom.txt
</pre></div>

<h2>SEE ALSO</h2>

<em>
<a href="i.segment.html">i.segment</a>,
<a href="r.clump.html">r.clump</a>,
<a href="v.to.db.html">v.to.db</a>
</em>

<h2>AUTHORS</h2>

Moritz Lennert<br>
Markus Metz (diagonal clump tracing)