R码的实例/最佳做法

Question

我是新来的R并具有难以拼凑的信息来自各种来源的网络相关的是什么认为"良好"做法与编写R代码。我读过基本指南，但我已经有一个很难找到的信息，这肯定是最新的。

1. 什么是一些实例以及撰写/记录S3类？
2. 关于如何对应S4类？
3. 什么样的约定你时使用的评论。R类/职能？你把所有的评论意见。路的文件。R文件吗？是同步的，这些文件令人厌烦?

Answer 1

是否使用S3、S4，或者在所有主要是风格问题(如德克说)，但是我建议采用那个，如果你想拥有一个非常好的结构目的(正如你在任何面向对象的语言)。例如，所有的时间系列的课程有的时间系列的对象(我认为，他们是所有S3除外 它的)，因为它允许他们强制实施某些行为围绕建设和使用情况的那些对象。同样的问题，关于创建一个包：这是一个好主意，要做到这个，如果你将被重新使用你的代码常，或者如果该守则将是有益的其他人。它需要一点更多的努力，但添加的组织结构可以很容易地弥补费用。

关于与S3S4(上讨论过的R-帮助 在这里， 和 在这里，)，基本原则是S3类更多 "快速" 同时S4类的地方更多 刚性控制的对象和类型.如果你在工作上使用bioconductor，通常将使用S4(参见，例如， "S4类和方法").

我会推荐读了一些如下：

1. "一个(不)短的介绍S4"，由克里斯托夫Genolini
2. "程序'的位置：一个简单的类，在S3和S4"由托马斯*拉姆利
3. "Brobdingnag:"hello world"包的使用S4方法"通过罗宾*K。S.Hankin
4. "转换包S4"道格拉斯*贝茨
5. "如何S4工作方法"通过约翰室

对文件，哈德利的建议是:Roxygen将使生活更容易并使文件旁边的代码。除此之外，您可能仍然希望提供其他评论在你的代码 超越 什么Roxygen或该男子文件需要，在这种情况下，这是一个很好的实践来评论你的代码，用于其他开发商。这些意见将不会在你的包；他们将只是可见的源码。

Answer 2

3.使用roxygen-它就像如果是的话，为什么不试采取的评论在你的源文件和建立路的文件。

Answer 3

这是一半，十几个或更多的问题捆绑为一体，这使得它难以答复。

因此，让我们试着从内部出：第一次尝试，以解决你的RODBC包装的问题。一个代码表示将建议本身。我将开始简单的功能，那么也许建立一个包围。已经给了你一封装。

很多剩下的风格。一些突出的R码发誓S4，而其他发誓。你总是可以读取软件包的其他人以及编码研本身。你总是可以重新实现你的RODBC包装在不同的方式和方法的比较自己的方法。

编辑： 反射你更新和更短的问题：挑选一些软件包从CRAN，特别是在那些你使用。我觉得你很快就会发现某些或多或少有趣的根据你的风格。

Answer 4

有些更多的风格有关于物质，但是 谷歌R导风格 值得阅读：