mf_export function

Export a map

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

Returns

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

Examples

mtq <- mf_get_mtq()
(filename <- tempfile(fileext = ".png"))
mf_export(mtq, filename = filename)
mf_map(mtq, add = TRUE)
dev.off()