参数

R Markdown 文档可以包含一个或多个参数，其值可以在渲染报告时设置。当你想用不同的关键输入值重新渲染同一份报告时，参数非常有用。例如，你可能需要按分店生成销售报告、按学生生成考试成绩，或按国家生成人口统计摘要。要声明一个或多个参数，请使用 par ams 字段。

这个示例使用一个 my_class 参数来确定要显示哪一类汽车：

-- output: html_document params: my_class: "suv" --- {r setup, include = FALSE} library(ggplot2) library(dplyr) class <- mpg %>% filter(class == params\$my\_class) # Fuel economy for r params\$my\_classs {r, message = FALSE} ggplot(class, aes(displ, hwy)) + geom\_point() + geom\_smooth(se = FALSE)

如你所见，参数在代码块中以名为 params 的只读列表形式提供。

你可以将原子向量直接写入 YAML 头部。你也可以通过在参数值前加上 !r 来运行任意的 R 表达式。这是指定日期/时间参数的好方法：

params: start: !r lubridate::ymd("2015-01-01") snapshot: !r lubridate::ymd_hms("2015-01-01 12:30:00")

在 RStudio 中，你可以点击 Knit 下拉菜单中的 "Knit with Parameters"（带参数编织）选项，在一个用户友好的步骤中设置参数、渲染并预览报告。你可以通过自定义对话框来