{"id":137,"date":"2022-06-01T23:41:07","date_gmt":"2022-06-01T23:41:07","guid":{"rendered":"https:\/\/iimyc.gob.ar\/cursor\/?page_id=137"},"modified":"2022-06-01T23:41:38","modified_gmt":"2022-06-01T23:41:38","slug":"notas","status":"publish","type":"page","link":"https:\/\/iimyc.gob.ar\/cursor\/tutoriales\/notas\/","title":{"rendered":"Notas"},"content":{"rendered":"\n

Si est\u00e1s trabajando en el laboratorio o en el campo, es esencial mantener buenas notas sobre lo que est\u00e1s haciendo para poder recordar tus m\u00e9todos y asegurarse de que tu trabajo es reproducible.<\/p>\n\n\n\n

Por el mismo motivo, una vez que tengas los datos, es esencial que tomes buenas notas sobre c\u00f3mo los procesaste. Te ayudan a entender exactamente lo que est\u00e1s haciendo y son necesarias para escribir secciones de m\u00e9todos, y para comunicar tanto los m\u00e9todos como los resultados.<\/p>\n\n\n\n

En un script tradicional de R, todo el texto es c\u00f3digo y los comentarios se separan del c\u00f3digo ejecutable comenzando una l\u00ednea con #. Por ejemplo<\/p>\n\n\n\n

plot(y ~ x)\n# c\u00f3digo para hacer un gr\u00e1fico de y frente a x<\/code><\/pre>\n\n\n\n
Sin embargo, si ten\u00e9s muchos comentarios, el script se vuelve de dif\u00edcil lectura, por lo que una forma muy limpia de escribir tu c\u00f3digo con comentarios asociados es a trav\u00e9s de las notas.<\/p>\n\n\n\n
Las notas de RStudio son una forma de documento markdown, un formato muy utilizado para exportar texto, im\u00e1genes y c\u00f3digo simult\u00e1neamente. Las notas de Rstudio tienen la ventaja a\u00f1adida de mostrar la salida de su c\u00f3digo directamente en el documento.<\/p>\n\n\n\n
Crear un nuevo cuaderno<\/h2>\n\n\n\n
Crear una nota nueva es muy f\u00e1cil: hacer clic en Archivo, Nuevo Archivo, R Notebook desde el men\u00fa de RStudio. <\/p>\n\n\n\n
Guard\u00e1 el archivo en una carpeta del proyecto<\/a>. <\/p>\n\n\n\n
Edit\u00e1 el t\u00edtulo en la parte superior, le\u00e9 r\u00e1pidamente las notas y luego elimin\u00e1 la plantilla proporcionada (a partir de \u00abEsto es un [R Markdown]\u2026\u00bb). Asegurate de dejar las primeras l\u00edneas entre las marcas -.<\/p>\n\n\n\n
Tu cuaderno es ahora una gran p\u00e1gina en blanco para que empieces a escribir todos los pasos de tu trabajo. Por ejemplo, pod\u00e9s empezar con una breve descripci\u00f3n del proyecto.<\/p>\n\n\n\n
A\u00f1adir c\u00f3digo a tus notas<\/h2>\n\n\n\n
\"\"
El c\u00f3digo ejecutable se a\u00f1ade a tus notas en lo que se llama chunk<\/em>. Para ello, haz clic en Insert, R en la parte superior derecha (o con Ctrl + Alt + I en el teclado). Esto a\u00f1adir\u00e1 un chunk<\/em> vac\u00edo que se parece a esto:<\/figcaption><\/figure>\n\n\n\n
\"\"
Cualquier c\u00f3digo que quieras ejecutar ser\u00e1 a\u00f1adido dentro del chunk<\/em>. En general, en el primer chunk<\/em> se ponen los paquetes de R que sean necesarios para lo que sigue. Por ejemplo,<\/figcaption><\/figure>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Ejecutar el c\u00f3digo<\/h2>\n\n\n\n
Ejecutar todo el c\u00f3digo en tu chunk<\/em> se logra haciendo clic en la peque\u00f1a flecha verde en la parte superior derecha de tu chunk<\/em>. Al igual que en un script, pod\u00e9s ejecutar l\u00edneas individuales de c\u00f3digo pulsando Ctrl+Enter con el cursor posicionado en esa l\u00ednea.<\/p>\n\n\n\n
Utiliza los chunks<\/em> para organizar tu flujo de trabajo, agrupando el c\u00f3digo que realiza una tarea concreta dentro de un chunk<\/em> y precedi\u00e9ndolo de comentarios de texto plano que expliquen lo que har\u00e1 cada chunk<\/em>. Evite poner cada l\u00ednea de c\u00f3digo en un trozo separado y evite tener muchas l\u00edneas de c\u00f3digo que hagan cosas diferentes dentro del mismo trozo.<\/p>\n\n\n\n
La salida de tu c\u00f3digo va a aparecer directamente debajo del fragmento de c\u00f3digo en lugar de en la consola de abajo o en el panel de gr\u00e1ficos de la derecha. Por ejemplo:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Pod\u00e9s ocultar o mostrar cualquier salida dentro de tus notas haciendo clic en las peque\u00f1as flechas hacia arriba (arriba a la derecha de la salida).<\/p>\n\n\n\n
Para expandir o colapsar toda la salida hac\u00e9 clic en el s\u00edmbolo del engranaje junto a Preview. Los ajustes que se encuentran all\u00ed tambi\u00e9n se pueden utilizar para enviar toda la salida a la consola (Chunk output in Console) o mantenerla en las notas (Chunk Output Inline).<\/p>\n\n\n\n
Si guard\u00e1s las notas y sal\u00eds de RStudio, la salida se guarda y ver\u00e1s los gr\u00e1ficos, etc. cuando vuelvas a abrir el archivo. Sin embargo, si hiciste alg\u00fan cambio en el c\u00f3digo o en los archivos de datos, tendr\u00e1s que ejecutar el c\u00f3digo de nuevo.
Esto se hace f\u00e1cilmente haciendo clic en Run, Run all. Tambi\u00e9n puede ser muy \u00fatil cuando est\u00e1s en medio de un documento apretar \u00abRun all chunks above\u00bb para asegurarse de que todo se actualiza y se ejecuta correctamente.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Exportar tus notas a otros formatos<\/h2>\n\n\n\n
Adem\u00e1s de ser una forma visualmente atractiva de combinar c\u00f3digo, figuras y comentarios, las notas tambi\u00e9n pueden utilizarse para crear informes en varios formatos (html, pdf y word).<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Si hac\u00e9s clic en Preview, podr\u00e1s ver un adelanto de su aspecto. Para hacer los documentos, elegir\u00edas entonces \u00abKnit to HTML\u00bb, por ejemplo, para hacer un archivo html.<\/p>\n\n\n\n
Los archivos html creados son una excelente manera de compartir tu trabajo. El documento \u00fanico puede abrirse en cualquier navegador y en cualquier dispositivo y tiene todos los comentarios, el c\u00f3digo, los resultados estad\u00edsticos y las cifras. El lector no necesita ejecutar ning\u00fan c\u00f3digo (ni siquiera ser un usuario de R) para ver lo que hiciste. Los archivos html tienen incluso peque\u00f1os botones para ocultar y mostrar el c\u00f3digo, y la posibilidad de invertir todo el proceso y descargar un archivo markdown desde el html.<\/p>\n\n\n\n
Cuando se hace un HTML por primera vez, es posible que te pida algunos paquetes (por ejemplo, knitr, rmarkdown). Si esto ocurre, instalalos y volv\u00e9 a hacerlo.<\/p>\n\n\n\n
Cuando veas por primera vez tu archivo html, puede que te des cuenta de que hay algunas partes no deseadas (por ejemplo, mensajes de advertencia) y que el formato podr\u00eda mejorar. Para arreglar esto, necesit\u00e1s aprender un poco m\u00e1s sobre el control del comportamiento de los trozos de c\u00f3digo, y algunos formatos b\u00e1sicos. Ac\u00e1 no lo vamos a ver, pero pod\u00e9s encontrar buena ayuda en los cheatsheets de RMarkdown<\/a>.<\/p>\n\n\n\n
Controlar el comportamiento de los chunks<\/em><\/h2>\n\n\n\n
Pod\u00e9s controlar c\u00f3mo se muestra el c\u00f3digo y su salida en el documento exportado con una serie de opciones para cada chunk<\/em>. Hay muchas (detalladas ac\u00e1<\/a>), pero las m\u00e1s \u00fatiles son:<\/p>\n\n\n\n
Si quer\u00e9s mostrar el c\u00f3digo pero no ejecutarlo, utiliza eval=F<\/strong> dentro de la {r}<\/strong> en la parte superior de tu chunk<\/em>. Eleg\u00ed si quieres ejecutar el c\u00f3digo en la salida o no<\/p>\n\n\n\n
```{r, eval=F}\n2 + 2\n```<\/code><\/pre>\n\n\n\n
Para ejecutar el c\u00f3digo, pero ocultar el c\u00f3digo en la salida:<\/p>\n\n\n\n
# ```{r, echo=F}\n2 + 2\n```<\/code><\/pre>\n\n\n\n
Para ocultar todos los mensajes y advertencias:<\/p>\n\n\n\n
```{r, warning=F, message=F}\n2 + 2\n```<\/code><\/pre>\n\n\n\n
Para cambiar el tama\u00f1o de los gr\u00e1ficos:<\/p>\n\n\n\n
```{r, fig.height=3, fig.width=10}\nggplot(Plant_height, aes(temp, loght)) +\n  geom_point()\n```<\/code><\/pre>\n\n\n\n
\n\n\n\n
La gran mayor\u00eda de este tutorial es una traducci\u00f3n de: <\/p>\n\n\n\n
https:\/\/environmentalcomputing.net\/getting-started-with-r\/rstudio-notebooks\/<\/a><\/p>\n\n\n\n
que, por cierto, es muy \u00fatil para varios aspectos del uso de R.<\/p>\n","protected":false},"excerpt":{"rendered":"
Si est\u00e1s trabajando en el laboratorio o en el campo, es esencial mantener buenas notas sobre lo que est\u00e1s haciendo para poder recordar tus m\u00e9todos y asegurarse de que tu trabajo es reproducible. Por el mismo motivo, una vez que tengas los datos, es esencial que tomes buenas notas sobre c\u00f3mo los procesaste. Te ayudan […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":12,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-137","page","type-page","status-publish","czr-hentry"],"_links":{"self":[{"href":"https:\/\/iimyc.gob.ar\/cursor\/wp-json\/wp\/v2\/pages\/137","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/iimyc.gob.ar\/cursor\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/iimyc.gob.ar\/cursor\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/iimyc.gob.ar\/cursor\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/iimyc.gob.ar\/cursor\/wp-json\/wp\/v2\/comments?post=137"}],"version-history":[{"count":1,"href":"https:\/\/iimyc.gob.ar\/cursor\/wp-json\/wp\/v2\/pages\/137\/revisions"}],"predecessor-version":[{"id":144,"href":"https:\/\/iimyc.gob.ar\/cursor\/wp-json\/wp\/v2\/pages\/137\/revisions\/144"}],"up":[{"embeddable":true,"href":"https:\/\/iimyc.gob.ar\/cursor\/wp-json\/wp\/v2\/pages\/12"}],"wp:attachment":[{"href":"https:\/\/iimyc.gob.ar\/cursor\/wp-json\/wp\/v2\/media?parent=137"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}