R 语言经典实例（原书第 2 版）

500

｜

第

16

章

16.16 创建参数化报告

16.16.1 问题

需要定期使用不同的输入运行相同的报告。

16.16.2 解决方案

可以使用 YAML 标题中的参数创建 R Markdown 文档，然后将其作为文档正文中的变

量。参数作为命名项存储在名为 params 的列表中，可以在代码块中访问它们：

---

output: html_document

params:

var: 2

---

```{r}

print(params$var)

```

如果以后要更改参数，有三个选项：

•

编辑 R Markdown 文档，然后再次渲染。

•

使用命令 rmarkdown::render 从 R 中渲染文档，将参数作为列表传递：

rmarkdown::render("test_params.Rmd", params = list(var=3))

•

使用 RStudio，选择“ Knitr”

→

“ Knit with Parameters”， RStudio 将在生成文档前

提示输入参数。

16.16.3 讨论

如果需要使用不同设置定期运行文档，则使用 R Markdown 中的参数非常有用。常见用

例是一种每次运行时仅更改日期设置和标签的报告。

以下是一个示例 R Markdown 文档，说明如何将参数传递到文档的文本中：

---

title: "Example of Params"

output: html_document

params:

effective_date: '2018-07-01'

quarter_num: 2 ...