Різниця між R MarkDown та R Notebook

Я намагаюся на високому рівні зрозуміти, у чому різниця між R Markdownі R NoteBook. Я знаю, що вони взаємопов'язані, але я хотів би зрозуміти, як вони пов'язані. Моє розуміння таке:

Я знаю, що зошити R - це справді документи R Markdown, але мене не бентежить термінологія.

RStudio новий варіант файлу має R Markdownі те, R NoteBookі, вибравши будь-який з них, відкриває R Markdownфайл, але з незначними відмінностями. Тому просто намагаюся розібратися, чому існують два варіанти і в чому різниця між ними?

Я розумію, що R-ноутбуки нещодавно представлені, і R Markdown був там деякий час. Частина плутанини може бути через те, що я ніколи не використовував R Markdownраніше, ніж було введено R Notebook

Що R NoteBook робить інакше, ніж просто використовувати R MarkDown або які нові можливості пропонує R NoteBook?

Усі мої звернення до пошуку в Інтернеті вказують на те, що R Notebook використовує R Markdown, але я не знайшов жодної допомоги щодо того, що конкретно відрізняється між ними.

Наскільки я розумію, і від моєї настройки немає різниці в кодуванні. Різниця полягає у візуалізації. Розширення файлу те саме.

Коли ви робите новий ноутбук R, він додає html_notebookопцію виводу у заголовок. Ось і різниця. Потім ви зможете переглянути попередньо візуалізацію швидко, не в'язавши її. Він також оновлює попередній перегляд кожного разу, коли ви зберігаєте. Однак у цьому попередньому попередньому перегляді у вас немає виводу коду (ні цифри, ні таблиці ..) (принаймні в моїй установці). Без html_notebookвиводу немає попереднього перегляду кнопок

як ви бачите, відображаються параметри попереднього перегляду, але ви також можете в'язати їх у будь-якому форматі. Він додасть його до коду заголовка, коли ви це зробите.

Однак якщо у вас html_notebookв заголовку цього немає, ви можете в'язати свій код лише, щоб побачити, як він виглядає (вся книга) (будь ласка, ігноруйте додатковий параметр за замовчуванням, який я вкладаю разом із зображенням)

а параметр попереднього перегляду не відображається у спадному меню

Інакше це працює так само. Для деяких конфігурацій за замовчуванням вихід також приховано за замовчуванням у розділі коду.

Зауважте, що ви можете змішати кілька варіантів виводу у своєму заголовку, щоб ви могли зберегти попередній перегляд та зберегти в'язані варіанти експорту.

Нещодавно я знайшов цю публікацію, яка зрозуміла мені про проблему R Markdown vs. R Notebook. http://uc-r.github.io/r_notebook

Ось кілька відповідних рядків:

Написання документа R Notebook не відрізняється від написання документа R Markdown. Синтаксис тексту та коду не відрізняється від того, що ви дізналися у підручнику R Markdown. Основна різниця полягає в інтерактивності зошита R. Перш за все, при виконанні фрагментів у документі R Markdown весь код надсилається одразу на консоль , а в R Notebook одночасно надсилається лише один рядок . Це дозволяє зупинити виконання, якщо рядок викликає помилку.

Також це є на в'язаному та попередньому перегляді, коли ви створюєте ноутбук R в RStudio:

Попередній перегляд показує вам відтворену HTML-копію вмісту редактора. Отже, на відміну від Knit , Preview не запускає жодних фрагментів коду R. Натомість відображається вихід фрагмента, коли він востаннє виконувався в редакторі.

Сподіваюся, вам здається корисним.

Одне з найважливіших відмінностей не є повністю зрозумілим із наведених відповідей.

З Розділу 3.2.1.3 Книги обліку :

Також Restart R and Run All Chunksу Runменю на панелі інструментів редактора є пункт , який дає вам свіжий R сеанс до запуску всіх фрагментів. Це схоже на Knitкнопку, яка запускає окремий R-сеанс для складання документа.

Іншими словами, в'язання створює нове середовище і запускає весь код там. На відміну від цього, ноутбук R використовує глобальне середовище, як і для надання HTML-файлу. Насправді, для ноутбука R зміни у файлі HTML відбуваються кожного разу, коли .Rmdдокумент зберігається. PreviewКнопка просто відкриває файл HTML в його поточному стані. Код не виконується. Previewбуквально означає, що сказано: це просто показує вам, що вже зроблено.

Чому це має значення? Наприклад, якщо .Rmdфайл R Notebook відкритий, але не запускаються фрагменти коду, HTML-файл приведе всі розмітки та код введення добре, але вихід не з’явиться. Або, припустимо, ви визначаєте якусь змінну xв консолі, але не в куті коду. Якщо ви спробуєте використати xдесь у ноутбуці R, це буде добре. Попередній перегляд HTML-документа також спрацює чудово. З іншого боку, в'язання документа призведе до помилки "невідомої змінної", оскільки в'язання запускає весь код у новому середовищі, а змінна xніколи не була визначена у файлі розмітки.

Різниця полягає в тому, що в R Notebok ви можете написати Markdown та R-code Chunks та безпосередньо виконати їх та побачити результати відразу. Це свого роду Зошит для себе.

R Markdown є для створення приємних виходів у форматі html, pdf або word Document. Поєднання Markdown та R-Code-Chunks. Короткий вступ та мотивацію можна знайти тут .

Якщо ви хочете отримати більше інформації про в'язальний пакет, натисніть тут.

Ось одну практичну відмінність я знайшов:

Коли вам потрібно закомментировать частина тексту, RMarkdown вставки #в кожному рядку тексту, в той час як RNotebook акуратно инкапсулирует текст між однією парою <!--, --->знаків (як в HTML - файли)

Можна сказати, яка банальна різниця. Однак, саме тому, я завжди використовую R Notebook (замість RMarkdown) в RStudio для всіх своїх документів. У всьому іншому вони здаються однаковими (як мінімум, для моїх потреб, таких як генерація html та pdf)

Інакше мої коментарі раптом стають заголовками, як нижче:

# This part is commented out, but will show as Heading 1 font text

http://rmarkdown.rstudio.com/r_notebooks.html#notebook_file

"Звичайні документи R Markdown" в'язані ", але зошити переглядаються.

Схожі зображення: Зошит R та документ R Markdown дуже схожі. Формат розмітки працює в обох типах файлів. Обидва формати файлів можна використовувати для передачі коду разом з результатами та коментарями до інших. Можна в'язати створений документ у вихідних форматах HTML, PDF та WORD. Якщо в коді є помилка, вихід не буде генерований. Щоб запустити файл: CTRL + SHIFT + K та вставити фрагмент коду: CTRL + ALT + I.

Документ розмітки R: Документ Rmd може бути налаштований за допомогою майстра і має параметри для відтворюваного документа, слайдів презентації, блискучих додатків тощо та можливість створення документа з шаблону. Якщо ви змінюєте код, вихід виводиться на вихід Rmd. Він не пропонує можливості попереднього перегляду документа. Заголовок YAML має вихідний формат у вигляді: output: html_document

Документ R Notebook: Документ R nb запускається безпосередньо, і не з'являється майстра (як у випадку .RMD). Поряд з файлом ноутбука генерується додатковий HTML-файл із розширенням * .nb.html. Ноутбук має можливість попереднього перегляду. Якщо якийсь код змінено або відредаговано, новий вихід не відображається. Вихід відображається в самому редакторі коду. Яким би не був старий вихід, він лише надається. Від зміни коду не утворюється новий вихід. Для того, щоб показати вихідний код, нам потрібно виконати фрагмент, і тоді він з’явиться у висновку. Заголовок YAML має вихід у вигляді: вихід: html_notebook

Заголовок YAML : Якщо ми змінимо заголовок YAML з одного файлу в інший, він змінить тип документа. Наприклад, у вас є ноутбук R, який має заголовок YAML як html_notebook. Якщо ви зміните заголовок YAML, ваш ноутбук R буде перетворений на документ R Markdown.

Якщо вам доведеться вибрати один, перейдіть із документом RMarkdown, оскільки він пропонує більше контролю та оновлення документів, як тільки ви його в'яжете.

Від jrnold :

R файли ноутбуків показують вихід всередині редактора, при цьому приховуючи консоль. R-файли розмітки показують вихід у консолі, а не відображаються в редакторі. Вони відрізняються за значенням виходу у заголовках YAML.
Заголовок YAML для ноутбука R матиме рядок,

---
ouptut: html_notebook
---

Заголовок YAML для файлу розмітки R матиме рядок,

ouptut: html_document

Копіюючи заголовок YAML з ноутбука R у файл розмітки R, він змінює його на файл розмітки R і навпаки. Більш конкретно, зміна значення outputна Це пояснюється тим, що RStudio IDE при відкритті та пакет rmarkdown при в'язанні використовує заголовок YAML файлу, і зокрема значення outputключа в заголовку YAML, щоб визначити, який тип документа це є.