Перейти к содержимому
Oleaflyv0.4.12

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

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

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

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

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

Используйте /oleafly-data-analysis или исследовательскую задачу Анализ из раздела о исследовательских задачах:

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

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

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

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

С CLI-агентом стартовая точка Проверка воспроизводимости выясняет, чего каждому результату ещё не хватает для воспроизведения: код, данные, версии программ, начальные значения генераторов случайных чисел и инструкции сборки. Проверка рисунков проверяет подписи, метки, единицы измерения на осях и читаемость. Обе просят агента написать отчёт в research/ и не трогать рукопись.

Чтобы числа в PDF брались прямо из кода, пишите отчёт в Quarto или Calepin. 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 (откроется в новой вкладке) и скомпилируйте снова.
  • 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, включая метки и подпись.

Просмотр изображения

Не удалось загрузить ответы ИИ

Попробуйте снова или воспользуйтесь поиском по документации.