# Introduction

In July mlr got a new feature that extended the support for spatial data: The ability to visualize spatial partitions in cross-validation (CV). When one uses the resampling description “SpCV” or “SpRepCV” in mlr, the k-means clustering approach after Brenning (2005) is used to partition the dataset into equally sized, spatially disjoint subsets. See also this post on r-spatial.org and the vignette about spatial data handling for more information.

# Visualization of partitions

When using random partitiong in the default cross-validation approach, one is usually not interested in the random pattern of the datasets train/test splitting. However, for spatial data this information is important since it can help identifying problematic folds (ones that did not converge or showed a bad performance) and also prooves that the k-means clustering algorithm did a good job on partitioning the dataset.

The new function is called createSpatialResamplingPlots(). It uses ggplot2 and its new geom_sf() function to create spatial plots based on resampling indices of a resample() object.

In this post I will use the examples of the function to demonstrate its use.

First, we create a resampling description using a spatial partitioning with five folds and repeat ir 4 times. This rdesc object is put into a resample() call together with our example task for spatial stuff, spatial.task. The only requirement here is to have a “spatial” task, meaning a task that also comes with coordinate information. Otherwise we cannot use spatial partitioning in the first place. Finally, we use the classif.qda learner to have a quick model fit.

Now we can use createSpatialResamplingPlots() to automatically create one plot for each fold of our r object. Usually we do not want to plot all repetitions of the CV. We can restrict the number of repetitions in the argument repetitions. Besides the required arguments task and resample, the user can specifiy the coordinate reference system that should be used for the plots. Here it is important to set the correct EPSG number in argument crs to receive accurate spatial plots. In the background, geom_sf() (more specifically coords_sf()) will transform the CRS on the fly to EPSG: 4326. This is done because lat/lon reference systems are better for plotting as UTM coordinates usually clutter the axis. However, if you insist on using UTM projection instead of WGS84 (EPSG: 4326) you can set the EPSG code of your choice in argument datum.

To avoid overlapping axis breaks you might have to set the axis breaks on your own as we did it in the example.

Now we got a list of 2L back from calling the function. In the first list we got all the plots, one for each fold. Since we used two repetitions and five folds, we have ten plots in there.

The second list consists of labels for each plot. These are automatically created by createSpatialResamplingPlots() and can serve as titles later on. Note that for now we just created the ggplot objects. We did not plot them yet.

The plotting is left to the user. Single ggplot objects can be plotted by just extracting a certain object from the list, e.g. plots[[1]][[3]]. This would plot fold #3 of repetition one.

However usually we want to visualize all plots in a grid. For this purpose we highly recommend to use the cowplot package and its function plot_grid().

The returned objects of createSpatialResamplingPlots() are already tailored to be used with this function. We just need to hand over the list of plots and (optional) the labels:

# Multiple resample objects

createSpatialResamplingPlots() is quite powerful and can also take multiple resample() objects as inputs with the aim to compare both. A typical use case is to visualize the differences between spatial and non-spatial partitioning.

To do so, we first create two resample() objects (one using “SpRepCV”, one using “RepCV”):

Now we can hand over both objects using a named list. This way the list names will also directly be used as a prefix in the resulting plot labels.

# References

Brenning, A. (2012). Spatial cross-validation and bootstrap for the assessment of prediction rules in remote sensing: The R package sperrorest. In 2012 IEEE International Geoscience and Remote Sensing Symposium. IEEE. https://doi.org/10.1109/igarss.2012.6352393

Written on July 25, 2018 by