【问题标题】:R S3 method not exported from namespaceR S3 方法未从命名空间导出
【发布时间】:2018-08-25 10:13:01
【问题描述】:

为什么我有这个错误信息:

> vegan::reorder.hclust
Error: 'reorder.hclust' is not an exported object from 'namespace:vegan'

虽然这种 S3 方法很好用。例如,如果我输入help(reorder.hclust, package = "vegan"),我将获得预期的帮助页面,vegan:::reorder.hclust 在控制台上显示函数的源代码...
我的vegan 安装的NAMESPACE 文件也包含S3method(reorder, hclust)

我想在另一个包中使用这个功能,我需要导入它或使用vegan::reorder.hclust

> sessionInfo()
R version 3.4.3 (2017-11-30)
Platform: x86_64-pc-linux-gnu (64-bit)
Running under: Ubuntu 16.04.4 LTS

Matrix products: default
BLAS: /usr/lib/libblas/libblas.so.3.6.0
LAPACK: /usr/lib/lapack/liblapack.so.3.6.0

locale:
 [1] LC_CTYPE=fr_BE.UTF-8       LC_NUMERIC=C               LC_TIME=fr_BE.UTF-8       
 [4] LC_COLLATE=fr_BE.UTF-8     LC_MONETARY=fr_BE.UTF-8    LC_MESSAGES=fr_BE.UTF-8   
 [7] LC_PAPER=fr_BE.UTF-8       LC_NAME=C                  LC_ADDRESS=C              
[10] LC_TELEPHONE=C             LC_MEASUREMENT=fr_BE.UTF-8 LC_IDENTIFICATION=C       

attached base packages:
[1] stats     graphics  grDevices utils     datasets  methods   base     

loaded via a namespace (and not attached):
 [1] MASS_7.3-49     compiler_3.4.3  Matrix_1.2-11   parallel_3.4.3  tools_3.4.3    
 [6] mgcv_1.8-23     yaml_2.1.18     nlme_3.1-131.1  grid_3.4.3      permute_0.9-4  
[11] vegan_2.4-6     cluster_2.0.6   lattice_0.20-35

【问题讨论】:

标签: r namespaces package vegan


【解决方案1】:

您收到该错误是因为vegan 没有导出该函数。它可以为未导出的内容提供帮助。使用三个冒号vegan:::reorder.hclust显示未导出的内部函数;通常你应该避免使用这些。

但是,当vegan 包被加载时,它的reorder.hclust 函数将被添加到reorder 的方法表中。所以你只需要确保它被加载,然后如果hc 是一个hclust 对象,reorder(hc) 将调用reorder.hclust 方法。您可以通过将 requireNamespace("vegan") 放入您的代码中,或从您的 NAMESPACE 文件中的 vegan 导入某些内容来做到这一点。

如果有两个reorder.hclust 方法(由同时加载的不同包定义),那么我认为除了使用vegan:::reorder.hclust 之外,我认为没有一种简单的方法可以让您指定vegan,CRAN会反对。你需要让vegan 维护者导出他们的函数,这样你就可以使用合法的vegan::reorder.hclust 访问它,或者将代码复制到你自己的包中,或者其他一些不方便的方法。

【讨论】:

  • utils::getFromNamespace("reorder.hclust", "vegan") 是使用该功能并通过 CRAN 测试的一种方法。
  • 文档警告不要使用getFromNamespace:“不应在生产代码中使用”。因此,CRAN 可能会在稍后将其添加到其测试中。
  • 感谢您的回答!我不明白的东西:S3method(reorder, hclust) 不是从 vegan 导出它的方式(这是在包的 NAMESPACE 文件中)?
  • 总结一下:目前有 3 个解决方案:1)联系纯素开发者让他导出函数(但是如果 S3method(reorder, hclust) 不是这样做的方法怎么办?),2)复制我的包中的代码(不是很好 - 这是我目前所做的)3)根据@RolandASc指出的类似问题的答案:在我的包的描述中添加Depends: vegan以强制这个包是附上(也不是很好)。也许也可以(使用utils::getFromNamespace("reorder.hclust", "vegan"),但似乎不推荐这样做。
  • 只有两个后续:双点符号不会导致包被附加,只是被加载。它仅适用于从包中导出的函数。所以vegan::vegdist 会在安装后触发加载包。同样,importFrom("vegan", "vegdist") 可以加载它,但您不能导入类似 reorder.hclust 的东西,因为它没有被导出。
猜你喜欢
  • 1970-01-01
  • 2013-09-01
  • 1970-01-01
  • 2014-11-02
  • 2021-02-26
  • 1970-01-01
  • 2013-04-24
  • 2018-09-23
相关资源
最近更新 更多