Seminar R – Reproduzierbare Berichte mit Quarto

Seminarbeschreibung

Wiederkehrende Berichte werden zuverlässiger, wenn Berechnungen und Darstellung aus derselben Datenbasis entstehen. Das Seminar verbindet R-Auswertungen mit Quarto-Dokumenten und zeigt einen systematischen Weg zu aktualisierbaren Berichten. Kennzahlen, Tabellen und Abbildungen werden aus dem Code erzeugt und in einen verständlichen fachlichen Text eingebettet.

Neben der Gestaltung werden die Bedingungen einer reproduzierbaren Ausführung geprüft. Ein Bericht darf nicht zufällig von Objekten aus einer zuvor geöffneten RStudio-Sitzung abhängen. Parameter, Ausgabeverzeichnisse und Paketstände werden daher explizit festgelegt. Die bereitgestellte Seminarumgebung enthält die für PDF-Ausgaben benötigte Werkzeugkette; diese wird im Seminar eingeordnet.

Zielgruppe

R-Anwender aus Berichtswesen, Controlling, Forschung und Dokumentation, die regelmäßige Auswertungen als Dokument bereitstellen möchten.

Voraussetzungen

R-Grundkenntnisse, Datenimport, einfache Datenaufbereitung und erste ggplot2-Grafiken. Analyseskripte sollen gelesen und angepasst werden können. HTML- oder LaTeX-Kenntnisse werden nicht vorausgesetzt.

Lernziele

• Quarto-Dokumente mit Text, R-Code und automatisch berechneten Ergebnissen aufbauen.
• Tabellen und Grafiken mit Beschriftungen und internen Querverweisen einsetzen.
• Berichte parametrisieren und für mehrere Empfängergruppen oder Zeiträume erzeugen.
• Ausführung, Cache und Projektabhängigkeiten nachvollziehbar kontrollieren.

Inhaltsübersicht

1. Dokumentstruktur und Ausführung
2. Text, Tabellen und Grafiken
3. Ausgabeformate und Gestaltung
4. Parameter und Varianten
5. Reproduzierbarkeit und Zwischenergebnisse
6. Automatisierter Berichtslauf

Seminarinhalte

Dokumentstruktur und Ausführung

Text und Berechnung werden in einer gemeinsamen Struktur organisiert.

• QMD-Dateien, YAML-Einstellungen und ausführbare R-Codeblöcke kennenlernen.
• Mit knitr ausgeführten Code und angezeigte Ergebnisse unterscheiden.
• Ein Dokument aus einer frischen Sitzung rendern und Abhängigkeiten sichtbar machen.

Text, Tabellen und Grafiken

Fachliche Aussagen werden direkt mit berechneten Ergebnissen verbunden.

• Kennzahlen als Inline-Code in Fließtext einfügen.
• Tabellen und ggplot2-Abbildungen mit konsistenten Beschriftungen ausgeben.
• Abschnitte, interne Querverweise und ein Dokumentinhaltsverzeichnis verwenden.

Ausgabeformate und Gestaltung

Die Gestaltung berücksichtigt die Anforderungen des Ausgabeformats.

• HTML, Word und PDF mit ihren jeweiligen Möglichkeiten vergleichen.
• Vorlagen und grundlegende Formatoptionen konsistent einsetzen.
• Seitenumbrüche, Abbildungsgrößen und breite Tabellen prüfen.

Parameter und Varianten

Ein Bericht wird für mehrere fachliche Ausschnitte wiederverwendbar.

• Zeitraum und Organisationseinheit als Parameter definieren.
• Parameter prüfen und eindeutige Dateinamen sowie Ausgabeverzeichnisse erzeugen.
• Mehrere Berichtsvarianten kontrolliert rendern und auf korrekte Zuordnung prüfen.

Reproduzierbarkeit und Zwischenergebnisse

Beschleunigung darf nicht unbemerkt veraltete Ergebnisse erzeugen.

• Projektpfade, Zufallsstarts und Paketstände mit renv dokumentieren.
• Cache und Freeze unterscheiden; Änderungen an Daten als Aktualisierungsauslöser berücksichtigen.
• Eine vollständige Neuberechnung durchführen und mit vorhandenen Ausgaben vergleichen.

Automatisierter Berichtslauf

Der Bericht wird außerhalb der interaktiven Oberfläche erzeugt.

• Render-Aufrufe über die Kommandozeile starten.
• Fehlerausgaben, fehlende Dateien und nicht erfüllte Voraussetzungen untersuchen.
• Einen kleinen Berichtslauf mit mehreren Parametern nachvollziehbar dokumentieren.

Praxisprojekt

1. Eine vorhandene R-Auswertung in ein Quarto-Projekt übernehmen.
2. Kennzahlen, Tabelle und Diagramm mit erklärendem Text verbinden.
3. Einen Zeitraumparameter einführen und zwei Varianten erzeugen.
4. HTML- und Word-Ausgabe prüfen; eine PDF-Ausgabe mit der bereitgestellten Umgebung rendern.
5. Daten ändern, den Cache kontrolliert erneuern und den Bericht vollständig neu erzeugen.