R语言【sp】——SpatialPoints()，SpatialPointsDataFrame()：创建类 SpatialPoints 或 SpatialPointsDataFrame 的对象

Package sp version 1.5-0

---

Description

从坐标和坐标和数据帧创建类SpatialPoints-class或SpatialPointsDataFrame-class的对象。

---

Usage

SpatialPoints(coords, proj4string=CRS(as.character(NA)), bbox = NULL)
SpatialPointsDataFrame(coords, data, coords.nrs = numeric(0), 
      proj4string = CRS(as.character(NA)), match.ID, bbox = NULL)

---

Arguments

参数【coords】：带有坐标的数字矩阵或数据帧(每行是一个点)；在SpatialPointsDataFrame的情况下，也允许一个SpatialPoints-class类的对象。

参数【proj4string】：类 CRS-class 的映射字符串。

参数【bbox】：边界框矩阵，通常为NULL，由数据构造，但如果明确需要，可以通过强制转换。

参数【data】：类data.frame的对象；数据中的行数应该等于坐标对象中的点数。

参数【coords.nrs】：数值；如果存在，则记录数据中获取坐标的列位置(由坐标<-使用)。

参数【match.ID】：逻辑值或字符值；如果缺少，并且坐标和数据都有行名，并且它们的顺序不对应，则由这些行名进行匹配并发出警告;可以通过设置match.ID为TRUE来抑制此警告。如果TRUE AND coordinates具有非自动行名(即，由as强制到矩阵)。矩阵，dimnames(coordinates)[[1]]不是NULL)， AND数据有行名(即是一个data.frame)，那么SpatialPointsDataFrame对象通过匹配两个组件的行名而形成，保持坐标的顺序不变。检查两个行名是否足够唯一，以及所有数据是否匹配。如果为FALSE，坐标和数据简单地“粘合”在一起，忽略行名。If character:表示数据中有坐标id的列，用于匹配记录。请看下面的例子。

---

Value

SpatialPoints 返回一个类SpatialPoints对象。

SpatialPointsDataFrame 返回一个类SpatialPointDaaFrame对象。

---

Examples

set.seed(1331)
pts = cbind(1:5, 1:5)
dimnames(pts)[[1]] = letters[1:5]
df = data.frame(a = 1:5)
row.names(df) = letters[5:1]

library(sp)
options(warn=1) # show warnings where they occur
SpatialPointsDataFrame(pts, df) # warn
SpatialPointsDataFrame(pts, df, match.ID = TRUE) # don't warn
SpatialPointsDataFrame(pts, df, match.ID = FALSE) # don't warn
df$m = letters[5:1]
SpatialPointsDataFrame(pts, df, match.ID = "m") # don't warn

dimnames(pts)[[1]] = letters[5:1]
SpatialPointsDataFrame(pts, df)