使用 Roxygen 记录 setAs() 和 setOldClass()

Question

我正在开发一个提供名为“Foo”的 S3 类的包。它还提供了一个“as”方法，用于将其强制到（其他人的）名为“Bar”的 S4 类。我的代码如下所示：

#' ...
setOldClass("Foo")

#' ...
setAs("Foo", "SpatialPointsDataFrame", function(from) { 
   # do stuff and return a SpatialPointsDataFrame
})

编辑我已经尝试过：

#' ...
#' @name as
#' @export
setAs("Foo", "SpatialPointsDataFrame", function(from) { 
   # do stuff and return a SpatialPointsDataFrame
})

但后来我从 R CMD CHECK 得到了这个：

检查名称空间是否可以加载指定的依赖项...警告 命名空间导出（ns，导出）中的错误：未定义的导出：as 调用：loadNamespace ->命名空间导出 执行停止

命名空间必须能够仅加载基本命名空间：否则，如果命名空间由已保存的对象加载，则会话将无法启动。

可能需要在 NAMESPACE 文件中声明一些导入。

在一个单独的 .R 文件中，我有：

#' @importClassesFrom sp SpatialPointsDataFrame

我正在使用 hadley 的 devtools 包，所以我猜它是 roxygen2。这就是我所做的：

R> document("MyPackage")

Answer 1

roxygen2 解析器未解析 setOldClass() 和 setAs()。
我们需要获取适当的@name标签。

#' "Foo" class
#'
#' @name Foo-class
#' @aliases Foo
#' @family Foo
#'
#' @exportClass Foo
setOldClass("Foo")

#' As("Foo", "SpatialPointsDataFrame")
#'
#' @name as
#' @family Foo
#'
#' @importClassesFrom sp SpatialPointsDataFrame
setAs("Foo", "SpatialPointsDataFrame", function(from) { 
   # do stuff and return a SpatialPointsDataFrame
})

我不详细了解 setAs() 函数，但 as() 函数是从方法包中加载的。
因此，我认为我们不需要在 NAMESPACE 中添加 export(as) 条目。