Note: This document is for an older version of GRASS GIS that has been discontinued. You should upgrade, and read the current manual page.

GRASS logo

NAME

r.centroids - Creates vector map of centroids from raster of "clumps".

KEYWORDS

raster, centroid, clumps, vector, centerpoint

SYNOPSIS

r.centroids
r.centroids --help
r.centroids input=name output=name [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

--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]
Raster map of clumps, clusters of same-valued pixels
output=name [required]
Name for output vector map

Table of contents

DESCRIPTION

r.centroids is a wrapper function for r.volume that computes the center point of raster clumps of data (neighboring, same-valued pixels). The centroids will always fall within the clump so they may not be the true, mathematical centroid. The centroids will always fall at the center of a pixel.

r.centroids requires an input raster containing clumps of data such as the output of r.clump.

EXAMPLES

Find the centroids of the basins map (North Carolina sample dataset). First, set computational area.
g.region raster=basin_50K
Then, compute the centroids.
r.centroids input=basin_50K output=centroids50K
r.centroids results

SEE ALSO

r.volume r.clump

AUTHOR

Caitlin Haedrich, Center for Geospatial Analytics, North Carolina State University, January, 2021.

SOURCE CODE

Available at: r.centroids source code (history)

Latest change: Tuesday Mar 26 20:41:36 2024 in commit: 3b09b1d78f6e96ffebacac6e36f0afd91ad0c091


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

© 2003-2024 GRASS Development Team, GRASS GIS 8.3.3dev Reference Manual