k_means

k_means,ANY-method

k_means,SpatRaster-method

Compute k-means clusters for a SpatRaster. For large SpatRasters (with <code>ncell(x) &gt; maxcell</code>) this is done in two steps. First a sample of the cells is used to compute the cluster centers. Then each cell is assigned to a cluster by computing the distance to these centers.

spatial

Methods for spatial data analysis with vector (points, lines, polygons) and raster (grid) data. Methods for vector data include geometric operations such as intersect and buffer. Raster methods include local, focal, global, zonal and geometric operations. The predict and interpolate methods facilitate the use of regression type (interpolation, machine learning) models for spatial prediction, including with satellite remote sensing data. Processing of very large files is supported. See the manual and tutorials on <https://rspatial.org/> to get started. 'terra' replaces the 'raster' package ('terra' can do more, and it is faster and easier to use).

Robert Hijmans

terra

Spatial Data Analysis

Robert J. Hijmans

Roger Bivand

Emanuele Cordano

Krzysztof Dyba

Edzer Pebesma

Michael D. Sumner

k_means function

<dl> <dt>x</dt>
<dd>SpatRaster</dd> <dt>centers</dt>
<dd>either the number of clusters, or a set of initial (distinct) cluster centres. If a number, a random set of (distinct) cells in <code>x</code> is chosen as the initial centres</dd>
 
 <dt>...</dt>
<dd>additional arguments passed to <code><a href="/link/kmeans?package=terra&version=1.8-5" data-mini-rdoc="terra::kmeans">kmeans</a></code></dd>
 
 <dt>maxcell</dt>
<dd>positive integer. The size of the regular sample used if it is smaller than <code>ncell(x)</code></dd> <dt>filename</dt>
<dd>character. Output filename (ignored if <code>as.raster=FALSE</code>)</dd> <dt>overwrite</dt>
<dd>logical. If <code>TRUE</code>, <code>filename</code> is overwritten</dd> <dt>wopt</dt>
<dd>list with additional arguments for writing files as in <code>writeRaster</code></dd></dl>

Arguments

k_means — k_means

<dl>

 <dt>x</dt>
<dd>SpatRaster</dd>

 <dt>centers</dt>
<dd>either the number of clusters, or a set of initial (distinct) cluster centres. If a number, a random set of (distinct) cells in <code>x</code> is chosen as the initial centres</dd>
 
 <dt>...</dt>
<dd>additional arguments passed to <code><a href='https://rdrr.io/r/stats/kmeans.html'>kmeans</a></code></dd>
 
 <dt>maxcell</dt>
<dd>positive integer. The size of the regular sample used if it is smaller than <code>ncell(x)</code></dd>

 <dt>filename</dt>
<dd>character. Output filename (ignored if <code>as.raster=FALSE</code>)</dd>

 <dt>overwrite</dt>
<dd>logical. If <code>TRUE</code>, <code>filename</code> is overwritten</dd>

 <dt>wopt</dt>
<dd>list with additional arguments for writing files as in <code>writeRaster</code></dd>

</dl>

k_means: k_means

Description

Usage

Value

Arguments

See Also

Examples