In Robinlovelace/geocompr: Geocomputation with R

Raster-vector interactions {#raster-vector}

source("code/before_script.R")

Prerequisites {.unnumbered}

• This chapter requires the following packages:

library(sf)
library(terra)
library(dplyr)

Introduction

\index{raster-vector interactions} This chapter focuses on interactions between raster and vector geographic data models, introduced in Chapter \@ref(spatial-class). It includes several main techniques: raster cropping and masking using vector objects (Section \@ref(raster-cropping)), extracting raster values using different types of vector data (Section \@ref(raster-extraction)), and raster-vector conversion (Sections \@ref(rasterization) and \@ref(spatial-vectorization)). The above concepts are demonstrated using data from previous chapters to understand their potential real-world applications.

Raster cropping

\index{raster!cropping} Many geographic data projects involve integrating data from many different sources, such as remote sensing images (rasters) and administrative boundaries (vectors). Often the extent of input raster datasets is larger than the area of interest. In this case, raster cropping and masking are useful for unifying the spatial extent of input data. Both operations reduce object memory use and associated computational resources for subsequent analysis steps and may be a necessary preprocessing step when creating attractive maps involving raster data.

We will use two objects to illustrate raster cropping:

• A SpatRaster object srtm representing elevation (meters above sea level) in southwestern Utah
• A vector (sf) object zion representing Zion National Park

Both target and cropping objects must have the same projection. The following code chunk therefore not only reads the datasets from the spDataLarge package installed in Chapter \@ref(spatial-class), but it also 'reprojects' zion (a topic covered in Chapter \@ref(reproj-geo-data)):

srtm = rast(system.file("raster/srtm.tif", package = "spDataLarge"))
zion = read_sf(system.file("vector/zion.gpkg", package = "spDataLarge"))
zion = st_transform(zion, st_crs(srtm))

We use crop() from the terra package to crop the srtm raster. The function reduces the rectangular extent of the object passed to its first argument based on the extent of the object passed to its second argument. This functionality is demonstrated in the command below, which generates Figure \@ref(fig:cropmask)(B).

srtm_cropped = crop(srtm, zion)

\index{raster!masking} Related to crop() is the terra function mask(), which sets values outside of the bounds of the object passed to its second argument to NA. The following command therefore masks every cell outside of Zion National Park boundaries (Figure \@ref(fig:cropmask)(C)).

srtm_masked = mask(srtm, zion)

Importantly, we want to use both crop() and mask() together in most cases. This combination of functions would (a) limit the raster's extent to our area of interest and then (b) replace all of the values outside of the area to NA.^[These two operations can be combined into a single step with terra::crop(srtm, zion, mask = TRUE), but we prefer to keep them separate for clarity.]

srtm_cropped = crop(srtm, zion)
srtm_final = mask(srtm_cropped, zion)

Changing the settings of mask() yields different results. Setting inverse = TRUE will mask everything inside the bounds of the park (see ?mask for details) (Figure \@ref(fig:cropmask)(D)), while setting updatevalue = 0 will set all pixels outside the national park to 0.

srtm_inv_masked = mask(srtm, zion, inverse = TRUE)

#| message: FALSE
#| results: hide
library(tmap)
library(rcartocolor)
terrain_colors = carto_pal(7, "Geyser")
pz1 = tm_shape(srtm) + 
  tm_raster(col.scale = tm_scale_continuous(values = terrain_colors)) +
  tm_shape(zion) + 
  tm_borders(lwd = 2) + 
  tm_title("A. Original") +
  tm_layout(legend.show = FALSE)
pz2 = tm_shape(srtm_cropped) +
  tm_raster(col.scale = tm_scale_continuous(values = terrain_colors)) +
  tm_shape(zion) +
  tm_borders(lwd = 2) + 
  tm_title("B. Crop") +
  tm_layout(legend.show = FALSE)
pz3 = tm_shape(srtm_masked) + 
  tm_raster(col.scale = tm_scale_continuous(values = terrain_colors)) +
  tm_shape(zion) + 
  tm_borders(lwd = 2) + 
  tm_title("C. Mask") +
  tm_layout(legend.show = FALSE)
pz4 = tm_shape(srtm_inv_masked) +
  tm_raster(col.scale = tm_scale_continuous(values = terrain_colors)) +
  tm_shape(zion) +
  tm_borders(lwd = 2) + 
  tm_title("D. Inverse mask") +
  tm_layout(legend.show = FALSE)
tmap_arrange(pz1, pz2, pz3, pz4, ncol = 4, asp = NA)

Raster extraction

\index{raster!extraction} Raster extraction is the process of identifying and returning the values associated with a 'target' raster at specific locations, based on a (typically vector) geographic 'selector' object. The results depend on the type of selector used (points, lines or polygons) and arguments passed to the terra::extract() function. The reverse of raster extraction --- assigning raster cell values based on vector objects --- is rasterization, described in Section \@ref(rasterization).

\index{raster!extraction points} The basic example is of extracting the value of a raster cell at specific points. For this purpose, we will use zion_points, which contain a sample of 30 locations within Zion National Park (Figure \@ref(fig:pointextr)). The following command extracts elevation values from srtm and creates a data frame with points' IDs (one value per vector's row) and related srtm values for each point. Now, we can add the resulting object to our zion_points dataset with the cbind() function:

data("zion_points", package = "spDataLarge")
elevation = terra::extract(srtm, zion_points)
zion_points = cbind(zion_points, elevation)

library(dplyr)
zion_points2 = zion_points
zion_points2$a = 1
zion_points2 = zion_points2 |> group_by(a) |> summarise()
elevation = terra::extract(srtm, zion_points2)
zion_points = cbind(zion_points, elevation)

source("code/06-pointextr.R", print.eval = TRUE)

\index{raster!extraction lines} Raster extraction also works with line selectors. Then, it extracts one value for each raster cell touched by a line. However, the line extraction approach is not recommended to obtain values along the transects, as it is hard to get the correct distance between each pair of extracted raster values.

In this case, a better approach is to split the line into many points and then extract the values for these points. To demonstrate this, the code below creates zion_transect, a straight line going from northwest to southeast of Zion National Park, illustrated in Figure \@ref(fig:lineextr)(A) (see Section \@ref(vector-data) for a recap on the vector data model):

zion_transect = cbind(c(-113.2, -112.9), c(37.45, 37.2)) |>
  st_linestring() |> 
  st_sfc(crs = crs(srtm)) |>
  st_sf(geometry = _)

# Aim: show how extraction works with non-straight lines by
# using this alternative line object:
zion_transect2 = cbind(c(-113.2, -112.9, -113.2), c(36.45, 37.2, 37.5)) |>
  st_linestring() |> 
  st_sfc(crs = crs(srtm)) |>
  st_sf()
zion_transect = rbind(zion_transect, zion_transect2)

The utility of extracting heights from a linear selector is illustrated by imagining that you are planning a hike. The method demonstrated below provides an 'elevation profile' of the route (the line does not need to be straight), useful for estimating how long it will take due to long climbs.

The first step is to add a unique id for each transect. Next, with the st_segmentize() function we can add points along our line(s) with a provided density (dfMaxLength) and convert them into points with st_cast().

zion_transect$id = 1:nrow(zion_transect)
zion_transect = st_segmentize(zion_transect, dfMaxLength = 250)
zion_transect = st_cast(zion_transect, "POINT")

Now, we have a large set of points, and we want to derive a distance between the first point in our transects and each of the subsequent points. In this case, we only have one transect, but the code, in principle, should work on any number of transects:

zion_transect = zion_transect |> 
  group_by(id) |> 
  mutate(dist = st_distance(geometry)[, 1]) 

Finally, we can extract elevation values for each point in our transects and combine this information with our main object.

zion_elev = terra::extract(srtm, zion_transect)
zion_transect = cbind(zion_transect, zion_elev)

The resulting zion_transect can be used to create elevation profiles, as illustrated in Figure \@ref(fig:lineextr)(B).

library(tmap)
library(grid)
library(ggplot2)

zion_transect_line = cbind(c(-113.2, -112.9), c(37.45, 37.2)) |>
  st_linestring() |> 
  st_sfc(crs = crs(srtm)) |> 
  st_sf()

zion_transect_points = st_cast(zion_transect, "POINT")[c(1, nrow(zion_transect)), ]
zion_transect_points$name = c("start", "end")

rast_poly_line = tm_shape(srtm) +
  tm_raster(col.scale = tm_scale_continuous(values = terrain_colors),
            col.legend = tm_legend("Elevation (m)")) + 
  tm_shape(zion) +
  tm_borders(lwd = 2) + 
  tm_shape(zion_transect_line) + 
  tm_lines(col = "black", lwd = 4) + 
  tm_shape(zion_transect_points) +   
  tm_text("name", 
          text.scale = tm_scale(bg.color = "white", bg.alpha = 0.75, auto.placement = TRUE)) +
  tm_layout(legend.frame = TRUE, legend.position = c("RIGHT", "TOP"),
            legend.bg.color = "white")

plot_transect = ggplot(zion_transect, aes(as.numeric(dist), srtm)) + 
  geom_line() +
  labs(x = "Distance (m)", y = "Elevation (m a.s.l.)") + 
  theme_bw() +
  # facet_wrap(~id) +
  theme(plot.margin = unit(c(5.5, 15.5, 5.5, 5.5), "pt"))

grid.newpage()
pushViewport(viewport(layout = grid.layout(2, 2, heights = unit(c(0.25, 5), "null"))))
grid.text("A. Line extraction", vp = viewport(layout.pos.row = 1, layout.pos.col = 1))
grid.text("B. Elevation along the line", vp = viewport(layout.pos.row = 1, layout.pos.col = 2))
print(rast_poly_line, vp = viewport(layout.pos.row = 2, layout.pos.col = 1))
print(plot_transect, vp = viewport(layout.pos.row = 2, layout.pos.col = 2))

\index{raster!extraction polygons} The final type of geographic vector object for raster extraction is polygons. Like lines, polygons tend to return many raster values per polygon. This is demonstrated in the command below, which results in a data frame with column names ID (the row number of the polygon) and srtm (associated elevation values):

# aim: create zion_many to test multi-polygon results
n = 3
zion_many = st_sample(x = zion, size = n) |> 
  st_buffer(dist = 500) |>
  st_sf(data.frame(v = 1:n), geometry = _)
plot(zion_many)

# for continuous data:
zion_srtm_values1 = terra::extract(x = srtm, y = zion_many, fun = min)
zion_srtm_values2 = terra::extract(x = srtm, y = zion_many, fun = mean)
zion_srtm_values3 = terra::extract(x = srtm, y = zion_many, fun = max)

# for categories
nlcd = rast(system.file("raster/nlcd.tif", package = "spDataLarge"))
zion_many2 = st_transform(zion_many, st_crs(nlcd))
zion_nlcd = terra::extract(nlcd, zion_many2)
count(zion_nlcd, levels)

zion_srtm_values = terra::extract(x = srtm, y = zion)

Such results can be used to generate summary statistics for raster values per polygon, for example to characterize a single region or to compare many regions. This is shown in the code below, which creates the object zion_srtm_df containing summary statistics for elevation values in Zion National Park (see Figure \@ref(fig:polyextr)(A)):

group_by(zion_srtm_values, ID) |> 
  summarize(across(srtm, list(min = min, mean = mean, max = max)))

The preceding code chunk used dplyr\index{dplyr (package)} to provide summary statistics for cell values per polygon ID, as described in Chapter \@ref(attr). The results provide useful summaries, for example that the maximum height in the park is around 2,661 meters above sea level (other summary statistics, such as standard deviation, can also be calculated in this way). Because there is only one polygon in the example, a data frame with a single row is returned; however, the method works when multiple selector polygons are used.

A similar approach works for counting occurrences of categorical raster values within polygons. This is illustrated with a land cover dataset (nlcd) from the spDataLarge package in Figure \@ref(fig:polyextr)(B), and demonstrated in the code below:

nlcd = rast(system.file("raster/nlcd.tif", package = "spDataLarge"))
zion2 = st_transform(zion, st_crs(nlcd))
zion_nlcd = terra::extract(nlcd, zion2)
zion_nlcd |> 
  group_by(ID, levels) |>
  count()

rast_poly_srtm = tm_shape(srtm) + 
  tm_raster(col.scale = tm_scale_continuous(values = terrain_colors),
            col.legend = tm_legend("Elevation (m)")) + 
  tm_shape(zion) +
  tm_polygons(lwd = 2, fill_alpha = 0.3) +
  tm_title("A. Continuous data extraction") +
  tm_layout(legend.frame = TRUE, legend.position = c("LEFT", "BOTTOM"),
            legend.bg.color = "white")
rast_poly_nlcd = tm_shape(nlcd) +
  tm_raster(col.scale = tm_scale_categorical(levels.drop = TRUE),
            col.legend = tm_legend(title = "Land cover")) + 
  # tm_raster(drop.levels = TRUE, title = "Land cover", legend.show = TRUE) + 
  tm_shape(zion) +
  tm_polygons(lwd = 2, fill_alpha = 0.3)  +
  tm_title("B. Categorical data extraction") +
  tm_layout(legend.frame = TRUE, legend.position = c("LEFT", "BOTTOM"),
            legend.bg.color = "white")
tmap_arrange(rast_poly_srtm, rast_poly_nlcd, ncol = 2)

\index{raster!extraction fractions} Although the terra package offers rapid extraction of raster values within polygons, extract() can still be a bottleneck when processing large polygon datasets. The exactextractr package offers a significantly faster alternative for extracting pixel values through the exact_extract() function. The exact_extract() function also computes, by default, the fraction of each raster cell overlapped by the polygon, which is more precise (see note below for details).

``{block2 06-raster-vector-22, type='rmdnote'} Polygons usually have irregular shapes, and, therefore, a polygon can overlap only some parts of a raster's cells. To get more detailed results, theterra::extract()function has an argument calledexact. Withexact = TRUE, we get one more columnfractionin the output data frame, which represents a fraction of each cell that is covered by the polygon. This could be useful to calculate, for example, a weighted mean for continuous rasters or more precise coverage for categorical rasters. By default, it isFALSE, as this operation requires more computations. Theexactextractr::exact_extract()` function always computes the coverage fraction of the polygon in each cell.

```r
zion_srtm_values = terra::extract(x = srtm, y = zion, exact = FALSE)

Rasterization {#rasterization}

\index{rasterization} Rasterization is the conversion of vector objects into their representation in raster objects. Usually, the output raster is then used for quantitative analysis (e.g., analysis of terrain) or modeling. As we saw in Chapter \@ref(spatial-class), the raster data model has some characteristics that make it conducive to certain methods. Furthermore, the process of rasterization can help simplify datasets because the resulting values all have the same spatial resolution: rasterization can be seen as a special type of geographic data aggregation.

The terra package contains the function rasterize() for doing this work. Its first two arguments are, x, vector object to be rasterized and, y, a 'template raster' object defining the extent, resolution and CRS of the output. The geographic resolution of the input raster has a major impact on the results: if it is too low (cell size is too large), the result may miss the full geographic variability of the vector data; if it is too high, computational times may be excessive. There are no simple rules to follow when deciding an appropriate geographic resolution, which is heavily dependent on the intended use of the results. Often the target resolution is imposed on the user, for example when the output of rasterization needs to be aligned to some other existing raster.

\index{rasterization!points} To demonstrate rasterization in action, we will use a template raster that has the same extent and CRS as the input vector data cycle_hire_osm_projected (a dataset on cycle hire points in London is illustrated in Figure \@ref(fig:vector-rasterization1)(A)) and spatial resolution of 1000 meters:

cycle_hire_osm = spData::cycle_hire_osm
cycle_hire_osm_projected = st_transform(cycle_hire_osm, "EPSG:27700")
raster_template = rast(ext(cycle_hire_osm_projected), resolution = 1000,
                       crs = crs(cycle_hire_osm_projected))

Rasterization is a very flexible operation: the results depend not only on the nature of the template raster, but also on the type of input vector (e.g., points, polygons) and a variety of arguments taken by the rasterize() function.

To illustrate this flexibility, we will try three different approaches to rasterization. First, we create a raster representing the presence or absence of cycle hire points (known as presence/absence rasters). In this case rasterize() requires no argument in addition to x and y, the aforementioned vector and raster objects (results illustrated Figure \@ref(fig:vector-rasterization1)(B)).

ch_raster1 = rasterize(cycle_hire_osm_projected, raster_template)

The fun argument specifies summary statistics used to convert multiple observations in close proximity into associate cells in the raster object. By default fun = "last" is used, but other options such as fun = "length" can be used, in this case to count the number of cycle hire points in each grid cell (the results of this operation are illustrated in Figure \@ref(fig:vector-rasterization1)(C)).

ch_raster2 = rasterize(cycle_hire_osm_projected, raster_template, 
                       fun = "length")

The new output, ch_raster2, shows the number of cycle hire points in each grid cell. The cycle hire locations have different numbers of bicycles described by the capacity variable, raising the question, what's the capacity in each grid cell? To calculate that we must sum the field ("capacity"), resulting in output illustrated in Figure \@ref(fig:vector-rasterization1)(D), calculated with the following command (other summary functions such as mean could be used).

ch_raster3 = rasterize(cycle_hire_osm_projected, raster_template, 
                       field = "capacity", fun = sum, na.rm = TRUE)

source("code/06-vector-rasterization1.R", print.eval = TRUE)

\index{rasterization!lines} \index{rasterization!polygons} Another dataset based on California's polygons and borders (created below) illustrates rasterization of lines. After casting the polygon objects into a multilinestring, a template raster is created with a resolution of a 0.5 degree:

california = dplyr::filter(us_states, NAME == "California")
california_borders = st_cast(california, "MULTILINESTRING")
raster_template2 = rast(ext(california), resolution = 0.5,
                        crs = st_crs(california)$wkt)

When considering line or polygon rasterization, one useful additional argument is touches. By default it is FALSE, but when changed to TRUE, all cells that are touched by a line or polygon border get a value. Line rasterization with touches = TRUE is demonstrated in the code below (Figure \@ref(fig:vector-rasterization2)(A)).

california_raster1 = rasterize(california_borders, raster_template2,
                               touches = TRUE)

Compare it to a polygon rasterization, with touches = FALSE by default, which selects only raster cells whose centroids are inside the selector polygon, as illustrated in Figure \@ref(fig:vector-rasterization2)(B).

california_raster2 = rasterize(california, raster_template2) 

source("code/06-vector-rasterization2.R", print.eval = TRUE)

Spatial vectorization

\index{spatial vectorization} Spatial vectorization is the counterpart of rasterization (Section \@ref(rasterization)), but in the opposite direction. It involves converting spatially continuous raster data into spatially discrete vector data such as points, lines or polygons.

``{block2 06-raster-vector-33, type="rmdnote"} Be careful with the wording! In R, vectorization usually refers to the possibility of replacingfor-loops and alike by doing things like1:10 / 2` (see also @wickham_advanced_2019).

\index{spatial vectorization!points} 
The simplest form of vectorization is to convert the centroids of raster cells into points.
`as.points()` does exactly this for all non-`NA` raster grid cells (Figure \@ref(fig:raster-vectorization1)).
Note, here we also used `st_as_sf()` to convert the resulting object to the `sf` class.

```r
elev = rast(system.file("raster/elev.tif", package = "spData"))
elev_point = as.points(elev) |> 
  st_as_sf()

source("code/06-raster-vectorization1.R", print.eval = TRUE)

\index{spatial vectorization!contours} Another common type of spatial vectorization is the creation of contour lines representing lines of continuous height or temperatures (isotherms), for example. We will use a real-world digital elevation model (DEM) because the artificial raster elev produces parallel lines (task for the reader: verify this and explain why this happens). Contour lines can be created with the terra function as.contour(), which is itself a wrapper around the built-in R function filled.contour(), as demonstrated below (not shown):

dem = rast(system.file("raster/dem.tif", package = "spDataLarge"))
cl = as.contour(dem) |> 
  st_as_sf()
plot(dem, axes = FALSE)
plot(cl, add = TRUE)

Contours can also be added to existing plots with functions such as contour(), rasterVis::contourplot(). As illustrated in Figure \@ref(fig:contour-tmap), isolines can be labeled.

\index{hillshade}

# hs = shade(slope = terrain(dem, "slope", unit = "radians"),
#            aspect = terrain(dem, "aspect", unit = "radians"))
# plot(hs, col = gray(0:100 / 100), legend = FALSE)
# # overlay with DEM
# plot(dem, col = terrain.colors(25), alpha = 0.5, legend = FALSE, add = TRUE)
# # add contour lines
# contour(dem, col = "white", add = TRUE)
knitr::include_graphics("images/06-contour-tmap.png")

\index{spatial vectorization!polygons} The final type of vectorization involves conversion of rasters to polygons. This can be done with terra::as.polygons(), which converts each raster cell into a polygon consisting of five coordinates, all of which are stored in memory (explaining why rasters are often fast compared with vectors!).

This is illustrated below by converting the grain object into polygons and subsequently dissolving borders between polygons with the same attribute values (also see the dissolve argument in as.polygons()).

grain = rast(system.file("raster/grain.tif", package = "spData"))
grain_poly = as.polygons(grain) |> 
  st_as_sf()

source("code/06-raster-vectorization2.R", print.eval = TRUE)

The aggregated polygons of the grain dataset have rectilinear boundaries which arise from being defined by connecting rectangular pixels. The smoothr package described in Chapter \@ref(geometry-operations) can be used to smooth the edges of the polygons. As smoothing removes sharp edges in the polygon boundaries, the smoothed polygons will not have the same exact spatial coverage as the original pixels. Caution should therefore be taken when using the smoothed polygons for further analysis.

Exercises

res = knitr::knit_child('_06-ex.Rmd', quiet = TRUE, options = list(include = FALSE, eval = FALSE))
cat(res, sep = '\n')

Robinlovelace/geocompr documentation built on June 14, 2025, 1:21 p.m.