sf (version 0.2-8)

st_write: Write simple features object to file or database

Description

Write simple features object to file or database

Usage

st_write(obj, dsn, layer = basename(dsn), driver = guess_driver_can_write(dsn), ..., dataset_options = NULL, layer_options = NULL, quiet = FALSE, factorsAsCharacter = TRUE)

Arguments

obj

object of class sf or sfc

dsn

data source name (interpretation varies by driver - for some drivers, dsn is a file name, but may also be a folder or contain a database name)

layer

layer name (varies by driver, may be a file name without extension); if layer is missing, the basename of dsn is taken.

driver

character; driver name to be used, if missing, a driver name is guessed from dsn; st_drivers() returns the drivers that are available with their properties; links to full driver documentation are found at http://www.gdal.org/ogr_formats.html.

...

ignored

dataset_options

character; driver dependent dataset creation options; multiple options supported.

layer_options

character; driver dependent layer creation options; multiple options supported.

quiet

logical; suppress info on name, driver, size and spatial reference

factorsAsCharacter

logical; convert factor objects into character strings (default), else into numbers by as.numeric.

Details

columns (variables) of a class not supported are dropped with a warning.

See Also

st_drivers

Examples

if (Sys.getenv("USER") %in% c("edzer", "travis")) { # load meuse to postgis
 library(sp)
 example(meuse, ask = FALSE, echo = FALSE)
 st_write(st_as_sf(meuse), "PG:dbname=postgis", "meuse_sf",
   layer_options = c("OVERWRITE=yes", "LAUNDER=true"))
 demo(nc, ask = FALSE)
 st_write(nc, "PG:dbname=postgis", "sids", layer_options = "OVERWRITE=true")
}
nc = st_read(system.file("shape/nc.shp", package="sf"))
st_write(nc, "nc.shp")