sp_from_data_frame: Function to promote a data frame to a SpatialPointsDataFrame,...

View source: R/sp_from_data_frame.R

sp_from_data_frameR Documentation

Function to promote a data frame to a SpatialPointsDataFrame, SpatialLinesDataFrame, or SpatialPolygonsDataFrame.

Description

Function to promote a data frame to a SpatialPointsDataFrame, SpatialLinesDataFrame, or SpatialPolygonsDataFrame.

Usage

sp_from_data_frame(
  df,
  type = "points",
  latitude = "latitude",
  longitude = "longitude",
  projection = projection_wgs84(),
  keep = FALSE,
  id = NA,
  warn = TRUE
)

Arguments

df

Data frame to be converted into spatial data frame.

type

Type of geometry. Type must be one of "points", "lines", or "polygons".

latitude

df's latitude variable name.

longitude

df's longitude variable name.

projection

df's latitude and longitude projection system. Default is WGS84.

keep

For when type is "points", should latitude and longitude be kept in the SpatialPointsDataFrame's data slot?

id

Variable in df which codes for spatial object's id. This is used when a data frame contains many separate geometries. id is not used for points because each point is a separate geometry.

warn

Should the function raise a warning when observations are removed?

Value

A SpatialPointsDataFrame, SpatialLinesDataFrame, or SpatialPolygonsDataFrame.

Author(s)

Stuart K. Grange

See Also

sp_from_wkt

Examples

## Not run: 

# Promote to different geometry types
# Points
sp_points <- sp_from_data_frame(data_drawn, type = "points")

# Lines
sp_lines <- sp_from_data_frame(data_drawn, type = "lines")
# Lines with seperate geometries
sp_lines <- sp_from_data_frame(data_drawn, type = "lines", id = "name")

# Polygons
sp_polygons <- sp_from_data_frame(data_drawn, type = "polygons")
# Polygons with seperate geometries
sp_polygons <- sp_from_data_frame(data_drawn, type = "polygons", id = "name")


## End(Not run)


skgrange/gissr documentation built on Feb. 24, 2024, 2:55 p.m.