仪表板参数

概述

您可能有一组参数，用于创建dashboard的不同变体。例如：

• 显示特定地理位置的结果。
• 运行覆盖特定时间段的报告。
• 针对不同假设多次运行单个分析。

本文介绍了如何使用Quarto定义和使用计算参数。

定义

向dashboard添加参数定义的方式取决于您使用的是Jupyter还是Knitr引擎。

Jupyter

对于Jupyter，Quarto使用与Papermill相同的语法来定义参数。要参数化一个dashboard，请使用parameters标签指定一个单元格，并提供适当的默认值：

```{python}
#| tags: [parameters]

alpha = 0.1
ratio = 0.1
```

参数在顶层环境中可用：

```{python}
alpha
```

当使用一组新参数执行dashboard时，会注入一个单元格，该单元格会根据需要覆盖这些默认值。

Knitr

对于Knitr，使用标准的Knitr params YAML选项来定义参数。例如：

---
params:
  alpha: 0.1
  ratio: 0.1
---

参数在params列表中可用：

```{r}
params$alpha
```

渲染

要使用不同的参数进行渲染，您可以使用-P标志在命令行中传递它们（这适用于.ipynb或.qmd文件）：

Terminal

quarto render dashboard.ipynb -P alpha:0.2 -P ratio:0.3

或者，您可以创建一个定义要渲染的参数值的YAML文件，然后使用--execute-params标志调用quarto render：

Terminal

quarto render dashboard.qmd --execute-params params.yml