9.3 RMarkdown

La manera más sencilla de interactuar con R es a través de documentos conocidos como archivos de R Markdown, que ya se ha visto a modo de ejemplo en la sección anterior15. Estos documentos son una combinación de varios tipos de información. Por un lado, lo que se conoce como “fragmentos de código” (code chunks), que son un tipo de ventanas en R donde se escribe código para ejecutar análisis. También, fuera de esos fragmentos de código se puede escribir texto. En esta sección se explicará con mayor detalle cómo formatear el texto en el documento de R. Para ello seguir los pasos:

  • Abrir el primer proyecto de RStudio, el cual estará alojado en el directorio del equipo local llamado “proyectos_r” o similar.

  • Dentro de esa carpeta, seleccionar el documento llamado “primer_proyecto.Rproj”.

  • Otras carpetas que se encuentran allí son: “datos” e “imágenes”.

  • Descargar una foto de Internet o seleccionar una foto antigua que se encuentre en la computadora y guardarla en la carpeta de “imágenes”.

  • Crear un nuevo documento clicando en la barra superior de RStudio llamada “documentos”, y luego en R Markdown. Otra opción es clicar sobre el ícono de una hoja blanca con un círculo verde en la esquina superior izquierda de la barra de herramientas de RStudio. Aparecerá una ventana, que se rellena con el título y el autor. Luego, guardarlo con un nombre al archivo y almacenarlo en la carpeta del proyecto, en “documentos_r”.

  • El documento posee un template, clicar sobre el botón “Knit”, acompañado de un ícono de un ovillo de lana y unas agujas de tejer (barra superior izquierda). Se obtendrá un archivo de tipo HTML con el título, la fecha y el autor, que se puede eliminar en caso de ser necesario.

9.3.1 Agregar texto

La cantidad de símbolos de numeral (#) indica el nivel del título o subtítulo que se desea editar. Es necesario dejar un espacio entre el numeral y el texto que se escribe para obtener los títulos en negrita y sin el símbolo. Se debe utilizar el primer nivel de títulos en cada documento R Markdown. Se prueban los niveles diferentes en un documento de R Markdown de la siguiente manera:

# Título nivel 1 Título nivel 2 Título nivel 3 Título nivel 4

Recordatorio: Clicar Control + S constantemente para guardar los cambios efectuados en el documento, a medida que se trabaja sobre él.

9.3.2 Listas

  • Se utiliza el símbolo del asterisco para realizar bullet-points (* Bullet)

  • Para un sub-bullet se usa el signo sumatorio (+ Sub-bullet)

  • Para un tercer nivel de sub-bullet, el signo de restas (- Tercer nivel de bullets)

  • Es importante, además de los símbolos, indentar las líneas cada vez que reduzca mi número de bullets en una lista. Espaciar entre el símbolo y el contenido de la lista. Además hay que dejar un espacio una vez finalizada la lista y antes de comenzar otra nueva.

  • Se puede hacer una prueba creando una lista sobre “Materias que no me gustan de mi carrera”. Para presentar la lista, se debe agregar una línea de texto común, con su descripción.

  • Luego, clicar en “Knit” para generar el documento.

9.3.3 Editar texto

  • Para incluir algún formato de texto, se deben utilizar los siguientes símbolos al inicio y al final de cada palabra o grupo de palabras que se desea editar:
*Itálicas*
    
**Resaltado**
    
Texto ^superscript^
    
Texto ~subscript~

9.3.4 Insertar imágenes

  • Las imágenes son fáciles de agregar, siguiendo las líneas de código siguiente:
![Caption for image](filepath_for_image)

  • Se puede hacer una prueba agregando una foto que nos guste.

  • Se puede colocar el epígrafe de la foto del siguiente modo:

![Figura 1: Mi mascota hermosa: Nina](imagenes/nina.jpeg)
Figura 1: Mi mascota: Nina
Figura 1: Mi mascota: Nina
  • También es posible seleccionar el tamaño de la imagen.
![Nina](imagenes/nina.jpeg){width=50%}
Nina
Nina

9.3.5 Enlaces

  • Para incluir un enlace se debe:
Incluir entre corchetes [lo que aparecerá] en el texto y, seguido, entre paréntesis (el enlace que redirige al sitio que se seleccione).

Link a google

9.3.6 Tips para escribir código en R

  • A la hora de escribir en este lenguaje de programación, hay que conocer algunas funcionalidades que permiten resolver acciones claves y responder a dudas de manera simple. Para obtener información sobre una función concreta, se puede utilizar alguna de las siguientes funciones:
help(solve)
`?`(solve)

  • Las mayúsculas y minúsculas importan. R es un lenguaje de expresiones que es sensible a las mismas y responde de manera diferente a cada una.

  • Las órdenes elementales consisten en expresiones o en asignaciones. Las órdenes se separan con un punto y coma, (‘;’), o cambiando de línea.

  • Las flechas verticales permiten recuperar órdenes previas y ejecutarlas y las horizontales permiten desplazarnos dentro de una orden para corregirla.

  • Para eliminar objetos puede utilizar la orden “rm”, por ejemplo:

rm(x, y, z, cabello, perro, bonito)

  1. Un resumen de las funciones y comandos que dispone R Markdown puede encontrarse aquí↩︎