Soapfilm smoothers & lake bathymetries
Want to share your content on Rbloggers? click here if you have a blog, or here if you don't.
A number of years ago, whilst I was still working at ENSIS, the consultancy arm of the ECRC at UCL, I worked on a project for the (then) Countryside Council for Wales (CCW; now part of Natural Resources Wales). I don’t recall why they were doing this project, but we were tasked with producing a standardised set of bathymetric maps for Welsh lakes. The brief called for the bathymetries to be provided in standard GIS formats. Either CCW’s project manager or the project lead at ENSIS had proposed to use inverse distance weighting (IWD) to smooth the point bathymetric measurements. This probably stemmed from the person that initiatied our bathymetric programme at ENSIS being a GIS wizard, schooled in the ways of ArcGIS. My involvement was mainly data processing of the IDW results. I was however, at the time, also somewhat familiar with the problem of finite area smoothing^{1} and had read a paper of Simon Wood’s on his then new soapfilm smoother (Wood et al., 2008). So, as well as writing scripts to process and present the IDWbased bathymetry data in the report, I snuck a task into the work programme that allowed me to investigate using soapfilm smoothers for modelling lake bathymetric data. The timing was never great to write up this method (two children and a move to Canada have occurred since the end of this project), so I’ve not done anything with the idea. Until now…
In this post, I want to introduce the concept of finite area smoothing and illustrate the use of soapfilm smoothers in modelling lake bathymetric data.
Finite area smoothing
Often, we seek to model a response over a welldefined region with a known boundary. This problem is known as finite area smoothing, or as Ramsay put it, smoothing over difficult regions (2002). Why this problem is more difficult than it sounds is well illustrated by the test function introduced by Ramsay (2002) a version of which is shown below^{2}.
The domain of the test is a rotated U shape. Each stem of the U has quite different values of the response, achieved by smoothly varying the response along the U itself. Between the two stems is a barrier in the spatial domain. Smoothing across this barrier would bleed information from one side to the other, which would lead to poorly predicted values. One solution to the problem of smoothing inside domains such as the one shown is to smooth only considering distances between points within the domain, not distances over some bounding box of the problem. In other words, we shouldn’t assume points either side of the barrier in the test function are similar just because they are closely located in the y coordinate.
Soapfilm smoothers
Bubble artists can do some amazing things with a few props and copious amounts of soapy solutions. If you’ve ever seen a bubble artist perform, you’ll never look at the little bottles of bubbles that kids use to blow simple round bubbles in the same way again. Whilst soapfilm smoothers aren’t quite as amazing as the soapy wonders produced by bubble artists, how they work is directly related to one form of bubble art^{3}.
If we start from the simple kidstoy version for blowing round bubbles, then you’ll know that there is a small loop within which an exceedingly thin film of soapy liquid is contained. Blowing through the loop deforms the soapy film, and if you blow gently, eventually you can deform the film enough that it detaches from the loop and forms a perfect, iridescent, soapy ball of fun^{4}. Bubble artists employ more complex loops, but the principle remains the same and in practice, this is exactly how soapfilm smoothers work.
Return for a moment to Ramsay’s test function shown above. The loop is formed by the boundary of the domain. Imagine a soapy film suspended within this loop, and further imagine that we can somehow blow over the region to deform the film in such as way as to move the film towards the data. In the test function above, we’d need to “blow” on the film so that it deformed towards us in the upper stem of the U, and away from us in the lower stem (assuming that we’re mapping the data values to the z coordinate.) Quite a lot of complexity underlies exactly how the soapfilm smoother achieves this, but the general principle is exceedingly simple.
Soapfilm smoothers comprise two separate types of smoother; one for the boundary and one for the film itself. The boundary smoother is often a cyclic spline in order to have the ends of the spline join nicely at the “end points” of the boundary. If the value of the response at the boundary is known, such as lake depth being zero at the margin of the lake, then the boundary can be fixed at these values without needing a spline to model values on the boundary. If the response is not known at the boundary, it can be estimated using the boundary spline.
Lake bathymetric data
What do soap films have to do with lake bathymetric data? Basically because the problem of modelling depth soundings is exactly the same as that illustrated by Ramsay’s test function. We have a well defined boundary^{5}, and all but the most simple lakes have shoreline features that we don’t want to smooth across, such as peninsulars^{6}.
The figure below shows lake depth soundings from the Comeston Park Lakes, two nowflooded former quarries joined by a narrow channel.
This example is very similar to that of Ramsay’s test function. We don’t want to smooth across the narrow peninsular because there is no reason to presume the bed topography is the same on either side.
Additive models for lake bathymetry data
If we weren’t worried about the boundary, we could use a thin plate spline smoother (TPRS) to model how depth varies spatially. The TPRS basis is perfect for this as the x
y
data are in the same units. Hence a simple GAM would seem OK, if were weren’t worried about those pesky boundaries.
The wrong thing then would be to do the following, here not using the lake boundary information of zero depths.
The fitted smoother uses about 40 degrees of freedom, and explains about 80% of the variance in the observed depths. To visualise the fitted surface, I create a data set of x and y coordinates over the bounding box of the spatial data. At this stage I’m not going to remove any of the points for prediction that are outside the lake as I want to show what the TPRS smoother is doing. The code basically
 sets up a 2.5 meterresolution grid in the x and y directions
 predicts from the model at each location

creates a temporary version of the predictions, setting all depths > 0 to
NA
, which removes some distracting behaviour far from the support of the observations.
The TPRS fitted surface is plotted with the observed data using
I’ve purposely done a poor visualisation job^{7} in the above figure as I wanted to show how the TPRS smoother bleeds information across the peninsular. Ignore the predictions off into the top left & bottom right: concentrate on the peninsular. The TPRS spline is smoothing depth
across this region, exactly what we don’t want. It’s almost as if the peninsular isn’t there.
Next we’ll fit the soapfilm smoother version. I’ll take this one a bit slower as we have some work to do to set up the boundary and knot locations that the smoother needs.
For lake bathymetries we have two setup jobs to complete

create a boundary object, with known value of
0
 choose the number of knots and their locations over the domain of interest
The second is, in my experience, most easily achieved by using the list form of the allowed options for the boundary^{8}. The list form for the boundary is a list within a list. Each sublist has at least two elements containing the x and y coordinates of the boundary polygon. A component f
may also be included, which sets the boundary condition at each location; here we set this to 0
to indicate the depth tends to 0
at the lake shore. In the code below I create this from the coordinates()
object created earlier.
Choosing the number and location of knots is trickier, especially if you are trying to automate this for a large number of lakes. The key requirement is that any knots are contained entirely within the lake boundary. mgcv provides the inSide()
function to facilitate this. Unfortunately inSide()
doesn’t provide exactly the same check for being inside the boundary as the one used by the soapfilm smooth constructor called when you fit the model. The procedure I outline below is the one I’ve found most useful to date, but I make no guarantee that it is optimal nor that it will work for your data problem^{9}.
Here I choose to create a 10 by 10 regular grid of locations over the bounding box of the coordinates. From this grid I retain those points that are contained within the lake boundary.
The last two lines set boundary and knots names to match the variable names on the depth data used to fit the model.
The choice of 10 for the sides of the grid is useful here as that puts enough points within the lake for the knots of the smoother, but doesn’t require any nudging of the grid to get the selected points to fall nicely within the boundary. In other examples, I’ve needed to tailor the number of points in the grid and shift it by a few meters to get as many of the regular points to fall inside the boundary. You may even find that you need to locate the knots individually. Using locator()
after plotting the lake outline is an expedient — but entirely manual — way to do this if you have too.
What this process looks like is shown in the figure below
Fitting the soapfilm model is quite similar to any other GAM you may have fitted with mgcv. The main exception is that you have to pass something to the xt
argument of s()
. If you delve into some of the more complex smoothers that have become available in mgcv in recent releases, you’ll find yourself using xt
a lot as it is the way to pass extra information to the basis constructor functions.
For soapfilm smoothers you must pass xt
a list with component bnd
set to an appropriate boundary object — here bound
as created earlier. The knots that were created earlier need to be passed to the knots
argument. The full call to gam()
is shown below; the soapfilm basis is specified using bs = “so”
.
The soapfilm smoother explains just over 75% of the variance in the data, using just under 30 degrees of freedom. It doesn’t explain quite as much variance as the TPRS model I looked at earlier, but is substantially simpler in terms of degrees of freedom (~30 vs ~40 respectively).
Soapfilm GAMs come with their own plot()
method
Notice how the contours of the fitted soapfilm surface are parallel to the peninsular shoreline — as we’d expect if we studied lakes. We’ll return to this momentarily.
As we aren’t in the business of drawing pictures^{10}
If you want to draw pictures, base graphics is better than ggplot2. But most people don’t want to draw pictures with #rstats
— Hadley Wickham ((???)) March 22, 2016
I should plot the fitted model using ggplot()
. Note that the predict()
step here is slow — I could probably speed it up a lot by removing all the points that are outside the lake boundary (see below) because we already know those points will be NA
s and just hence dropped from any plotting or subsequent analysis.
The first thing to notice is that the predict()
method automatically sets points outside the boundary to NA
for soapfilm smoother models: you have to do this manually with the other types of smoother.
The main improvement in the soapfilm model is the performance of the fitted depth surface around the peninsular. Notice now how on the right of the peninsular, the depth lessens towards the shoreline, and on the left depth increases from 0 away from the peninsular. Importantly, however, the deeper points on the right are not leaking information across the peninsular.
We could have achieved a better fit with the TPRS model by including the boundary coordinates with the depth
data with depths 0
. This would have improved the performance around the edge of the lake, but it wouldn’t have had the same effect as the soapfilm smoother around the peninsular. Why so? Well, in the soapfilm, we set the values of the boundary to be zero and the soapfilm smooths from the data points to those known values but won’t smooth across the boundary of the domain. The TPRS model however would treat the 0 depth values differently: in simple terms it will smooth through the values, not to them. Hence the spline will get pulled towards zero somewhat, but the spline will still be “averaging” the depth data from a local region around the peninsular, information which includes the deeper data we don’t want to leak.
To help compare the two surfaces, I do a little more data munging to remove TPRS points outside the lake boundary and combine them with the soapfilm data.
The effect is subtle in these plots, but the differences between the two are clear. Most important, the leakage of information across the peninsular, clearly visible in the TPRS model is removed in the soapfilm version.
Soapfilm smoothers are not the only way to approach finite area smoothing. David Miller did his PhD with Simon Wood and developed the generalised distance spline approach to the finite area smoothing problem (Miller and Wood, 2014), and Ramsay introduced his FELSPLINE method (Ramsay, 2002). I’ve not had chance to investigate David’s generalised distance spline method yet but if I do, I’ll no doubt write a post comparing the results with the soapfilm method.
References
Miller, D. L., and Wood, S. N. (2014). Finite area smoothing with generalized distance splines. Environmental and ecological statistics 21, 715–731. doi:10.1007/s1065101402774.
Ramsay, T. (2002). Spline smoothing over difficult regions. Journal of the Royal Statistical Society. Series B, Statistical methodology 64, 307–319. doi:10.1111/14679868.00339.
Wood, S. N., Bravington, M. V., and Hedley, S. L. (2008). Soap film smoothing. Journal of the Royal Statistical Society. Series B, Statistical methodology 70, 931–955. doi:10.1111/j.14679868.2008.00665.x.

smoothing over a domain with known boundaries, like a lake↩

See the example in
?fs.test
after loading package mgcv↩ 
and soapfilm smooths are pretty damn cool all the same!↩

or a soapy, sticky mess depending upon your point of view…↩

ignoring the fact that lake levels often rise and fall through the year or over years.↩

because topography↩

I should have removed all prediction points outside the lake as these are very far from the support of the data.↩

The other form is a list with subdata frame(s), each data frame is a separate loop.↩

It is probably worth trying a range of knots and varying their locations if you are taking this very seriously.↩

Sorry Hadley, I couldn’t resist.↩
Rbloggers.com offers daily email updates about R news and tutorials about learning R and many other topics. Click here if you're looking to post or find an R/datascience job.
Want to share your content on Rbloggers? click here if you have a blog, or here if you don't.