plot_MoranScatterplot: Moran Scatter Plot: Visualizing Spatial Dependency

In Luminescence: Comprehensive Luminescence Dating Data Analysis

Moran Scatter Plot: Visualizing Spatial Dependency

Description

Scatter plot, with on the x axis the original grain signal and on the y axis the weighted mean of the neighbour grain signals. The plot area is divided into four quadrants, and also a least square line (which slopes indicates, but not exactly represents, Moran's I) and an 1:1 line (which indicates a Moran's I of around 1).

Usage

plot_MoranScatterplot(
  object,
  df_neighbours = NULL,
  str_y_def = "mean_neighbours",
  ...
)

Arguments

object	RLum.Results or numeric (required): containing a numerical vector of length 100, representing one or more measurement discs ("positions") in a reader. Each element in the vector represents one grain hole location on a disc.
df_neighbours	data.frame (with default) Data frame indicating which borders to consider, and their respective weights (see the description provided for calc_MoransI). If NULL (default), this is constructed automatically by the internal function .get_Neighbours.
str_y_def	character (with default) Calculation of y position. Defaults to "mean_neighbours" which is the plain mean of all neighbour values and the most illustrative. The other option is "weighted_sum", which means the sum of the border weights times the neighbour values, which is actually closer to the way Moran's I is by default calculated in this package.
...	Other parameters to be forwarded to the base R plot functions. legend (TRUE/FALSE) to enable/disable the legend. Note that xlab (x axis label), ylab (y axis label) and cex (scaling value) are given default values. Because of sometimes large value differences, log = "x", log = "y" and log = "xy"are supported. In case of negative values and logarithmic plotting, values are increased so the smallest value to plot is 1. Summary elements such as means, least square line etc. will still be based on the linear case. pch accepts options "show_location_ids"⁠(plots grain location id's),⁠"show_n_neighbours"⁠(indicates numbers of neighbours) and the normal base plot⁠pch' options.

Details

Note that this function plots on the y-axis the mean of the neighbours, while the function calc_MoransI by default will for its global calculation weight every border the same. So, grain locations with 1, 2 or 3 neighbours will appear higher on the y-axis than their influence on Moran's I justify – apart from scaling, this explains a part of the differences of Moran's scatter plots between different packages. Also note that island' grain locations (=those not bordering other grains) are left out of these plots but might still influence Moran's I calculations.

Value

Returns (invisibly) a data frame with plotting coordinates and grain location id's, for creating user-defined plots.

How to cite

Boer, A.d., Steinbuch, L., 2025. plot_MoranScatterplot(): Moran Scatter Plot: Visualizing Spatial Dependency. In: Kreutzer, S., Burow, C., Dietze, M., Fuchs, M.C., Schmidt, C., Fischer, M., Friedrich, J., Mercier, N., Philippe, A., Riedesel, S., Autzen, M., Mittelstrass, D., Gray, H.J., Galharret, J., Colombo, M., Steinbuch, L., Boer, A.d., 2025. Luminescence: Comprehensive Luminescence Dating Data Analysis. R package version 1.0.1. https://r-lum.github.io/Luminescence/

Author(s)

Anna-Maartje de Boer, Luc Steinbuch, Wageningen University & Research, 2025 , RLum Developer Team

References

de Boer, A-M., Steinbuch, L., Heuvelink, G.B.M., Wallinga, J., 2025. A novel tool to assess crosstalk in single-grain luminescence detection. Submitted.

Examples

plot_MoranScatterplot(1:100)

Luminescence documentation built on April 3, 2025, 7:52 p.m.