Skip to contents

In order to allow interaction of an spatial a correlation clusters in RLumCarlo, first a dosimetric system needs to be created in a three-dimensional space, which is the purpose of this function.

Usage

create_ClusterSystem(n = 100, h = 0.5, plot = FALSE, ...)

Arguments

n

numeric (with default): number of clusters to be created in an arbitrary 3-dimensional cube. x, y, z distances range between 0 and 1.

h

numeric (with default): numeric scalar the cut the cluster tree using stats::cutree. The number must range between 0 and 1.

plot

logical (with default): enables/disables plot output

...

further arguments to be passed to the plot output

Value

The function returns a list of class RLumCarlo_clusters consisting of numeric vector of cluster groups and a matrix of the cluster positions in the arbitrary space. If plot = TRUE the system is displayed using scatterplot3d::scatterplot3d

Function version

0.1.0

Author

Sebastian Kreutzer, Institute of Geography, Heidelberg University (Germany)

How to cite

Kreutzer, S., 2025. create_ClusterSystem(): Create dosimetric cluster system. Function version 0.1.0. In: Friedrich, J., Kreutzer, S., Pagonis, V., Schmidt, C., 2025. RLumCarlo: Monte-Carlo Methods for Simulating Luminescence Phenomena. R package version 0.1.10. https://r-lum.github.io/RLumCarlo/

Examples

create_ClusterSystem(n = 10, plot = TRUE)

#> $cl_groups
#>  [1] 1 2 3 1 4 1 5 6 4 2
#> 
#> $m
#>                 x          y          z
#>  [1,] 0.600760886 0.03424133 0.73531960
#>  [2,] 0.157208442 0.32038573 0.19595673
#>  [3,] 0.007399441 0.40232824 0.98053967
#>  [4,] 0.466393497 0.19566983 0.74152153
#>  [5,] 0.497777389 0.40353812 0.05144628
#>  [6,] 0.289767245 0.06366146 0.53021246
#>  [7,] 0.732881987 0.38870131 0.69582388
#>  [8,] 0.772521511 0.97554784 0.68855600
#>  [9,] 0.874600661 0.28989230 0.03123033
#> [10,] 0.174940627 0.67838043 0.22556253
#> 
#> attr(,"class")
#> [1] "RLumCarlo_ClusterSystem"