text: Add labels to a map

In terra: Spatial Data Analysis

Add labels to a map

Description

Plots labels, that is a textual (rather than color) representation of values, on top an existing plot (map).

Usage

## S4 method for signature 'SpatRaster'
text(x, labels, digits=0, halo=FALSE, hc="white", hw=0.1, jitter=0, ...)

## S4 method for signature 'SpatVector'
text(x, labels, halo=FALSE, inside=FALSE, hc="white", hw=0.1, jitter=0, ...)

Arguments

x	SpatRaster or SpatVector
labels	character. Optional. Vector of labels with length(x) or a variable name from names(x)
digits	integer. How many digits should be used?
halo	logical. If TRUE a "halo" is printed around the text
hc	character. The halo color
hw	numeric. The halo width
inside	logical. Should the text always be placed inside one the sub-geometries?
jitter	numeric. The amount of random noise used to adjust label positions, possibly avoiding overlaps. See argument 'factor' in jitter
...	additional arguments to pass to graphics function text

See Also

text, plot, halo

Examples

 
r <- rast(nrows=4, ncols=4)
values(r) <- 1:ncell(r)

plot(r)
text(r)

set.seed(123)
text(r, jitter = 2, col = "red", halo = TRUE)

plot(r)
text(r, halo=TRUE, hc="blue", col="white", hw=0.2)

plot(r, col=rainbow(16))
text(r, col=c("black", "white"), vfont=c("sans serif", "bold"), cex=2)

terra documentation built on Jan. 12, 2026, 9:07 a.m.