Create raster file — vapour

This is in an incomplete interface to raster writing, for exploring.

vapour_create(
  filename,
  driver = "GTiff",
  extent = c(-180, 180, -90, 90),
  dimension = c(2048, 1024),
  projection = "OGC:CRS84",
  n_bands = 1L,
  overwrite = FALSE
)

Arguments

filename: filename/path to create
driver: GDAL driver to use (GTiff is default, and recommended)
extent: xmin,xmax,ymin,ymax 4-element vector
dimension: dimension of the output, X * Y
projection: projection of the output, best to use a full WKT but any string accepted
n_bands: number of bands in the output, default is 1
overwrite: not TRUE by default

Value

the file path that was created

Details

If GeoTIFF is used (driver = "GTiff", recommended) then the output is tiled 512x512, and has DEFLATE compression, and is sparse when created (no values are initiated, so the file is tiny).

Note that there is no restriction on where you can read or write from, the responsibility is yours. In future we will allow control of output tiling and data type etc.

Examples

tfile <- tempfile(fileext = ".tif")
if (!file.exists(tfile)) {
 vapour_create(tfile, extent = c(-1, 1, -1, 1) * 1e6, 
                     dimension = c(128, 128), 
                     projection = "+proj=laea")
 file.remove(tfile)
}
#> Driver GTiff supports Create() method.
#> [1] TRUE