par_make_balanced

For balancing computational loads, the function uses
the <code>anticlust</code> package to cluster the input points. The number of clusters
is determined by the <code>num_cluster</code> argument. Each cluster will have
equal number of points. Grids will be generated based on the cluster
extents. At the lower level, the function uses <code><a href="/link/terra%3A%3Adistance()?package=chopin&version=0.9.4" data-mini-rdoc="chopin::terra::distance()">terra::distance()</a></code>
function to calculate the Euclidean distance between points.

internal

Geospatial data computation is parallelized by grid, hierarchy,
or raster files. Based on 'future' (Bengtsson, 2024 <doi:10.32614/CRAN.package.future>)
and 'mirai' (Gao et al., 2025 <doi:10.32614/CRAN.package.mirai>) parallel back-ends,
'terra' (Hijmans et al., 2025 <doi:10.32614/CRAN.package.terra>) and
'sf' (Pebesma et al., 2024 <doi:10.32614/CRAN.package.sf>)
functions as well as convenience functions in the package can be distributed
over multiple threads. The simplest way of parallelizing generic geospatial
computation is to start from par_pad_*() functions to par_grid(),
par_hierarchy(), or par_multirasters() functions. Virtually any functions
accepting classes in 'terra' or 'sf' packages can be used in the three
parallelization functions. A common raster-vector overlay operation
is provided as a function extract_at(), which uses
'exactextractr' (Baston, 2023 <doi:10.32614/CRAN.package.exactextractr>), with
options for kernel weights for summarizing raster values at vector geometries.
Other convenience functions for vector-vector operations including
simple areal interpolation (summarize_aw()) and summation of
exponentially decaying weights (summarize_sedc()) are also provided.

Insang Song

chopin

Spatial Parallel Computing by Hierarchical Data Partitioning

Kyle Messier

Alec L. Robitaille

Eric R. Scott

par_make_balanced function

<dl><dt>points_in</dt>
<dd><code>sf</code> or <code>SpatVector</code> object. Target points of computation.</dd>
<dt>n_clusters</dt>
<dd>integer(1). The number of clusters.</dd></dl>

Arguments

Author

For balancing computational loads, the function uses
the <code>anticlust</code> package to cluster the input points. The number of clusters
is determined by the <code>num_cluster</code> argument. Each cluster will have
equal number of points. Grids will be generated based on the cluster
extents. At the lower level, the function uses <code><a href='https://rdrr.io/pkg/terra/man/distance.html'>terra::distance()</a></code>
function to calculate the Euclidean distance between points.

Generate groups based on balanced clustering — par_make_balanced

<dl>

<dt>points_in</dt>
<dd><code>sf</code> or <code>SpatVector</code> object. Target points of computation.</dd>


<dt>n_clusters</dt>
<dd>integer(1). The number of clusters.</dd>

</dl>

par_make_balanced: Generate groups based on balanced clustering

Description

Usage

Value

Arguments

Author