# Aus Ihren Daten schreiben

Eingabedaten, Skripte, Tabellen und Manuskriptergebnisse verbunden halten.

Ein Ergebnisabsatz ist vertrauenswürdiger, wenn die Berechnung dahinter griffbereit ist. Nutzen Sie ein Forschungsprojekt, um das Analysevorgehen und seine Ausgaben neben dem Manuskript zu halten.

## Das Projekt einrichten

Wählen Sie die Ausgangsstruktur **Reproduzierbare Analyse**. [Verknüpfen Sie den Datenordner](/docs/linked-folders/), damit die Forschungswerkzeuge die ursprünglichen Messwerte lesen können, ohne sie in das Manuskript zu verschieben.

Halten Sie fest, was die Spalten bedeuten, welche Einheiten sie haben und welche Ausschlüsse es gibt, bevor Sie eine Analyse anfordern.

## Dem Assistenten eine begrenzte Aufgabe geben

Nutzen Sie `/oleafly-data-analysis` oder eine [Forschungsaufgabe](/docs/research-tasks/) des Typs **Analyse**:

> Lesen Sie die Messwerte im verknüpften Datenordner. Vergleichen Sie die beiden Bedingungen mit der Methode aus analysis-plan.md. Speichern Sie das Skript, eine Tabelle mit Einheiten und eine Notiz, die Ausschlüsse beschreibt. Lassen Sie die Eingabedaten unverändert.

Analyseskripte brauchen die passende lokale Laufzeitumgebung und Bibliotheken. Lassen Sie den Assistenten diese Anforderungen prüfen und festhalten, wie sich die Arbeit wiederholen lässt.

## Die Ausgaben prüfen

Lesen Sie das Skript und stellen Sie sicher, dass die gewählten Daten und die Methode zur Frage passen. Prüfen Sie Einheiten, Stichprobenumfänge, fehlende Werte und Unsicherheiten, bevor Sie ein Ergebnis akzeptieren.

Behalten Sie Tabellen und Abbildungen zusammen mit ihren Erzeugungsskripten. Der [Skill Figure prep](/docs/skills/) kann helfen, ein geprüftes Ergebnis in eine Abbildung für das Manuskript zu verwandeln.

Mit einem [CLI-Agenten](/docs/cli-agents/#research-starting-points) fragt der Startpunkt **Reproduzierbarkeitsprüfung** ab, was jedes Ergebnis zur Reproduktion noch braucht: Code, Daten, Softwareversionen, Zufallsstartwerte und Build-Anweisungen. Die **Abbildungsprüfung** kontrolliert Beschriftungen, Labels, Achseneinheiten und Lesbarkeit. Beide bitten den Agenten, einen Bericht in `research/` zu schreiben und das Manuskript in Ruhe zu lassen.

## Den Code im Dokument ausführen

Damit die Zahlen im PDF direkt aus dem Code kommen, schreiben Sie den Bericht in [Quarto oder Calepin](/docs/engines/#quarto). Quarto führt R-, Python- oder Julia-Chunks in einer Datei `.qmd` oder `.Rmd` aus, und Calepin führt Chunks in einem Typst-Dokument aus.

- Code bleibt in jedem Projekt aus, bis Sie **Code in diesem Projekt erlauben** wählen. Bei ausgeschaltetem Code zeigt Quarto den Code jedes Chunks ohne seine Ausgabe, und Calepin zeigt die Ergebnisse, die es beim letzten Lauf des Codes gespeichert hat. Filter, Shortcodes, ein Ordner `_extensions`, Render-Skripte und Inline-R-Code führen auch dann Code aus, ein Projekt, das eines davon nutzt, kompiliert also erst, wenn Sie Code erlauben.
- Bei ausgeschaltetem Code und ohne R auf dem Rechner bekommt eine `.qmd`-Datei mit YAML-Kopf trotzdem eine Vorschau, es sei denn, ihr YAML-Kopf hat den Schlüssel `knitr:`. Jedes andere Dokument mit R-Code, auch `.Rmd`-Dateien, braucht R selbst bei ausgeschaltetem Code. Installieren Sie R von [cloud.r-project.org](https://cloud.r-project.org/) und kompilieren Sie dann erneut.
- Oleafly braucht Quarto 1.5 oder neuer. Ist Ihres älter, nutzt Oleafly seine eigene Kopie oder bittet Sie, unter **Einstellungen → Engines → Quarto** eine herunterzuladen. Ohne heruntergeladene Kopie wird ein Dokument in einem Projekt mit `_quarto.yml` stattdessen mit Ihrem älteren Quarto gebaut.
- Python-Code läuft in der eigenen Umgebung des Projekts, wenn das Projekt einen Ordner `.venv`, `venv` oder `env` mit installiertem Jupyter hat, und Calepin nutzt einen Ordner `.venv`, wenn das Projekt einen hat. Andernfalls läuft der Code im Python, das unter **Sprachen** in **Einstellungen → Engines → Quarto** aufgeführt ist.
- Ein Dokument mit `pdf` oder `beamer` braucht LaTeX. Ist kein TeX installiert, installieren Sie TinyTeX, wenn Oleafly es anbietet, stellen Sie das Dokument auf `format: typst` um, oder fügen Sie `pdf-engine: tectonic` zum YAML-Kopf hinzu, um die eingebaute Engine zu nutzen, sobald Code erlaubt ist.
- Quarto schreibt neben das Dokument eine Arbeitsdatei mit dem Namen des Dokuments: `report.tex` für ein PDF oder `report.typ` für Typst. Trägt eine Datei von Ihnen bereits diesen Namen, stoppt die Kompilierung und nennt sie, statt sie zu ersetzen. Benennen Sie Ihre Datei um oder verschieben Sie sie und kompilieren Sie dann erneut.
- Fehlen koreanische, chinesische oder japanische Zeichen im PDF, nennt die Warnung eine Schrift und gibt zwei Zeilen für den YAML-Kopf an: `CJKmainfont:` mit dieser Schrift und `pdf-engine: tectonic`. Fügen Sie beide hinzu, weil die Schrift mit der eingebauten Engine kommt. `pdf-engine: tectonic` funktioniert erst, wenn Code für das Projekt erlaubt ist.
- Ein Notebook kann bis zu einer Stunde laufen. Danach stoppt Oleafly es, und das Protokoll zeigt die Zelle, die es erreicht hat. Kürzen oder cachen Sie diese Zelle und kompilieren Sie dann erneut.

## Das Ergebnis schreiben

Bitten Sie den Assistenten, einen Ergebnisabsatz nur aus den geprüften Ausgaben zu entwerfen. Gleichen Sie jede Zahl mit der Tabelle ab und halten Sie Methode und Interpretation auseinander.

Kompilieren Sie das Dokument und prüfen Sie die vollständige Tabelle oder Abbildung im PDF, einschließlich Labels und Beschriftung.
