The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.

Get Started

Starting with rasterpic is very easy! You just need an image (png, jpeg/jpg or tif/tiff) and a spatial object from the sf or the terra package to start using it.

Basic usage

Here we use the shape of Austria as an example:

library(sf)
library(terra)
library(rasterpic)

# Plot
library(tidyterra)
library(ggplot2)

# Shape and image
x <- read_sf(system.file("gpkg/austria.gpkg", package = "rasterpic"))
img <- system.file("img/vertical.png", package = "rasterpic")

# Create the raster!

default <- rasterpic_img(x, img)

autoplot(default) +
  geom_sf(data = x)

Options

The function provides several options for expansion, alignment, and cropping.

Expand

With this option, the image is expanded beyond the spatial object:

expand <- rasterpic_img(x, img, expand = 1)

autoplot(expand) +
  geom_sf(data = x)

Alignment

Decide where to align the image:

bottom <- rasterpic_img(x, img, valign = 0)

autoplot(bottom) +
  geom_sf(data = x)

Crop and mask

Create impressive maps:

mask <- rasterpic_img(x, img, crop = TRUE, mask = TRUE)

autoplot(mask)


maskinverse <- rasterpic_img(x, img, crop = TRUE, mask = TRUE, inverse = TRUE)

autoplot(maskinverse)

Supported objects for geotagging

Supported image formats

rasterpic can parse the following image formats:

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.