Bisher haben wir unseren Report nur für Adelie-Pinguine erstellt. Aber was, wenn wir denselben Report für alle drei Pinguinarten möchten? Statt drei separate Dokumente zu pflegen, können wir Parameter verwenden: Ein Template, das beim Rendern mit verschiedenen Werten gefüllt wird.

Das Konzept

Ein parametrisierter Report ist wie ein Formular mit Lücken:

Das Template definiert Parameter mit Standardwerten
Beim Rendern können andere Werte übergeben werden
Der Report passt sich automatisch an

Parameter definieren

Parameter werden im YAML-Header unter params: definiert:

---
title: "Pinguin-Report"
format: docx
params:
  species: "Adelie"
---

Hier ist species der Parametername und "Adelie" der Standardwert.

Parameter im Code verwenden

Im R-Code greift man mit params$parametername auf Parameter zu:

# Daten basierend auf Parameter filtern
selected_penguins <- penguins %>%
  filter(species == params$species) %>%
  drop_na()

Der Fließtext kann ebenfalls Parameter enthalten:

Dieser Report analysiert **Adelie**-Pinguine.

Ein vollständiges Beispiel

Hier ist unser Pinguin-Report als parametrisierte Version:

---
title: "Pinguin-Report"
subtitle: "Adelie-Pinguine"
author: "Forschungsteam"
date: today
format: docx
params:
  species: "Adelie"
execute:
  echo: false
  warning: false
  message: false
---

# Einleitung

Dieser Report analysiert **Adelie**-Pinguine aus dem 
Palmer Penguins Datensatz. Der Datensatz umfasst 146 
Individuen dieser Art.

# Deskriptive Statistik

```{r}
#| label: tbl-params-summary
#| tbl-cap: "Zusammenfassung der Messwerte"
selected_penguins %>%
  summarise(
    N = n(),
    `Schnabellänge (mm)` = round(mean(bill_length_mm), 1),
    `Körpermasse (g)` = round(mean(body_mass_g), 0)
  ) %>%
  flextable() %>%
  autofit()
```

# Visualisierung

```{r}
#| label: fig-params-scatter
#| fig-cap: "Schnabelmaße der ausgewählten Pinguinart"
#| fig-width: 5
#| fig-height: 4
ggplot(selected_penguins, aes(x = bill_length_mm, y = bill_depth_mm)) +
  geom_point(alpha = 0.6) +
  labs(
    x = "Schnabellänge (mm)",
    y = "Schnabeltiefe (mm)",
    title = glue::glue("{params$species}-Pinguine")
  ) +
  theme_minimal()
```

Reports mit verschiedenen Parametern rendern

In RStudio

Klicke auf den Pfeil neben dem Render-Button
Wähle “Render with Parameters…”
Ein Dialog öffnet sich, in dem man die Werte ändern kann

Via Kommandozeile

quarto render report.qmd -P species:Gentoo

Mehrere Parameter:

quarto render report.qmd -P species:Chinstrap -P year:2008

Programmatisch in R

# Einen Report rendern
quarto::quarto_render(
  input = "report.qmd",
  execute_params = list(species = "Gentoo"),
  output_file = "report_gentoo.docx"
)

Alle Varianten auf einmal rendern

Mit einer Schleife kann man alle Versionen automatisch erzeugen:

library(purrr)

# Alle Pinguinarten
species_list <- c("Adelie", "Chinstrap", "Gentoo")

# Für jede Art einen Report rendern
walk(species_list, function(sp) {
  quarto::quarto_render(
    input = "report.qmd",
    execute_params = list(species = sp),
    output_file = glue::glue("report_{tolower(sp)}.docx")
  )
})

Das erzeugt drei Dateien: report_adelie.docx, report_chinstrap.docx, report_gentoo.docx.

Mehrere Parameter

Man kann beliebig viele Parameter definieren:

params:
  species: "Adelie"
  island: "Biscoe"
  min_year: 2007
  include_plots: true

Und im Code:

filtered_data <- penguins %>%
  filter(
    species == params$species,
    island == params$island,
    year >= params$min_year
  )

# Bedingte Ausführung
if (params$include_plots) {
  # Plot-Code hier
}

Parametertypen

Parameter können verschiedene Typen haben:

params:
  species: "Adelie"           # Text
  sample_size: 100            # Zahl
  include_plots: true         # Boolean
  islands:                    # Liste
    - Biscoe
    - Dream

Dynamische Titel

Der Titel kann Parameter enthalten:

---
title: "Adelie\-Pinguin\-Analyse"
params:
  species: "Adelie"
---

Oder einfacher im Subtitle:

---
title: "Pinguin-Analyse"
subtitle: "Adelie"
params:
  species: "Adelie"
---

Praktische Anwendungsfälle

Anwendung	Parameter
Reports pro Region	`region`, `year`
Kundenberichte	`client_name`, `client_id`
Testversionen	`include_draft_watermark: true`
Sprachversionen	`language: "de"`
Datenquellen	`data_file: "data_2024.csv"`

Tipps

Standardwerte sinnvoll setzen

Der Standardwert sollte ein typischer, funktionierender Wert sein — so kann man das Template einfach testen.

Parameterwerte validieren

Am Anfang des Dokuments prüfen, ob die Parameter gültig sind:

# Prüfen ob Spezies existiert
valid_species <- c("Adelie", "Chinstrap", "Gentoo")

if (!params$species %in% valid_species) {
  stop(glue::glue(
    "Ungültige Spezies: {params$species}. ",
    "Erlaubt sind: {paste(valid_species, collapse = ', ')}"
  ))
}

Ausgabedateinamen

Bei der Massenproduktion sinnvolle Dateinamen verwenden:

output_file = glue::glue(
  "report_{params$species}_{Sys.Date()}.docx"
)

Übung: Parametrisierten Report erstellen

Nimm den bisherigen Pinguin-Report
Füge einen species-Parameter mit Standardwert “Adelie” hinzu
Ersetze alle Stellen, die auf Adelie verweisen, durch params$species
Rendere den Report mit verschiedenen Spezies (Adelie, Chinstrap, Gentoo)
Bonus: Schreibe eine Schleife, die alle drei Reports automatisch erzeugt

Weiterführende Ressourcen

Quarto Parameters — Offizielle Dokumentation
Parameterized Reporting with Quarto — Rendering-Optionen

Was kommt als Nächstes

Im letzten Kapitel werfen wir einen Blick über den Word-Tellerrand: PDF-Export mit Typst, Präsentationen mit Reveal.js, und HTML-Dokumente — alles mit demselben Quarto-Wissen.

Zitat

Mit BibTeX zitieren:

@online{schmidt2026,
  author = {{Dr. Paul Schmidt}},
  publisher = {BioMath GmbH},
  title = {10. Parametrisierte Reports},
  date = {2026-02-07},
  url = {https://biomathcontent.netlify.app/de/content/quarto/10_parameters.html},
  langid = {de}
}

Bitte zitieren Sie diese Arbeit als:

Dr. Paul Schmidt. 2026. “10. Parametrisierte Reports.” BioMath GmbH. February 7, 2026. https://biomathcontent.netlify.app/de/content/quarto/10_parameters.html.

--- title: "10. Parametrisierte Reports" subtitle: "Ein Template, viele Varianten" params: species: "Adelie" --- Bisher haben wir unseren Report nur für Adelie-Pinguine erstellt. Aber was, wenn wir denselben Report für alle drei Pinguinarten möchten? Statt drei separate Dokumente zu pflegen, können wir **Parameter** verwenden: Ein Template, das beim Rendern mit verschiedenen Werten gefüllt wird. ```{r} #| label: qrt-params-setup #| include: false library(tidyverse) library(palmerpenguins) library(flextable) ``` # Das Konzept Ein parametrisierter Report ist wie ein Formular mit Lücken: 1. Das Template definiert Parameter mit Standardwerten 2. Beim Rendern können andere Werte übergeben werden 3. Der Report passt sich automatisch an # Parameter definieren Parameter werden im YAML-Header unter `params:` definiert: ```yaml --- title: "Pinguin-Report" format: docx params: species: "Adelie" --- ``` Hier ist `species` der Parametername und `"Adelie"` der Standardwert. # Parameter im Code verwenden Im R-Code greift man mit `params$parametername` auf Parameter zu: ```{r} #| label: qrt-params-filter #| eval: false # Daten basierend auf Parameter filtern selected_penguins <- penguins %>% filter(species == params$species) %>% drop_na() ``` Der Fließtext kann ebenfalls Parameter enthalten: ```markdown Dieser Report analysiert **`{r} params$species`**-Pinguine. ``` # Ein vollständiges Beispiel Hier ist unser Pinguin-Report als parametrisierte Version: ````yaml --- title: "Pinguin-Report" subtitle: "`{r} params$species`-Pinguine" author: "Forschungsteam" date: today format: docx params: species: "Adelie" execute: echo: false warning: false message: false --- ```` ```{r} #| label: qrt-params-example #| include: false # params wird bereits durch den YAML-Header definiert # Wir verwenden es direkt: selected_penguins <- penguins %>% filter(species == params$species) %>% drop_na() ``` ````markdown # Einleitung Dieser Report analysiert **`{r} params$species`**-Pinguine aus dem Palmer Penguins Datensatz. Der Datensatz umfasst `{r} nrow(selected_penguins)` Individuen dieser Art. # Deskriptive Statistik ```{r} #| label: tbl-params-summary #| tbl-cap: "Zusammenfassung der Messwerte" selected_penguins %>% summarise( N = n(), `Schnabellänge (mm)` = round(mean(bill_length_mm), 1), `Körpermasse (g)` = round(mean(body_mass_g), 0) ) %>% flextable() %>% autofit() ``` # Visualisierung ```{r} #| label: fig-params-scatter #| fig-cap: "Schnabelmaße der ausgewählten Pinguinart" #| fig-width: 5 #| fig-height: 4 ggplot(selected_penguins, aes(x = bill_length_mm, y = bill_depth_mm)) + geom_point(alpha = 0.6) + labs( x = "Schnabellänge (mm)", y = "Schnabeltiefe (mm)", title = glue::glue("{params$species}-Pinguine") ) + theme_minimal() ``` ```` # Reports mit verschiedenen Parametern rendern ## In RStudio 1. Klicke auf den Pfeil neben dem Render-Button 2. Wähle "Render with Parameters..." 3. Ein Dialog öffnet sich, in dem man die Werte ändern kann ## Via Kommandozeile ```bash quarto render report.qmd -P species:Gentoo ``` Mehrere Parameter: ```bash quarto render report.qmd -P species:Chinstrap -P year:2008 ``` ## Programmatisch in R ```{r} #| label: qrt-params-render #| eval: false # Einen Report rendern quarto::quarto_render( input = "report.qmd", execute_params = list(species = "Gentoo"), output_file = "report_gentoo.docx" ) ``` # Alle Varianten auf einmal rendern Mit einer Schleife kann man alle Versionen automatisch erzeugen: ```{r} #| label: qrt-params-loop #| eval: false library(purrr) # Alle Pinguinarten species_list <- c("Adelie", "Chinstrap", "Gentoo") # Für jede Art einen Report rendern walk(species_list, function(sp) { quarto::quarto_render( input = "report.qmd", execute_params = list(species = sp), output_file = glue::glue("report_{tolower(sp)}.docx") ) }) ``` Das erzeugt drei Dateien: `report_adelie.docx`, `report_chinstrap.docx`, `report_gentoo.docx`. # Mehrere Parameter Man kann beliebig viele Parameter definieren: ```yaml params: species: "Adelie" island: "Biscoe" min_year: 2007 include_plots: true ``` Und im Code: ```{r} #| label: qrt-params-multiple #| eval: false filtered_data <- penguins %>% filter( species == params$species, island == params$island, year >= params$min_year ) # Bedingte Ausführung if (params$include_plots) { # Plot-Code hier } ``` # Parametertypen Parameter können verschiedene Typen haben: ```yaml params: species: "Adelie" # Text sample_size: 100 # Zahl include_plots: true # Boolean islands: # Liste - Biscoe - Dream ``` # Dynamische Titel Der Titel kann Parameter enthalten: ```yaml --- title: "`{r} glue::glue('{params$species}-Pinguin-Analyse')`" params: species: "Adelie" --- ``` Oder einfacher im Subtitle: ```yaml --- title: "Pinguin-Analyse" subtitle: "`{r} params$species`" params: species: "Adelie" --- ``` # Praktische Anwendungsfälle | Anwendung | Parameter | |-----------|-----------| | Reports pro Region | `region`, `year` | | Kundenberichte | `client_name`, `client_id` | | Testversionen | `include_draft_watermark: true` | | Sprachversionen | `language: "de"` | | Datenquellen | `data_file: "data_2024.csv"` | # Tipps ## Standardwerte sinnvoll setzen Der Standardwert sollte ein typischer, funktionierender Wert sein — so kann man das Template einfach testen. ## Parameterwerte validieren Am Anfang des Dokuments prüfen, ob die Parameter gültig sind: ```{r} #| label: qrt-params-validate #| eval: false # Prüfen ob Spezies existiert valid_species <- c("Adelie", "Chinstrap", "Gentoo") if (!params$species %in% valid_species) { stop(glue::glue( "Ungültige Spezies: {params$species}. ", "Erlaubt sind: {paste(valid_species, collapse = ', ')}" )) } ``` ## Ausgabedateinamen Bei der Massenproduktion sinnvolle Dateinamen verwenden: ```{r} #| label: qrt-params-filename #| eval: false output_file = glue::glue( "report_{params$species}_{Sys.Date()}.docx" ) ``` :::{.callout-tip collapse="false"} ## Übung: Parametrisierten Report erstellen 1. Nimm den bisherigen Pinguin-Report 2. Füge einen `species`-Parameter mit Standardwert "Adelie" hinzu 3. Ersetze alle Stellen, die auf Adelie verweisen, durch `params$species` 4. Rendere den Report mit verschiedenen Spezies (Adelie, Chinstrap, Gentoo) 5. Bonus: Schreibe eine Schleife, die alle drei Reports automatisch erzeugt ::: # Weiterführende Ressourcen - [Quarto Parameters](https://quarto.org/docs/computations/parameters.html) — Offizielle Dokumentation - [Parameterized Reporting with Quarto](https://quarto.org/docs/computations/parameters.html#rendering-with-parameters) — Rendering-Optionen # Was kommt als Nächstes Im letzten Kapitel werfen wir einen Blick über den Word-Tellerrand: PDF-Export mit Typst, Präsentationen mit Reveal.js, und HTML-Dokumente — alles mit demselben Quarto-Wissen.