R xy.coords 提取绘图结构

说明

xy.coords许多函数使用它来获取用于绘图的 x 和 y 坐标。在所有相关领域使用这种通用机制R函数产生一致性的度量。

用法

xy.coords(x, y = NULL, xlab = NULL, ylab = NULL, log = NULL,
          recycle = FALSE, setLab = TRUE)

参数

x, y	一组点的 x 和 y 坐标。或者，可以提供单个参数x。
xlab, ylab	要提取的 x 和 y 变量的名称。
log	字符、 "x" 、 "y" 或两者，如 plot 。将负值设置为 NA 并给出类 "log_le_0" 的警告。
recycle	逻辑性；如果 TRUE ，则回收 ( rep ) x 或 y 中较短的一个(如果它们的长度不同)。
setLab	逻辑指示是否应从 (x,y) 的 “kind” 构造生成的 xlab 和 ylab ；否则，使用参数xlab 和ylab。

细节

尝试以适合二元绘图(或其他二元过程)的方式解释参数 x 和 y。

如果 y 是 NULL 并且 x 是

公式：

形式为 yvar ~ xvar 。 xvar 和 yvar 用作 x 和 y 变量。

列表：

包含组件 x 和 y ，它们用于定义绘图坐标。

时间序列：

x 值被视为time(x)，y 值被视为时间序列。

矩阵或具有两列或更多列的data.frame：

假设第一个包含 x 值，第二个包含 y 值。请注意，如果 x 具有名为 "x" 和 "y" 的列，情况也是如此；这些名称在这里无关紧要。

在任何其他情况下， x 参数被强制为向量并作为 y 分量返回，其中生成的 x 只是索引向量 1:n 。在这种情况下，生成的 xlab 组件设置为 "Index"(如果默认情况下 setLab 为 true)。

如果 x (经过上述转换)继承自类 "POSIXt" ，它将被强制为类 "POSIXct" 。

值

包含组件的列表

x	横坐标值的数字(即 "double" )向量。
y	与 x 长度相同的数值向量。
xlab	character(1) 或 NULL 、x 的 ‘label’ 。
ylab	character(1) 或 NULL 、y 的 ‘label’ 。

例子

ff <- stats::fft(1:9)
xy.coords(ff)
xy.coords(ff, xlab = "fft") # labels "Re(fft)",  "Im(fft)"

with(cars, xy.coords(dist ~ speed, NULL)$xlab ) # = "speed"

xy.coords(1:3, 1:2, recycle = TRUE) # otherwise error "lengths differ"
xy.coords(-2:10, log = "y")
##> xlab: "Index"  \\  warning: 3 y values <= 0 omitted ..
op <- options(warn = 2)# ==> warnings would be errors, we suppress the one "we know":
suppressWarnings(xy.coords(-2:10, log = "y"), classes="log_le_0") -> xy
options(op) # revert
stopifnot(is.list(xy), identical (1:13 +0,  xy$x),
          identical(c(rep(NA, 3), 1:10 +0), xy$y))

也可以看看

plot.default 、 lines 、 points 和 lowess 是使用此机制的函数示例。