¿Cómo usar chronicle?

Crear archivos R Markdown a través de las funciones add_*

library(chronicle)

reporte_nuevo <-
  add_title(title = 'Así se ve un reporte de chronicle', title_level = 1) %>%
  add_density(dt = iris, groups = 'Species', value = 'Sepal.Length', faceted = F) %>%
  add_boxplot(dt = iris, groups = 'Species', value = 'Sepal.Length') %>%
  add_barplot(dt = iris, bars = 'Species', value = 'Sepal.Length') %>%
  add_table(table = head(iris),
          table_title = 'La famosa tabla iris, en una tabla de kable',
          html_table_type = 'kable') %>%
  add_table(table = ggplot2::mpg[],
            table_title = 'Y esta es mpg de ggplot2, en una tabla DataTable',
            html_table_type = 'DT')
cat(reporte_nuevo)

## 
## 
## # Así se ve un reporte de chronicle
## 
## ## Distribution of Sepal.Length by Species
## ```{r, echo =  FALSE, message =  FALSE, warning =  FALSE}
## make_density(dt = iris, value = 'Sepal.Length', groups = 'Species', faceted = 'FALSE', scales = 'fixed')
## ```
## 
## ## Distribution of Sepal.Length by Species
## ```{r, echo =  FALSE, message =  FALSE, warning =  FALSE}
## make_boxplot(dt = iris, value = 'Sepal.Length', groups = 'Species', jitter = 'TRUE')
## ```
## 
## ## Sepal.Length by Species
## ```{r, echo =  FALSE, message =  FALSE, warning =  FALSE}
## make_barplot(dt = iris, bars = 'Species', value = 'Sepal.Length', horizontal = 'FALSE', sort_by_value = 'FALSE', sort_decreasing = 'TRUE', ggtheme = 'minimal')
## ```
## 
## ## La famosa tabla iris, en una tabla de kable
## 
## ```{r, echo = FALSE, message = FALSE, warning = FALSE}
## knitr::kable(head(iris))
## ```
## 
## ## Y esta es mpg de ggplot2, en una tabla DataTable
## 
## ```{r, echo = FALSE, message = FALSE, warning = FALSE}
## DT::datatable(ggplot2::mpg[])
## ```

Las llamadas de las funciones make_*

Cada gráfico que se agregue con una función add_, lo hará a través de una llamada a una función make_. Estas son las que realmente crean los gráficos con todas sus especificaciones.

make_barplot(dt = ggplot2::mpg,
             value = 'cty',
             bars = 'manufacturer',
             break_bars_by = 'model',
             horizontal = TRUE,
             sort_by_value = TRUE)

make_density(dt = iris,
             value = 'Sepal.Length',
             groups = 'Species',
             faceted = FALSE)

Estas funciones se pueden llamar independientemente y agregar a reportes ya existentes, o a cualquier otro lugar donde se pueda montar un gráfico html.

Compilación del R Markdown

La función render_report() se encarga de construir el encabezado yaml del R Markdown. Puede construir varios encabezados para varios formatos de salida en una sola llamada. Así, por ejemplo, se puede preparar una presentación con diapositivas html, para luego distribuirlo a la audiencia como un reporte o cuaderno interactivo.

Otra fortaleza de render_report() es que hace la compilación directamente desde el ambiente global. Es decir, tiene visibilidad de todos los objetos que se hayan cargado en memoria hasta momento de llamar la función. Así, no hay necesidad de repetir la carga y procesamiento de datos para cada vez que se quiere generar el archivo, y se pueden generar distintos reportes para distintas audiencias con la misma corrida de preparación de datos.

render_report(report = reporte_nuevo,
              filename = 'chronicle-conectaR2021',
              title = 'Demo de chronicle en ConectaR 2021',
              author = '(Aquí va la autora/el autor)',
              output_format = c('prettydoc', 'ioslides'),
              keep_rmd = TRUE,
              render_html = TRUE,
              table_of_content = FALSE,
              number_sections = FALSE,
              highlight = 'vignette')

Reportería HTML ¡sin fricción!