# Пишите на основе своих данных

Держите входные данные анализа, скрипты, таблицы и результаты в рукописи связанными.

Абзац с результатами вызывает больше доверия, когда расчёт, стоящий за ним, находится рядом. Используйте исследовательский проект, чтобы держать процедуру анализа и её результаты рядом с рукописью.

## Подготовьте проект

Выберите стартовый шаблон **Воспроизводимый анализ**. [Свяжите папку с данными](/docs/linked-folders/), чтобы исследовательские инструменты могли читать исходные измерения, не перенося их в статью.

Запишите, что означают столбцы, их единицы измерения и любые исключения, прежде чем запрашивать анализ.

## Дайте ассистенту ограниченную задачу

Используйте `/oleafly-data-analysis` или исследовательскую задачу **Анализ** из раздела о [исследовательских задачах](/docs/research-tasks/):

> Прочитай измерения в связанной папке Data. Сравни два условия методом из analysis-plan.md. Сохрани скрипт, таблицу с единицами измерения и заметку с описанием исключений. Не изменяй входные данные.

Скриптам анализа нужны соответствующие локальная среда выполнения и библиотеки. Пусть ассистент проверит эти требования и сохранит способ повторного запуска работы.

## Проверьте результаты

Прочитайте скрипт и убедитесь, что выбранные данные и метод соответствуют вопросу. Проверьте единицы измерения, размеры выборок, пропущенные значения и неопределённость, прежде чем принимать результат.

Храните таблицы и рисунки вместе со скриптами, которые их создают. Навык [figure-prep](/docs/skills/) поможет превратить проверенный результат в рисунок для рукописи.

С [CLI-агентом](/docs/cli-agents/#research-starting-points) стартовая точка **Проверка воспроизводимости** выясняет, чего каждому результату ещё не хватает для воспроизведения: код, данные, версии программ, начальные значения генераторов случайных чисел и инструкции сборки. **Проверка рисунков** проверяет подписи, метки, единицы измерения на осях и читаемость. Обе просят агента написать отчёт в `research/` и не трогать рукопись.

## Запускайте код внутри документа

Чтобы числа в PDF брались прямо из кода, пишите отчёт в [Quarto или Calepin](/docs/engines/#quarto). Quarto запускает блоки R, Python или Julia в файле `.qmd` или `.Rmd`, а Calepin запускает блоки в документе Typst.

- В каждом проекте код остаётся выключенным, пока вы не выберете **Разрешить запуск кода в этом проекте**. При выключенном коде Quarto показывает код каждого блока без его вывода, а Calepin показывает результаты, которые сохранил в прошлый раз, когда код запускался. Фильтры, шорткоды, папка `_extensions`, скрипты рендеринга и встроенный код R запускают код даже тогда, поэтому проект, использующий что-либо из этого, не скомпилируется, пока вы не разрешите код.
- При выключенном коде и без R на компьютере файл `.qmd` с front matter всё равно показывается в предпросмотре, если в его front matter нет ключа `knitr:`. Любой другой документ с кодом R, включая файлы `.Rmd`, требует R, даже когда код выключен. Установите R с [cloud.r-project.org](https://cloud.r-project.org/) и скомпилируйте снова.
- Oleafly нужен Quarto 1.5 или новее. Если ваш старее, Oleafly использует собственную копию или просит скачать её в **Настройки → Движки → Quarto**. Если копия не скачана, документ в проекте `_quarto.yml` собирается вашим старым Quarto.
- Код на Python запускается в собственном окружении проекта, если в проекте есть папка `.venv`, `venv` или `env` с установленным Jupyter, а Calepin использует папку `.venv`, если она есть в проекте. Иначе код запускается в Python, указанном в разделе **Языки** в **Настройки → Движки → Quarto**.
- Документу `pdf` или `beamer` нужен LaTeX. Если TeX не установлен, установите TinyTeX, когда Oleafly это предложит, переключите документ на `format: typst` или добавьте в front matter `pdf-engine: tectonic`, чтобы использовать встроенный движок, как только код разрешён.
- Quarto пишет рабочий файл с именем документа рядом с ним: `report.tex` для PDF или `report.typ` для Typst. Если файл с таким именем у вас уже есть, компиляция останавливается и называет его, а не заменяет. Переименуйте или переместите свой файл и скомпилируйте снова.
- Если в PDF нет корейских, китайских или японских символов, предупреждение называет шрифт и даёт две строки для front matter: `CJKmainfont:` с этим шрифтом и `pdf-engine: tectonic`. Добавьте обе, потому что шрифт поставляется со встроенным движком. `pdf-engine: tectonic` работает, только когда код разрешён для проекта.
- Блокнот может работать до часа. После этого Oleafly останавливает его, а журнал показывает ячейку, до которой он дошёл. Сократите или закэшируйте эту ячейку и скомпилируйте снова.

## Напишите результат

Попросите ассистента набросать фрагмент с результатами, используя только проверенные выходные данные. Сверьте каждое число с таблицей и не смешивайте метод с интерпретацией.

Скомпилируйте документ и просмотрите полную таблицу или рисунок в PDF, включая метки и подпись.
