La estructura básica de RMD es : Un encabezado YAML (opcional) rodeado por guiones — Uno o más fragmentos de código R conocidos como “chunks” rodeados por comillas simples ``` Uno o mas fragmentos de texto mezclado con formato de texto simple
El encabezado también conocido como YAML incluye algunas marcas como : Author: Title : Output:
En la parte superior encontrará un ícono (ruedita) que configura donde sale la salida
Todos los chunks deben ser ejecutados con el boton de run
Agregue un nuevo fragmento haciendo clic en el botón * Insertar fragmento * en la barra de herramientas o presionando * Ctrl + Alt + I *.
Vamos a agregar el código del laboratorio de coordenadas geodésicas
require(maps)
## Loading required package: maps
require(rgeos)
## Loading required package: rgeos
## Loading required package: sp
## rgeos version: 0.5-8, (SVN revision 679)
## GEOS runtime version: 3.9.1-CAPI-1.14.2
## Please note that rgeos will be retired by the end of 2023,
## plan transition to sf functions using GEOS at your earliest convenience.
## GEOS using OverlayNG
## Linking to sp version: 1.4-5
## Polygon checking: TRUE
require(cowplot)
## Loading required package: cowplot
require(googleway)
## Loading required package: googleway
require(ggrepel)
## Loading required package: ggrepel
## Loading required package: ggplot2
## Warning: package 'ggplot2' was built under R version 4.1.2
require(lwgeom)
## Loading required package: lwgeom
## Linking to liblwgeom 3.0.0beta1 r16016, GEOS 3.9.1, PROJ 7.2.1
#require(libwgeom) esta no existe
require(sf)
## Loading required package: sf
## Linking to GEOS 3.9.1, GDAL 3.2.1, PROJ 7.2.1
require(rnaturalearth)
## Loading required package: rnaturalearth
require(rnaturalearthdata)
## Loading required package: rnaturalearthdata
#require(rnaturalearthhires) #este require Rtools pero Rtools no esta disponible para esta version R
require(devtools)
## Loading required package: devtools
## Loading required package: usethis
## Warning: package 'usethis' was built under R version 4.1.2
require("ggplot2")
#install_github("ropensci/rnaturalearthhires") #posiblemente no necesitamos
require("ggspatial")
## Loading required package: ggspatial
#Primero cargamos el mapa de la tierra,
world <- ne_countries(scale = "small", returnclass = "sf")
Cuando guarde el cuaderno, un archivo HTML que contiene el código y la salida se guardará junto a él (haga clic en el botón * Vista previa * o presione * Ctrl + Mayús + K * para obtener una vista previa del archivo HTML).
La vista previa muestra una copia HTML renderizada 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.
El lenguaje de marcado contiene meta caracteres que son similares a aquellos de html
Podemos crear listas numeradas únicamente indicando un número y punto : ejemplo :Los siguientes temas se deben tener en cuenta para crear un mapa
Se puede configurar distintos estilos con el subrayado (_) italica , bold , italica bold Ejemplo
Con la ayuda de los sistemas de referencia de coordenadas (CRS), cada lugar de la tierra se puede especificar mediante un conjunto de tres números, llamados coordenadas. Que son : latitud , longitud y, altura
Se puede crear links tanto al mismo documento como a internet. Por ejemplo : crs toma el código PROJ4 que es el tipo de proyección espacial , para obtener referirse a : spatial reference
Para crear fórmulas debemos utilizar Latex. LaTeX es un sistema de composición tipográfica de alta calidad; incluye funcionalidades diseñadas para la producción de documentación técnica y científica. LaTeX es el estándar de facto para la comunicación y publicación de documentos científicos. LaTeX está disponible como software gratuito.
\[ \bar(x) = \sum_ { i=1}^n \frac{xi}{n} \] Más información de la sintaxis Latex puede encontrar en : latex en 30 minutos
Muy fácil podemos hacerlo usando una función de knitr llamadas kable
library(knitr)
kable(mtcars[1:4,] , caption="Dataset de Mtcars")
| mpg | cyl | disp | hp | drat | wt | qsec | vs | am | gear | carb | |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Mazda RX4 | 21.0 | 6 | 160 | 110 | 3.90 | 2.620 | 16.46 | 0 | 1 | 4 | 4 |
| Mazda RX4 Wag | 21.0 | 6 | 160 | 110 | 3.90 | 2.875 | 17.02 | 0 | 1 | 4 | 4 |
| Datsun 710 | 22.8 | 4 | 108 | 93 | 3.85 | 2.320 | 18.61 | 1 | 1 | 4 | 1 |
| Hornet 4 Drive | 21.4 | 6 | 258 | 110 | 3.08 | 3.215 | 19.44 | 1 | 0 | 3 | 1 |
El archivo puede generar salidas de distintos tipos.
La cabecera del archivo tiene un argumento para indicar que tipo de archivo deberá generar. Sin embargo es tambien posible generar distintos tipos de salida con el siguiente código library(rmarkdown) render(“1-example.Rmd”, output_format = “word_document”)
Los siguientes formatos son configurables en el YAML :
El botón de Knitr del IDE procesa un archivo en el primer formato listado en su campo de salida. Puede renderizar en formatos adicionales haciendo clic en el menú desplegable al lado del botón :
Los siguientes formatos son configurables en el YAML
Es importante primero ejecutar cada una de las secciones de código R. Cada vez que se ejecuta se guarda un cache de la última renderización .
Ejecute el Preview y presione el botón de Publish al lado derecho de la ventana
Seleccione RPUB, necesitará un cuenta en RPUB, si no la tiene podrá crearla inmediatamente y guarde el URL resultante
Para mayor información revisar este cheat sheet