Export a map — mf_export • mapsf

Export a map with the extent of a spatial object.
The map is exported in PNG or SVG format.
If only one of width or height is set, mf_export uses the width/height ratio of x bounding box to find a matching ratio for the export.
Always use add = TRUE in mf_map calls following an mf_export call.
Use dev.off to finish the export (see Examples).

mf_export(
  x,
  filename = "map.png",
  width,
  height,
  res = 96,
  ...,
  expandBB = rep(0, 4),
  theme,
  export = "png"
)

Arguments

x: object of class sf, sfc or SpatRaster
filename: path to the exported file. If the file extention is ".png" a png graphic device is opened, if the file extension is ".svg" a svg graphic device is opened.
width: width of the figure (pixels for png, inches for svg)
height: height of the figure (pixels for png, inches for svg)
res: resolution (for png)
...: further parameters for png or svg export
expandBB: fractional values to expand the bounding box with, in each direction (bottom, left, top, right)
theme: apply a theme (deprecated)
export: deprecated

Value

No return value, a map file is initiated (in PNG or SVG format).

Examples

mtq <- mf_get_mtq()
(filename <- tempfile(fileext = ".png"))
#> [1] "/tmp/RtmpDtIJHY/file1f8a6bfe5fce.png"
mf_export(mtq, filename = filename)
mf_map(mtq, add = TRUE)
dev.off()
#> agg_png 
#>       2