the - Diferencia entre R MarkDown y R NoteBook

r notebook cheat sheet

Question

Estoy tratando de entender a alto nivel cuáles son las diferencias entre R Markdown y R NoteBook . Sé que están interrelacionados, pero me gustaría averiguar cómo están relacionados. Mi entendimiento es este:

Sé que los R Notebook son realmente documentos de R Markdown, pero estoy confundido acerca de las terminologías.

La nueva opción de archivo RStudio tiene R Markdown y R NoteBook y al seleccionar cualquiera de ellos se abre un archivo R Markdown pero con pequeñas diferencias. Entonces, solo tratando de averiguar por qué hay dos opciones y cuál es la diferencia entre las dos.

Entiendo que R Notebooks se introdujeron recientemente y R Markdown ha estado allí por un tiempo. Parte de la confusión podría deberse a que nunca usé R Markdown antes de que se introdujera R Notebook, por lo que mi pregunta relacionada o más específica es

¿Qué está haciendo R NoteBook de manera diferente a solo usar R MarkDown o qué nuevas capacidades trae R NoteBook?

Todos mis éxitos en la búsqueda web apuntan a que R Notebook usa R Markdown, pero no encontré ninguna ayuda sobre lo que es específicamente diferente entre los dos.

Answer 1

Aquí hay una diferencia práctica que encontré:

Cuando necesite comentar una parte del texto, RMarkdown inserta # en cada línea de su texto, mientras que RNotebook encapsula perfectamente el texto entre un solo par de signos <!-- , ---> (como en los archivos html)

Se puede decir, qué diferencia trivial. Sin embargo, solo por eso, ahora siempre uso R Notebook (en lugar de RMarkdown) en RStudio para todos mis documentos. En todo lo demás, parecen lo mismo (para mis necesidades, al menos, como generar html y pdf)

De lo contrario, mis comentarios de repente se convierten en encabezados, como a continuación:

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

Answer 2

De jrnold :

Los archivos del cuaderno R muestran la salida dentro del editor, mientras que ocultan la consola. Los archivos R markdown muestran la salida dentro de la consola y no muestran la salida dentro del editor. Difieren en el valor de salida en sus encabezados YAML.
El encabezado YAML para el cuaderno R tendrá la línea,

---
ouptut: html_notebook
---

El encabezado YAML para el archivo R markdown tendrá la línea,

ouptut: html_document

Copiar el encabezado YAML de un cuaderno R a un archivo de rebaja R lo cambia a un archivo de rebaja R y viceversa. Más específicamente, cambiar el valor de output a Esto se debe a que el IDE de RStudio al abrir y el paquete rmarkdown al tejer utiliza el encabezado YAML de un archivo, y en particular el valor de la clave de output en el encabezado YAML, para determinar qué tipo de documentarlo es.

Answer 3

La diferencia es que en R Notebok puede escribir Markdown y R-code Chunks y ejecutarlos directamente y ver los resultados de inmediato. Es una especie de cuaderno para ti.

R Markdown está ahí para crear resultados atractivos en html, pdf o un documento de Word. Combinando Markdown y R-Code-Chunks. Una breve introducción y motivación se puede encontrar aquí .

Si desea obtener más información sobre el paquete knitr, haga clic aquí.

Answer 4

Por lo que yo entiendo y desde mi configuración no hay diferencia de codificación. La diferencia está en el renderizado. La extensión del archivo es la misma.

Cuando html_notebook un nuevo R Notebook, agrega html_notebook en la opción de salida en el encabezado. Esa es la diferencia. Luego puede previsualizar el renderizado rápidamente sin tener que tejerlo. También actualiza la vista previa cada vez que guarda. Sin embargo, en esa vista previa no tiene la salida del código (sin figuras, sin tablas ...) (al menos en mi configuración). Sin html_notebook en la salida no hay vista previa del botón

como puede ver, se muestran las opciones de Vista previa, pero también puede tejerlo en el formato que desee. Lo agregará al código del encabezado cuando lo haga.

Sin embargo, si no tiene ese html_notebook en su encabezado, solo puede tejer su código para ver cómo se ve (todo el libro) (ignore la opción predeterminada adicional que html_notebook con la imagen)

y la opción de vista previa no se muestra en el menú desplegable

De lo contrario, funciona igual. Para algunas configuraciones predeterminadas, la salida también está oculta por defecto en la sección de código.

Tenga en cuenta que puede mezclar varias opciones de salida en su encabezado para que pueda mantener la vista previa y mantener sus opciones de punto para exportar.

Answer 5

Recientemente encontré esta publicación que me dejó claro sobre el tema R Markdown vs. R Notebook. http://uc-r.github.io/r_notebook

Aquí hay algunas líneas relevantes:

Escribir un documento de R Notebook no es diferente a escribir un documento de R Markdown. La sintaxis del fragmento de texto y código no difiere de lo que aprendió en el tutorial de R Markdown. La diferencia principal está en la interactividad de un R Notebook. Principalmente que cuando se ejecutan fragmentos en un documento R Markdown, todo el código se envía a la consola a la vez , pero en un R Notebook, solo se envía una línea a la vez . Esto permite que la ejecución se detenga si una línea genera un error.

También existe esto en knit vs. vista previa cuando crea un R Notebook en RStudio:

La vista previa le muestra una copia HTML representada del contenido del editor. En consecuencia, a diferencia de Knit , Preview no ejecuta ningún fragmento de código R. En su lugar, se muestra la salida del fragmento cuando se ejecutó por última vez en el editor.

Esperamos que te sea útil.

Answer 6

Una de las diferencias más importantes no está completamente clara en las respuestas anteriores.

De la Sección 3.2.1.3 del libro Bookdown :

También hay un elemento Restart R and Run All Chunks todos los fragmentos en el menú Run en la barra de herramientas del editor, que le brinda una nueva sesión de R antes de ejecutar todos los fragmentos. Esto es similar al botón Knit , que inicia una sesión R separada para compilar el documento.

En otras palabras, tejer crea un nuevo entorno y ejecuta todo el código allí. Por el contrario, el R Notebook utiliza el entorno global tal como es para representar el archivo HTML. De hecho, para un R Notebook, los cambios en el archivo HTML ocurren cada vez que se .Rmd documento .Rmd . El botón Preview simplemente abre el archivo HTML en su estado actual. No se ejecuta código. Preview literalmente significa lo que dice: solo muestra lo que ya se ha hecho.

¿Por qué importa esto? Por ejemplo, si se .Rmd archivo .Rmd R Notebook, pero no se ejecutan fragmentos de código, entonces el archivo HTML hará que todo el código de entrada y .Rmd sea .Rmd , pero no aparecerá ninguna salida. O suponga que define alguna variable x en la Consola, pero no en un fragmento de código. Si intenta usar x en algún lugar de un R Notebook, funcionará bien. La vista previa del documento HTML también funcionará bien. Por otro lado, tejer el documento generará un error de "variable desconocida" porque tejer ejecuta todo el código en un nuevo entorno, y la variable x nunca se definió en el archivo de reducción en ninguna parte.

Answer 7

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

"Los documentos ordinarios de Markdown R están" unidos ", pero los cuadernos están" previsualizados ". Si bien la vista previa del cuaderno es similar a un documento R Markdown renderizado, la vista previa del cuaderno no ejecuta ninguno de sus fragmentos de código R"

Answer 8

Similitudes: el cuaderno R y el documento R Markdown son bastante similares. El formato Markdown funciona en ambos tipos de archivos. Ambos formatos de archivo se pueden usar para comunicar código junto con resultados y comentarios a otros. Se puede elegir entrelazar el documento creado a los formatos de salida HTML, PDF y WORD. Si hay un error en el código, la salida no se generará. Para ejecutar el archivo: CTRL + MAYÚS + K e insertar un fragmento de código: CTRL + ALT + I.

Documento R Markdown: el documento Rmd se puede configurar a través de un asistente y tiene opciones para reproducir documentos, diapositivas de presentación, aplicaciones brillantes, etc. y una opción para crear documentos a partir de una plantilla. Si cambia el código, la salida se ejecuta en la salida Rmd. No ofrece la opción de Vista previa del documento. El encabezado YAML tiene formato de salida como: salida: html_document

Documento de R Notebook: el documento R nb se inicia directamente y no aparece ningún asistente (como en el caso de .RMD). Junto con el archivo del cuaderno, se genera un archivo html adicional con esa extensión * .nb.html. El cuaderno tiene la opción de Vista previa. Si se altera o edita algún código, no se muestra la nueva salida. El resultado se muestra en el editor de código. Cualquiera que sea la salida anterior, solo se representa. No se genera una nueva salida a partir del cambio de código. Para mostrar la salida del código, necesitamos ejecutar el fragmento y luego aparecerá en la salida. El encabezado YAML tiene salida como: salida: html_notebook

Encabezado YAML : si cambiamos el encabezado YAML de un archivo a otro, cambiará el tipo de documento. Por ejemplo, tiene un cuaderno R que tiene un encabezado YAML como html_notebook. Si cambia el encabezado YAML, su notebook R se convertirá en un documento R Markdown.

Si tiene que elegir uno, vaya con el documento de RMarkdown , ya que ofrece más control y actualiza los documentos tan pronto como lo teje.