Skip to contents

Source: vignettes/coregistration.Rmd

This workflow compares a canopy height model (CHM) derived from airborne laser scanning (ALS) data with tree positions inventoried in the field, and then proposes a translation in plot position for better matching. The method is described in Monnet and Mermin (2014). Here it is exemplified with circular plots, but it can be applied to any shape of field plots. The workflow is based on functions from R packages lidaRtRee (tested with version 4.0.7) and lidR (tested with version 4.0.4). Example data were acquired in the forest of Lac des Rouges Truites (Jura, France).

Material

Field data

The study area is a part of the forest of Lac des Rouges Truites. 44 plots have been inventoried, 15 are available for testing. Plots have a 14.10 m radius. A data.frame p contains the positions of the center of plots. Attributes are:

  • placette: plot id
  • Xtheo and Ytheo: XY coordinates initially sampled when preparing the field inventory
  • XGPS and YGPS: XY coordinates recorded in the field with a GNSS receiver during the field inventory
  • Prec: GNSS precision in meter specified by the receiver
  • dist: horizontal distance between the sample and recorded coordinates.
# load plot coordinates (data.frame with lines corresponding to the las objects)
load(file = "./data/coregistration/plotsCoregistration.rda")
head(p, n = 3L)
##   placette    Xtheo   Ytheo     XGPS    YGPS     ZGPS Prec     dist
## 1        6 930422.7 6615047 930423.1 6615046 1087.803  2.1 1.502383
## 2       12 930521.4 6615046 930517.3 6615047 1082.799  1.6 4.161719
## 3       22 930720.9 6615249 930722.1 6615245 1089.593  0.3 3.980429

On each plot, five trees which were considered suitable for coregistration (vertical trunk, high and peak-shaped crown, well separated from neighboring trees) have been positioned relatively to the plot center. From the XY coordinates recorded by the GNSS receiver and the relative coordinates (slope, distance, azimuth), the XY coordinates of those trees are computed. Data.frame ap contains the following attributes:

  • plac: plot id
  • n: tree id
  • dia: tree diameter in cm
  • distR: slope distance from the plot center to tree center, in m
  • azimutG: azimuth from the plot center to the tree center, in grades
  • pente.: slope from plot center to tree center, in grades
  • XYZGPS: coordinates of the plot center
  • xyz: coordinates of the tree center
  • d: horizontal distance between plot center and tree in m
# load inventoried trees (data.frame with plot id info )
load(file = "./data/coregistration/treesCoregistration.rda")
head(ap, n = 3L)
##   plac   n  ess dia distR azimutG pente. Rem     XGPS    YGPS     ZGPS        x
## 1    6 223 ABAL  54  9.02       9    -29     930423.1 6615046 1087.803 930424.2
## 2    6 224 ABAL  48  9.18     304     52     930423.1 6615046 1087.803 930415.0
## 3    6 225 ABAL  45  7.91     214     52     930423.1 6615046 1087.803 930421.6
##         y        z        d
## 1 6615054 1085.291 8.663071
## 2 6615046 1092.038 8.144650
## 3 6615039 1091.452 7.017885

ALS data

Airborne laser scanning data on the study area is part of a campaign acquired in 2016 with an airborne RIEGL LMS Q680i sensor. Acquisition was funded by the Région Franche-Comté.

ALS data over the plots is provided as a list of LAS objects in rda file.

# load point cloud over reference plots (list of las objects)
load(file = "./data/coregistration/lasCoregistration.rda")

Display point cloud of plot 1.

# plot point cloud
lidR::plot(las[[1]])

The code to extract LAS objects from a directory containing the LAS files is (code corresponding to Parameters has to be run beforehand):

# create catalog of LAS files
cata <- lidR::readALSLAScatalog("/directory_with_classified_laz_files/")
# "/media/reseau/lessem/ProjetsCommuns/Lidar/data/Franche-Comte/norm.laz/"
# set coordinate system
lidR::projection(cata) <- 2154
# option to read only xyzc attributes 
# (coordinates, intensity, echo order and classification) from files
# lidR::opt_select(cata) <- "xyzc"
# extract LAS data on plot extent
las <- lidR::clip_circle(cata, p$XGPS, p$YGPS, p_radius + b_size + 5)
# normalize heights if point cloud are not already normalized
las <- lapply(las, function(x) {
  lidR::normalize_height(x, lidR::tin())
})
# save as rda file for later use
save(las, file = "./data/coregistration/lasCoregistration.rda")

Parameters

Several parameters have to be specified for optimal results.

# vegetation height threshold for removal of high values
hmax <- 50
# field plot radius for computation of pseudo-CHM on the inventory area
p_radius <- 14.105
# raster resolution for image processing
r_res <- 0.5
# maximum distance around initial position to search for coregistration
b_size <- 5
# increment step to search for coregistration
# (should be a multiple of resolution)
s_step <- 0.5

Coregistration of one plot

Canopy height model

The first step is to compute the canopy height model from the ALS data, and remove artefacts by thresholding extreme values and applying a median filter.

# Choose a plot as example
i <- 10
# compute canopy height model
chm <- lidR::rasterize_canopy(las[[i]], res = r_res, algorithm = lidR::p2r())
# apply threshold to canopy height model (CHM)
chm[chm > hmax] <- hmax
# fill NA values with 0
chm[is.na(chm)] <- 0
# apply median filter (3x3 window) to CHM
chmfilt <- lidaRtRee::dem_filtering(chm, "Median", 3, sigma = 0)$non_linear_image
# plot canopy height model
par(mfrow = c(1, 2))
terra::plot(chm, main = "Raw canopy height model")
terra::plot(chmfilt, main = "Filtered canopy height model")

Plot mask from tree inventory

The trees corresponding to the plot are extracted, and a plot mask is computed from the plot center and radius.

# plot centre
centre <- p[i, c("XGPS", "YGPS")]
# extract plot trees
trees <- ap[ap$plac == p$placette[i], ]
# create raster with plot extent
r <- lidaRtRee::circle2Raster(centre$XGPS, centre$YGPS, p_radius,
                              resolution = r_res)
# keep only trees with diameter information
trees <- trees[!is.na(trees[, "dia"]), ]
# create plot mask
r_mask <- lidaRtRee::raster_xy_mask(c(centre$XGPS, centre$YGPS),
                                    p_radius, r, binary = T)
# replace 0 by NA
r_mask[r_mask == 0] <- NA
# specify projection
terra::crs(r_mask) <- "epsg:2154"
# display plot mask
terra::plot(r_mask, main = "Plot mask and tree positions", legend = FALSE)
# add tree positions
points(trees[, c("x", "y")], cex = trees[, "dia"] / 40)
# add plot center
points(centre, pch = 3)
legend("topleft", c("Trees", "Plot center"), pch = c(1, 3))

Compute correlation and identify optimal translation

First the function computes the correlation for different possible translations of the plot center inside the buffer specified by the user, and outputs an image of correlation values between the ALS CHM and the pseudo CHM. The pseudo CHM is a height model where at the location of inventoried trees pixels are attributed the value corresponding to tree size (e.g. height or diameter). Second the correlation image is analyzed to identify which translation yields the highest correlation. The function outputs a list which first element is the correlation image, and the second one the corresponding statistics.

# compute correlation image
coreg <- lidaRtRee::coregistration(chmfilt, trees[, c("x", "y", "dia")],
  mask = r_mask,
  buffer = b_size, step = s_step, dm = 2, plot = FALSE
)
# correlation image statistics
round(coreg$local_max, 2)
##   correlation dx1  dy1 dx2 dy2 ratiomax1max2 rmedloc1 rmedloc2 rquanta rquantb
## 1        0.06 0.5 -2.5 2.5   4          3.96     1.07      1.2    1.49     8.6

The maximum of the correlation image is located at (0.5, -2.5), given by attributes dx1 and dy1.

par(mfrow = c(1, 3))
terra::plot(chmfilt, main = "Initial tree positions and CHM")
# display initial tree positions
graphics::points(trees$x, trees$y, cex = trees$dia / 40)
# display correlation image
terra::plot(coreg$correlation_raster,
  main = "Correlation image",
  col = cm.colors(16)
)
# plot local maximum
graphics::points(coreg$local_max$dx1, coreg$local_max$dy1, pch = 4)
abline(h = 0, lty = 2)
abline(v = 0, lty = 2)
legend("topleft", "Maximum", pch = 4)
#
terra::plot(chmfilt, main = "Coregistered tree positions and CHM")
# display coregistered tree positions
graphics::points(trees$x + coreg$local_max$dx1, trees$y + coreg$local_max$dy1,
  cex = trees$dia / 40, col = "red"
)
# display initial plot center
graphics::points(p[i, c("XGPS", "YGPS")], pch = 3)
# display coregistered plot center
graphics::points(p$XGPS[i] + coreg$local_max$dx1,
                 p$YGPS[i] + coreg$local_max$dy1,
  pch = 3,
  col = "red"
)
graphics::legend("topleft", c("Initial center", "Coregistered"),
  pch = 3,
  col = c("black", "red")
)

# export as pdf
# dev.copy2pdf(file = paste("Coregistration_", p$placette[i], ".pdf", sep = ""))

Batch processing

The following code processes several plots using multi-core computing. It is based on packages future and future.apply for parallel computing.

# specify to use two parallel sessions
future::plan("multisession", workers = 2L)
# remove warning when using random numbers in parallel sessions
options(future.rng.onMisuse = "ignore")

CHMs computation

First CHMs are calculated for each point cloud contained in the list.

l_chm <- future.apply::future_lapply(
  as.list(1:length(las)),
  FUN = function(i) {
    # compute CHM
    chm <- lidR::rasterize_canopy(las[[i]], res = r_res,
                                  algorithm = lidR::p2r(), pkg = "terra")
    # apply threshold to canopy height model (CHM)
    chm[chm > hmax] <- hmax
    # fill NA values with 0
    chm[is.na(chm)] <- 0
    # apply median filter (3x3 window) to CHM
    chmfilt <-
      lidaRtRee::dem_filtering(chm, "Median", 3, sigma = 0)[[1]]
    return(terra::wrap(chmfilt))
  }
)

Trees lists extraction and plot masks computation

l_field <- future.apply::future_lapply(
  as.list(1:length(las)),
  FUN = function(i) {
    # plot centre
    centre <- p[i, c("XGPS", "YGPS")]
    # extract plot trees
    trees <- ap[ap$plac == p$placette[i],]
    # create raster with plot extent
    r <-
      lidaRtRee::circle2Raster(centre$XGPS, centre$YGPS, p_radius,
                               resolution = r_res)
    # keep only trees with diameter information
    trees <- trees[!is.na(trees[, "dia"]),]
    # create plot mask
    r_mask <- lidaRtRee::raster_xy_mask(rbind(c(centre$XGPS, centre$YGPS),
                                              c(centre$XGPS, centre$YGPS)),
                                        c(p_radius, p_radius), r,
                                        binary = T)
    # replace 0 by NA
    r_mask[r_mask == 0] <- NA
    # specify projection
    terra::crs(r_mask) <- "epsg:2154"
    return(list(trees = trees[, c("x", "y", "dia")],
                r_mask = terra::wrap(r_mask)))
  }
)

Correlation images and corresponding statistics computation

Then the correlation image and corresponding statistics are computed for each plot.

l_coreg <- future.apply::future_lapply(
  as.list(1:length(las)),
  FUN = function(i) {
    dummy <- lidaRtRee::coregistration(
      terra::rast(l_chm[[i]]),
      l_field[[i]]$trees,
      mask = terra::rast(l_field[[i]]$r_mask),
      buffer = b_size,
      step = s_step,
      dm = 2,
      plot = FALSE
    )
    # wrap raster 
    dummy$correlation_raster <- terra::wrap(dummy$correlation_raster)
    # output
    return(dummy)
  }
)

Finally results for all plots are combined in a single data.frame.

translations <- future.apply::future_lapply(
  as.list(1:length(las)),
  FUN = function(i) {
    # create data.frame with coregistration results and new plot coordinates
    data.frame(
      plotid = p$placette[i],
      X_cor = p$XGPS[i] + l_coreg[[i]]$local_max$dx1,
      Y_cor = p$YGPS[i] + l_coreg[[i]]$local_max$dy1,
      l_coreg[[i]]$local_max
    )
  }
)
# bind in single data.frame
translations <- do.call(rbind, translations)
# remove row.names
row.names(translations) <- NULL
#
round(head(translations, n = 3L), 2)
##   plotid    X_cor   Y_cor correlation  dx1 dy1 dx2  dy2 ratiomax1max2 rmedloc1
## 1      6 930422.1 6615047        0.06 -1.0   1   2 -4.5          4.77     1.07
## 2     12 930516.8 6615045        0.07 -0.5  -2  -4  3.0          2.59     1.13
## 3     22 930721.1 6615247        0.06 -1.0   2   0 -5.0          4.64     1.09
##   rmedloc2 rquanta rquantb
## 1     1.31    1.71   12.74
## 2     1.51    2.62    4.77
## 3     1.36    1.88    8.30

Export graphics as pdf files

# unwrap raster files
l_chm <- lapply(l_chm, terra::rast)
#
for (i in 1:length(las))
{
  # CHM
  pdf(file = paste("Coregistration_", p$placette[i], ".pdf", sep = ""))
  terra::plot(l_chm[[i]])
  # display initial tree positions
  graphics::points(l_field[[i]]$trees$x, l_field[[i]]$trees$y,
    cex = l_field[[i]]$trees$dia / 40
  )
  # display coregistered tree positions
  graphics::points(l_field[[i]]$trees$x + l_coreg[[i]]$local_max$dx1,
    l_field[[i]]$trees$y + l_coreg[[i]]$local_max$dy1,
    cex = l_field[[i]]$trees$dia / 40, col = "red"
  )
  # display initial plot center
  graphics::points(p[i, c("XGPS", "YGPS")], pch = 3)
  # display coregistered plot center
  graphics::points(p$XGPS[i] + l_coreg[[i]]$local_max$dx1,
    p$YGPS[i] + l_coreg[[i]]$local_max$dy1,
    pch = 3, col = "red"
  )
  graphics::legend("topleft", c("Initial", "Coregistered"),
    pch = 15,
    col = c("black", "red")
  )
  # export as pdf
  dev.off()
}

Add coregistered plot positions and update tree coordinates

Optimized plot center positions are added to the original data.

p <- base::merge(p, translations[, c("plotid", "X_cor", "Y_cor")],
  by.x = "placette",
  by.y = "plotid"
)
round(head(p, n = 3L), 2)
##   placette    Xtheo   Ytheo     XGPS    YGPS    ZGPS Prec dist    X_cor   Y_cor
## 1        6 930422.7 6615047 930423.1 6615046 1087.80  2.1 1.50 930422.1 6615047
## 2       12 930521.4 6615046 930517.3 6615047 1082.80  1.6 4.16 930516.8 6615045
## 3       22 930720.9 6615249 930722.1 6615245 1089.59  0.3 3.98 930721.1 6615247

Tree positions are corrected to account for new center position.

# add plot center coregistered coordinates to trees data.frame
ap <- base::merge(ap, p[, c("placette", "X_cor", "Y_cor")], by.x = "plac",
                  by.y = "placette")
# compute new tree coordinates from coregistered plot center
dummy <- lidaRtRee::polar2Projected(
  ap$X_cor, ap$Y_cor, ap$ZGPS, ap$azimutG / 200 * pi,
  ap$distR, atan(ap$pente. / 100), 1.55 / 180 * pi,
  -2.2 / 180 * pi, 0
)
ap$X_cor <- dummy$x
ap$Y_cor <- dummy$y
# save new table
# write.table(round(p.cor,3),file="coregistered_plots.csv", row.names=F,sep=";")

Analysis of GPS errors

Graphics on the difference between initial and corrected positions are displayed. The mean difference is -0.85 m in the X axis and -0.95 m in the Y axis. p.values of a t.test are respectively 0.03 and 0.1. Mean absolute distance is 2.1 m with a standard deviation of 0.8 m.

par(mfrow = c(1, 2))
# plot position difference with additionnal jitter to visualize same points
plot(jitter(p$X_cor - p$XGPS), jitter(p$Y_cor - p$YGPS),
  asp = 1, col = "black",
  main = "Corrected-Initial position", xlab = "X difference",
  ylab = "Y difference"
)
abline(v = 0, lty = 2)
abline(h = 0, lty = 2)
# Distance between initial and corrected
hist(sqrt((p$X_cor - p$XGPS)^2 + (p$Y_cor - p$YGPS)^2),
  main = "Histogram of distances",
  xlab = "Absolute distance corrected-initial", ylab = "Number of plots"
)

References

Monnet, Jean-Matthieu, and Éric Mermin. 2014. “Cross-Correlation of Diameter Measures for the Co-Registration of Forest Inventory Plots with Airborne Laser Scanning Data.” Forests 5 (9): 2307–26. https://doi.org/10.3390/f5092307.