rstudio 代码注释_如何使用RStudio代码段
rstudio 代码注释
“代码片段”仅仅是宏或模板- 和一个伟大的方式编写脚本时节省时间的另一个短语。 代码片段不仅可以减少您在编码时的击键； 他们还节省了您的搜索时间，以尝试查找六个月前就正确而又不再记得的复杂代码。
这是它们在RStudio中的工作方式以及如何制作自己的作品。
样本图
由于我对例如无处不在的mtcar和虹膜数据集有些厌倦，因此我将在此演示中使用一些有关IT Manager薪水的信息（来自Computerworld薪水调查）。 如果您想继续，这是我的数据框。
salaries <- data.frame(
Year = c("2017", "2016", "2015", "2014", "2013", "2012") ,
Salary = c(99053L, 96413L, 95619L, 92724L, 91686L, 90165L)
)黑白图是此数据的ggplot2默认条形图的外观。
沙龙·马克斯（IDG）
ggplot2中的默认图形。
颜色版本是我希望最终图形显示的颜色。
沙龙·马克斯（IDG）
调整后的ggplot图。
我花了很多时间来调整图形代码。 我更改了条形颜色，添加了标签，在y轴上添加了逗号，使标题和副标题居中……。 我永远不会忘记如何在不查找的情况下再次执行所有操作。
这是图形代码。 请注意，除了ggplot2外，还需要安装和加载scales软件包。
ggplot(salaries, aes(x=Year, y=Salary)) +
geom_col(color = "black", fill="#0072B2") +
theme_minimal() +
theme(panel.border = element_blank(), panel.grid.major = element_blank(),
panel.grid.minor = element_blank(), axis.line = element_line(colour = "gray"),
plot.title = element_text(hjust = 0.5),
plot.subtitle = element_text(hjust = 0.5)
) +
scale_y_continuous(label = comma) +
xlab("") +
ylab("") +
geom_text(aes(label=scales::dollar(Salary)), vjust=1.5, colour="white", position=position_dodge(.9), size=5) +
ggtitle("IT Manager Salaries by Year", subtitle = "Source: Computerworld IT Salary Survey")
我可以将图形保存在文件中，希望我记得文件在哪里。 或者，我可以使用所有这些默认值创建一个函数，但是如果我想在下一次进行更多调整时，这并不总是我的首选。
相反，我编写了一个代码段。
RStudio带有一些自己的内置摘要。 当我创建自己的添加到内置对象时，我将其命名为my_underscore。 这样，当我开始在脚本窗口中输入my_时，它们就会显示在下拉列表中。
沙龙·马克斯（IDG）
定制和内置RStudio代码段的下拉列表。
我将条形图片段称为my_custom_barchart。 我将键入它，选择它，然后弹出的是我所有的图形代码。
沙龙·马克斯（IDG）
由我的代码段生成的图形代码。
不仅是代码。 此代码段中包含变量 。 我的光标自动跳到第一个变量，我称为mydf 。 我可以将其更改为我称为薪水的数据框的名称。 如果按Tab键，则光标会跳至下一个变量，我称为myxcol 。 我将其更改为Year 。 当我再次点击选项卡时，有两个地方使用了myycol变量。 当我在第一个更改为Salary时，第二个也更改。 您可以在上面的嵌入式视频中查看其工作原理。
摘要格式
每个摘录均以一行开头的单词snippet开头，后跟一个空格，然后是摘录的名称。 以下所有代码段都必须使用制表符缩进。 如果您使用空格使代码缩进 ，则该代码段将无效。
否则，您通常会照常编写所需的代码。 每个代码行都以制表符开头后，可以有其他空格。
要添加变量，请以美元符号开头，然后打开花括号，然后是变量的编号，冒号，变量的名称以及${1:myvar}括号，例如${1:myvar} 。 您可以在标题后的代码段的第一行中看到定义了变量mydf ， myxcol和myycol 。 您的光标将根据变量的数量从一个变量跳到另一个变量：这里的1、2和3用于图形变量，加上4和5用于标题和副标题。 如果多次使用变量，请在代码中的多个位置为变量赋予相同的编号和名称。
这是我完整的代码段：
snippet my_custom_barchart
ggplot(${1:mydf}, aes(x=${2:myxcol}, y=${3:myycol})) +
geom_col(color = "black", fill="#0072B2") +
theme_minimal() +
theme(panel.border = element_blank(), panel.grid.major = element_blank(),
panel.grid.minor = element_blank(), axis.line =
element_line(colour = "gray"),
plot.title = element_text(hjust = 0.5),
plot.subtitle = element_text(hjust = 0.5)
) +
scale_y_continuous(label = comma) +
xlab("") +
ylab("") +
geom_text(aes(label=scales::dollar(${3:myycol})), vjust=1.5, colour="white",
position=position_dodge(.9), size=5) +
ggtitle("${4:mytitle}", subtitle =
"${5:mysubtitle}") 代码段位于一个特殊的RStudio文本文件中，您可以通过菜单命令工具>全局选项>代码>编辑代码段进入该文件。
不过，幸运的是，您不必遍历四个菜单层即可访问代码段文件。 usethis软件包具有一个edit_rstudio_snippet()函数，该函数会弹出打开文件进行编辑。
您可以在文件的任何位置添加自定义片段，这些片段位于RStudio随附的片段的顶部，底部或中间。 保存该r.snippet文件，即可完成。
有关片段的更多信息，请观看上面的视频，并查看JJ Allaire 撰写的RStudio的代码片段文章 。 有关更多R技巧，请访问InfoWorld上的“用R做更多” 页面或YouTube上的“用R做更多信息”播放列表 。
翻译自: https://www.infoworld.com/article/3396616/how-to-use-rstudio-code-snippets.html
rstudio 代码注释