干货 | MIT手把手教你一步步创建自己的R程序包

原作者：Data Scientist PakinJa

编译：笪洁琼，张天健，云州

R语言对于数据科学家的重要性不言而喻，但配置R程序包的过程往往让一些菜鸟学习者望而却步，这篇文章将带着你跟着MIT的指导一步步的创建自己的R程序包。

*详细代码请参考文末原文地址喔！

首先打开一个新的R文件，确保你的默认目录是清楚的通过rm进行输入的（list=ls())。查看Is()，确保它是空的（你应该能够清楚的看见（0））。

在R文件中可以为你的程序编写代码。你可以创建一个包含所有函数的文件，或者是为每个函数都创建单独的文件。将文件保存到你能快速找到的地方。

安装‘devtools’ 安装包，(代码：install.packages(‘devtools’))

在RStudio.中打开一个新的项目，在“文件”菜单中的点击“新项目”，然后选择“新目录（New DIrectory）”并选择“R包（R Package）”创建一个新的R包。

命名你的安装包，然后上传。在第一步源文件创建包的基础上，创建R文件，点击“创建项目”。

在屏幕的右下角，你会看到一个文件目录，“R”文件中包含了函数的代码。“man”文件中将包含了文件中函数的所有帮助文件。根据Rstudio的版本，当你在创建R安装包或者R文档时，帮助文件会自动生成。如果“man”文件夹中已经包含.Rd文件，打开每个文件，添加一个标题然后保存.(如果不是，请见步骤7）。你可以返回并在稍后编辑这些内容。但是为了编译你的安装包，你需要在每个.Rd的文件下添加一个标题。

如果你的“man”文件夹是空的，那么你需要为每个函数手动创建一个.Rd文件。方法是：打开文件菜单—创建新的文件—选择R文件。输入函数的标题并在Rd template的菜单下选择函数。编辑你的新文件要包含标题域（再次强调，你可以选择现在编辑或者是稍后编辑，如果标题域是空的，那么你的安装包将无法编译）。保存“man”文件夹中的每一个.Rd文件。

注意：如果你需要在你的安装包里添加更多的函数，那么你需要重复以上步骤。即使是在你一开始创建安装包和RStudio自动生成R记录文件的时候。

现在你已经可以开始编译你的安装包了。在顶部工具栏里选择创建或者“创建和重载”（注意：你可以用快捷键Ctrl+Shift+B）。如果以上操作有效，你的安装包将会自动加载并且你会在底部的控制台上看到一个库（你的新安装包）。测试你的函数确保其有效运行。
 

返回并为每个函数编辑其记录文件（帮助文件）。打开每一个.Rd文件，为安装包添加一段简短的描述。如果可以的话,至少包含一个实例。接着，重载你的安装包，在R控制台上彻底检验你的文件。注意：每次改变你的函数和文件时，你都会需要重新编译（重复步骤8）。

一旦你完成创建你的函数和记录文件时，编译你的安装包，并反复检查函数和帮助文件是否能运行，把包含安装包的完整文件复制到Dropbox （共享网盘程序）并用你的名字命名。