web-dev-qa-db-ja.com

R MarkDownとR NoteBookの違い

R MarkdownR NoteBookの違いを高レベルで理解しようとしています。それらが相互に関連していることは知っていますが、それらがどのように関連しているかを知りたいと思います。私の理解はこれです:

私はRノートブックが本当にRマークダウン文書であることを知っていますが、用語について混乱しています。

RStudioの新しいファイルオプションにはR MarkdownR NoteBookの両方があり、どちらかを選択するとR Markdownファイルが開きますが、わずかな違いがあります。 では、なぜ2つのオプションがあるのか​​、2つのオプションの違いは何なのかを理解しようとしていますか?

enter image description here

Rノートブックが新しく導入され、R Markdownがしばらく存在していることを理解しています。混乱の一部は、R Notebookが導入される前にR Markdownを使用したことがないため、関連する質問またはより具体的な質問が

R NoteDownは、R MarkDownを使用するだけでなく、R NoteBookはどのような新機能を提供しますか?

ウェブ検索での私のヒットはすべて、R NotebookがR Markdownを使用していることを示していますが、両者の具体的な違いに関するヘルプは見つかりませんでした。

85
PagMax

私が理解している限り、そして私のセットアップからはコーディングの違いはありません。違いはレンダリングにあります。ファイル拡張子は同じです。

新しいRノートブックを作成すると、ヘッダーの出力オプションにhtml_notebookが追加されます。それが違いです。その後、レンダリングせずにレンダリングをすばやくプレビューできます。また、保存するたびにプレビューが更新されます。ただし、そのプレビューでは、コードの出力はありません(数字もテーブルもありません)(少なくとも私の設定では)。出力にhtml_notebookがない場合、ボタンのプレビューはありません

enter image description here

プレビューオプションが表示されますが、必要に応じて任意の形式で編成することもできます。これを行うと、ヘッダーコードに追加されます。

enter image description here

ただし、そのhtml_notebookがヘッダーにない場合は、コードを編んでその外観(本全体)を確認することしかできません(図で追加したデフォルトオプションは無視してください)

enter image description here

プレビューするオプションはドロップダウンメニューに表示されません

enter image description here

それ以外は同じように機能します。一部のデフォルト構成では、出力はコードセクションでデフォルトで非表示になっています。

プレビューを保持し、エクスポート用のニットオプションを保持できるように、ヘッダーに複数の出力オプションを混在させることができます。

30
R. Prost

最近、この記事を見つけて、R Markdown vs. R Notebookの問題を明らかにしました。 http://uc-r.github.io/r_notebook

関連する行は次のとおりです。

R Notebookドキュメントを書くことは、R Markdownドキュメントを書くことと変わりません。テキストとコードチャンクの構文は、R Markdownチュートリアルで学んだものと変わりません。主な違いは、Rノートブックのインタラクティブ性です。主に、R Markdownドキュメントでチャンクを実行する場合、すべてのコードはすぐにコンソールに送信されますが、Rノートブックでは、一度に1行のみが送信されます。これにより、行でエラーが発生した場合に実行を停止できます。

また、RStudioでRノートブックを作成するときに、ニットとプレビューでこれがあります。

プレビューには、エディターのコンテンツのレンダリングされたHTMLコピーが表示されます。したがって、Knitとは異なり、PreviewはRコードチャンクを実行しません。代わりに、エディターで最後に実行されたときのチャンクの出力が表示されます。

お役に立てば幸いです。

22
Mani Tajaddini

違いは、R NotebokではMarkdownとR-code Chunksを記述して直接実行し、結果をすぐに見ることができることです。それはあなたにとって一種のノートブックです。

R Markdownは、html、pdf、またはWord文書で見栄えの良い出力を作成するためにあります。 MarkdownとR-Code-Chunksの組み合わせ。 短い紹介と動機はここにあります

knitrパッケージの詳細については、ここをクリックしてください。

5
Swolf

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

「通常のR Markdownドキュメントは「ニット」ですが、ノートブックは「プレビュー」されます。ノートブックプレビューはレンダリングされたR Markdownドキュメントに似ていますが、ノートブックプレビューはRコードチャンクを実行しません。

3
Sibo Jiang

最も重要な違いの1つは、上記の回答から完全には明らかではありません。

Bookdown book のセクション3.2.1.3から:

また、エディターツールバーのRunメニューにはRestart R and Run All Chunks項目があり、すべてのチャンクを実行する前に新しいRセッションを提供します。これは、Knitボタンに似ています。このボタンは、ドキュメントをコンパイルするために別のRセッションを起動します。

つまり、編み物は新しい環境を作成し、そこですべてのコードを実行します。対照的に、RノートブックはHTMLファイルをレンダリングするためにグローバル環境をそのまま使用します。実際、Rノートブックでは、.Rmdドキュメントが保存されるたびにHTMLファイルへの変更が発生します。 Previewボタンは、現在の状態でHTMLファイルを開くだけです。コードは実行されません。 Previewは文字通りそれが言うことを意味します:既に行われたことを示しています。

なぜこれが重要なのですか?たとえば、R Notebook .Rmdファイルが開かれ、コードチャンクが実行されない場合、HTMLファイルはすべてのマークダウンと入力コードを正常にレンダリングしますが、出力は表示されません。または、コンソールで変数xを定義しますが、コードチャンクでは定義しないとします。 R Notebookのどこかでxを使用しようとすると、問題なく動作します。 HTMLドキュメントのプレビューも正常に機能します。一方、ドキュメントを編み上げると「不明な変数」エラーが生成されます。編み物はすべてのコードを新しい環境で実行し、変数xはマークダウンファイルでどこにも定義されなかったためです。

3
Sean Raleigh

ここに私が見つけた1つの実用的な違いがあります:

テキストの一部をコメントアウトする必要がある場合、RMarkdownはテキストのすべての行に#を挿入しますが、RNotebookは単一の組の<!----->記号の間にテキストをきちんとカプセル化します(htmlファイルのように)

なんと些細な違いかと言えます。ただし、そのためだけに、RStudioではすべてのドキュメントに対して常にRノートブック(RMarkdownではなく)を使用します。他のすべてでは、それらは同じように見えます(少なくとも私のニーズでは、htmlやpdfの生成など)

それ以外の場合、私のコメントは突然次のようなヘッダーになります。

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

Similarites: RノートブックとR Markdownドキュメントはほとんど同じです。マークダウン形式は両方のファイルタイプで機能します。両方のファイル形式を使用して、コードを結果や他の人へのコメントとともに伝えることができます。作成したドキュメントをHTML、PDF、およびWord出力形式に編成することを選択できます。コードにエラーがある場合、出力は生成されません。ファイルを実行するには:CTRL + SHIFT + Kおよびコードチャンクを挿入するには:CTRL + ALT + I。

R Markdown document: Rmdドキュメントはウィザードで設定でき、再現性のあるドキュメント、プレゼンテーションスライド、光沢のあるアプリなどのオプションと、テンプレートからドキュメントを作成するオプションがあります。コードを変更すると、出力はRmd出力で実行されます。ドキュメントをプレビューするオプションは提供しません。 YAMLヘッダーの出力形式は次のとおりです。output:html_document

R Notebook Document: R nbドキュメントは直接起動され、ウィザード(.RMDの場合のように)は表示されません。ノートブックファイルとともに、拡張子* .nb.htmlが追加のhtmlファイルとして生成されます。ノートブックにはプレビューのオプションがあります。コードが変更または編集された場合、新しい出力は表示されません。出力は、コードエディター自体に表示されます。古い出力が何であれ、レンダリングされるだけです。コード変更から新しい出力は生成されません。コードの出力を表示するには、チャンクを実行する必要があり、それが出力に表示されます。 YAMLヘッダーの出力は次のとおりです。output:html_notebook

YAMLヘッダー:YAMLヘッダーをあるファイルから別のファイルに変更すると、ドキュメントのタイプが変更されます。たとえば、html_notebookとしてYAMLヘッダーを持つRノートブックがあります。 YAMLヘッダーを変更すると、RノートブックはR Markdownドキュメントに変換されます。

いずれかを選択する必要がある場合は、RMarkdown documentを使用します。これにより、よりすぐれた制御が提供され、すぐにドキュメントが更新されます。

2
Saurabh Jain

jrnold から:

Rノートブックファイルは、コンソールを非表示にしている間、エディター内で出力を表示します。 Rマークダウンファイルは、コンソール内の出力を表示しますが、エディター内の出力は表示しません。これらは、YAMLヘッダーの出力値が異なります。
RノートブックのYAMLヘッダーには次の行があります。

---
ouptut: html_notebook
---

RマークダウンファイルのYAMLヘッダーには次の行があります。

ouptut: html_document

RノートブックからRマークダウンファイルにYAMLヘッダーをコピーすると、Rマークダウンファイルに変更され、逆も同様です。より具体的には、outputの値をこれに変更すると、RStudioが開くときにIDEになり、編み物がYAMLを使用するときにrmarkdownパッケージになりますファイルのヘッダー、特にYAMLヘッダーのoutputキーの値は、それがどのタイプのドキュメントであるかを決定します。

1
Yang Dai