wake-up-neo.com

Unterschied zwischen R MarkDown und R NoteBook

Ich versuche auf hohem Niveau zu verstehen, was die Unterschiede zwischen R Markdown Und R NoteBook Sind. Ich weiß, dass sie zusammenhängen, aber ich möchte herausfinden, wie sie zusammenhängen. Mein Verständnis ist das:

Ich weiß, dass R-Notizbücher wirklich R-Markdown-Dokumente sind, aber ich bin über die Terminologien verwirrt.

Die neue RStudio-Dateioption enthält sowohl R Markdown Als auch R NoteBook. Wenn Sie eine der beiden Optionen auswählen, wird eine R Markdown - Datei mit geringfügigen Unterschieden geöffnet. Versuchen Sie also nur herauszufinden, warum es zwei Möglichkeiten gibt und was der Unterschied zwischen den beiden ist.

enter image description here

Ich verstehe, dass R-Notebooks neu eingeführt wurden und R Markdown schon eine Weile da ist. Ein Teil der Verwirrung könnte darin liegen, dass ich vor Einführung von R Notebook nie R Markdown Verwendet habe, sodass meine verwandte oder spezifischere Frage lautet

Was macht R NoteBook anders als nur die Verwendung von R MarkDown oder welche neuen Funktionen bringt R NoteBook?

Alle meine Treffer bei der Websuche deuten darauf hin, dass R Notebook R Markdown verwendet, aber ich fand keine Hilfe zu den spezifischen Unterschieden zwischen den beiden.

98
PagMax

Soweit ich weiß und von meinem Setup gibt es keinen Codierungsunterschied. Der Unterschied liegt im Rendering. Die Dateierweiterung ist dieselbe.

Wenn Sie ein neues R Notebook erstellen, wird html_notebook in der Ausgabeoption in der Kopfzeile. Das ist der unterschied Sie können das Rendering dann schnell in der Vorschau anzeigen, ohne es stricken zu müssen. Außerdem wird die Vorschau bei jedem Speichern aktualisiert. In dieser Vorschau haben Sie jedoch keine Code-Ausgabe (keine Abbildungen, keine Tabellen ...) (zumindest in meinem Setup). Ohne html_notebook In der Ausgabe gibt es keine Schaltflächenvorschau

enter image description here

wie Sie sehen, werden die Vorschauoptionen angezeigt. Sie können sie jedoch auch in einem beliebigen Format stricken. Wenn Sie dies tun, wird es dem Header-Code hinzugefügt.

enter image description here

Allerdings, wenn Sie das nicht haben html_notebook In Ihrer Kopfzeile können Sie Ihren Code nur stricken, um zu sehen, wie er aussieht (das gesamte Buch) (bitte ignorieren Sie die zusätzliche Standardoption, die ich mit dem Bild eingefügt habe)

enter image description here

und die Option zur Vorschau wird nicht im Dropdown-Menü angezeigt

enter image description here

Ansonsten funktioniert es genauso. Bei einigen Standardkonfigurationen ist die Ausgabe auch im Codeabschnitt standardmäßig ausgeblendet.

Beachten Sie, dass Sie mehrere Ausgabeoptionen in Ihrer Kopfzeile mischen können, damit Sie die Vorschau und Ihre Strickoptionen für den Export beibehalten können.

34
R. Prost

Kürzlich habe ich diesen Beitrag gefunden, der mich auf das Problem R Markdown vs. R Notebook aufmerksam gemacht hat. http://uc-r.github.io/r_notebook

Hier einige relevante Zeilen:

Das Schreiben eines R Notebook-Dokuments unterscheidet sich nicht vom Schreiben eines R Markdown-Dokuments. Die Syntax von Text- und Codebausteinen unterscheidet sich nicht von den Informationen, die Sie im R Markdown-Lernprogramm erhalten haben. Der Hauptunterschied liegt in der Interaktivität eines R-Notebooks. In erster Linie wird beim Ausführen von Chunks in einem R Markdown-Dokument der gesamte Code auf einmal an die Konsole gesendet , in einem R Notebook jedoch Es wird immer nur eine Zeile gesendet . Dadurch kann die Ausführung angehalten werden, wenn eine Zeile einen Fehler auslöst.

Außerdem gibt es dies beim Erstellen eines R-Notebooks in RStudio im Vergleich zur Vorschau:

Die Vorschau zeigt Ihnen eine gerenderte HTML-Kopie des Inhalts des Editors. Folglich werden im Gegensatz zu Knit, Preview keine R-Code-Chunks ausgeführt. Stattdessen wird die Ausgabe des Blocks angezeigt, als er zuletzt im Editor ausgeführt wurde.

Ich hoffe, Sie finden es nützlich.

25
Mani Tajaddini

Der Unterschied besteht darin, dass Sie in R Notebok Markdown- und R-Code-Chunks schreiben und direkt ausführen können, um die Ergebnisse sofort zu sehen. Es ist eine Art Notizbuch für sich.

R Markdown ist dazu da, gut aussehende Ausgaben in HTML, PDF oder einem Word-Dokument zu erstellen. Markdown und R-Code-Chunks kombinieren. Eine kurze Einführung und Motivation finden Sie hier .

Wenn Sie mehr Informationen über das knitr-Paket erhalten möchten, klicken Sie hier.

5
Swolf

Einer der wichtigsten Unterschiede ist aus den obigen Antworten nicht vollständig ersichtlich.

Aus Abschnitt 3.2.1.3 des Bookdown-Buch :

Da ist auch ein Restart R and Run All Chunks Element im Menü Run in der Editor-Symbolleiste, das Ihnen eine neue R-Sitzung bietet, bevor Sie alle Chunks ausführen. Dies ähnelt der Schaltfläche Knit, mit der eine separate R-Sitzung zum Kompilieren des Dokuments gestartet wird.

Mit anderen Worten, das Stricken schafft eine neue Umgebung und führt den gesamten Code dort aus. Im Gegensatz dazu verwendet das R Notebook die globale Umgebung so, wie sie ist, um die HTML-Datei zu rendern. Tatsächlich treten bei einem R Notebook Änderungen an der HTML-Datei jedes Mal auf, wenn .Rmd Dokument wird gespeichert. Die Schaltfläche Preview öffnet lediglich die HTML-Datei in ihrem aktuellen Zustand. Es wird kein Code ausgeführt. Preview bedeutet wörtlich, was es sagt: Es zeigt Ihnen nur, was bereits getan wurde.

Warum ist das wichtig? Zum Beispiel, wenn ein R Notebook .Rmd -Datei wird geöffnet, aber es werden keine Codestücke ausgeführt. Die HTML-Datei rendert dann den gesamten Abschriften- und Eingabecode einwandfrei, es wird jedoch keine Ausgabe angezeigt. Angenommen, Sie definieren eine Variable x in der Konsole, jedoch nicht in einem Codeabschnitt. Wenn Sie versuchen, x irgendwo in einem R-Notebook zu verwenden, funktioniert dies einwandfrei. Die Vorschau des HTML-Dokuments funktioniert ebenfalls einwandfrei. Andererseits führt das Stricken des Dokuments zu einem "unbekannten Variablen" -Fehler, da beim Stricken der gesamte Code in einer neuen Umgebung ausgeführt wird und die Variable x nirgendwo in der Markdown-Datei definiert wurde.

4
Sean Raleigh

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

"Gewöhnliche R-Markdown-Dokumente sind" gestrickt ", Notizbücher jedoch" in der Vorschau ". Während die Notizbuchvorschau einem gerenderten R-Markdown-Dokument ähnelt, werden in der Notizbuchvorschau keine Ihrer R-Code-Abschnitte ausgeführt."

3
Sibo Jiang

Hier ist ein praktischer Unterschied, den ich gefunden habe:

Wenn Sie einen Teil des Textes auskommentieren müssen, fügt RMarkdown in jede Textzeile # Ein, während RNotebook den Text sauber zwischen einem einzelnen Paar von <!-- Und ---> Zeichen einkapselt (wie in HTML-Dateien)

Man kann sagen, was für ein unbedeutender Unterschied. Aus diesem Grund verwende ich jetzt in RStudio immer R Notebook (anstelle von RMarkdown) für alle meine Dokumente. In allem anderen scheinen sie gleich zu sein (zumindest für meine Bedürfnisse, wie das Generieren von HTML- und PDF-Dateien).

Ansonsten werden meine Kommentare plötzlich zu Überschriften wie unten:

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

Similarites: Das R-Notebook und das R-Markdown-Dokument sind sich ziemlich ähnlich. Das Abschriftenformat funktioniert in beiden Dateitypen. Beide Dateiformate können verwendet werden, um Code zusammen mit Ergebnissen und Kommentaren an andere zu übermitteln. Sie können das erstellte Dokument in den Ausgabeformaten HTML, PDF und Word stricken. Wenn im Code ein Fehler auftritt, wird keine Ausgabe generiert. So führen Sie die Datei aus: STRG + UMSCHALT + K und Code-Chunk einfügen: STRG + ALT + I.

R Markdown document: Das Rmd-Dokument kann über einen Assistenten konfiguriert werden und enthält Optionen für Reproduzierbarkeitsdokumente, Präsentationsfolien, glänzende Apps usw. sowie eine Option zum Erstellen eines Dokuments aus einer Vorlage. Wenn Sie den Code ändern, wird die Ausgabe in der Ausgabe Rmd ausgeführt. Es bietet keine Option zur Vorschau des Dokuments. Der YAML-Header hat das Ausgabeformat: output: html_document

R Notebook Document: Das R nb-Dokument wird direkt gestartet und es wird kein Assistent (wie im Fall von .RMD) angezeigt. Zusammen mit der Notizbuchdatei wird eine zusätzliche HTML-Datei mit der Erweiterung * .nb.html generiert. Das Notebook verfügt über die Option zur Vorschau. Wenn Code geändert oder bearbeitet wird, wird die neue Ausgabe nicht angezeigt. Die Ausgabe wird im Code-Editor selbst angezeigt. Was auch immer die alte Ausgabe war, es wird nur gerendert. Durch die Codeänderung wird keine neue Ausgabe generiert. Um die Code-Ausgabe anzuzeigen, müssen wir den Block ausführen, und dann wird er in der Ausgabe angezeigt. Der YAML-Header hat folgende Ausgabe: output: html_notebook

YAML-Header: Wenn wir den YAML-Header von einer Datei in eine andere ändern, ändert sich der Typ des Dokuments. Zum Beispiel haben Sie ein R-Notizbuch mit einem YAML-Header als html_notebook. Wenn Sie den YAML-Header ändern, wird Ihr R-Notizbuch in ein R-Markdown-Dokument konvertiert.

Wenn Sie eines auswählen müssen, wählen Sie RMarkdown document, da es mehr Kontrolle bietet und Dokumente aktualisiert, sobald Sie es stricken.

2
Saurabh Jain

Von jrnold :

R-Notebook-Dateien zeigen die Ausgabe im Editor, während die Konsole ausgeblendet wird. R Markdown-Dateien zeigen die Ausgabe in der Konsole und nicht die Ausgabe im Editor. Sie unterscheiden sich im Ausgabewert in ihren YAML-Headern.
Der YAML-Header für das R-Notebook wird die Zeile haben,

---
ouptut: html_notebook
---

Der YAML-Header für die R-Markdown-Datei enthält die Zeile

ouptut: html_document

Durch Kopieren des YAML-Headers von einem R-Notizbuch in eine R-Abschriftdatei wird diese in eine R-Abschriftdatei geändert und umgekehrt. Genauer gesagt, Ändern des Werts von output in Dies liegt daran, dass das RStudio beim Öffnen IDE und das rmarkdown package verwendet beim Stricken den YAML-Header einer Datei und insbesondere den Wert des Schlüssels output im YAML-Header, um zu bestimmen, um welche Art von Dokument es sich handelt.

1
Yang Dai