Write SpatVector data to a file

Write a SpatVector to a file. You can choose one of many file formats.

# S4 method for SpatVector,character
writeVector(x, filename, filetype=NULL, layer=NULL, insert=FALSE,
    overwrite=FALSE, options="ENCODING=UTF-8")

Arguments

x

SpatVector

filename

character. Output filename

filetype

character. A file format associated with a GDAL "driver" such as "ESRI Shapefile". See gdal(drivers=TRUE) or the GDAL docs. If NULL it is attempted to guess the filetype from the filename extension

layer

character. Output layer name. If NULL the filename is used

insert

logical. If TRUE, a new layer is inserted into the file, if the format allows it (e.g. GPKG allows that). See vector_layers to remove a layer

overwrite

logical. If TRUE, filename is overwritten

options

character. Format specific GDAL options such as "ENCODING=UTF-8". Use NULL or "" to not use any options

Examples

v <- vect(cbind(1:5,1:5))
crs(v) <- "+proj=longlat +datum=WGS84"
v$id <- 1:length(v)
v$name <- letters[1:length(v)]
tmpf1 <- paste0(tempfile(), ".gpkg")
writeVector(v, tmpf1)
#> Error: [writeVector] file exists. Use 'overwrite=TRUE' to overwrite it
x <- vect(tmpf1)
#> Error: [vect] file does not exist: /var/folders/24/8k48jl6d249_n_qfxwsl6xvm0000gn/T//RtmphXR5wT/fileb8225efb0a21.gpkg

f <- system.file("ex/lux.shp", package="terra")
v <- vect(f)
tmpf2 <- paste0(tempfile(), ".gpkg")
writeVector(v, tmpf2)
#> Error: [writeVector] file exists. Use 'overwrite=TRUE' to overwrite it
y <- vect(tmpf2)
#> Error: [vect] file does not exist: /var/folders/24/8k48jl6d249_n_qfxwsl6xvm0000gn/T//RtmphXR5wT/fileb82233562d3e.gpkg