dnme-minturdep / comunicacion Goto Github PK

View Code? Open in Web Editor NEW

4.0 2.0 6.0 10.44 MB

Paquete de R con herramientas para la comunicación institucional de la DNMyE

Home Page: https://dnme-minturdep.github.io/comunicacion/

License: GNU General Public License v3.0

R 56.55% CSS 28.83% HTML 14.61%

rpackage estadistica argentina rstats r

comunicacion's Introduction

{comunicacion}

{comunicacion} ofrece herramientas que facilitan la visualización de datos en la Dirección Nacional de Mercados y Estadísticas del Ministerio de Turismo y Deportes de la Nación.

Instrucciones de instalación

Versión en desarrollo:

devtools::install_github("dnme-minturdep/comunicacion", upgrade = F)

Funciones

crear_informe(): Función para crear y abrir un template de informes para la DNMYE
crear_presentacion(): Función para crear y abrir un template de presentaciones para la DNMYE
dnmye_colores(): Función para extraer los colores institucionales de la DNMYE como colores HEX
dnmye_paletas(): Función para extraer paletas de colores colores institucionales de la DNMYE como colores HEX
scale_color_dnmye(): Constructor de escala de colores de contorno (argumento color) con estética de la DNMYE para gráficos generados con {ggplot2} y su gramática de gráficos
scale_fill_dnmye(): Constructor de escala de colores de relleno (argumento fill) con estética de la DNMYE para gráficos generados con {ggplot2} y su gramática de gráficos
gt_theme_dnmye(): Tema personalizado con estética de la DNMYE para tabulados generados con {gt} y su gramática de tablas-
rmdautotabs(): Permite generar automáticamente el código necesario para agrupar múltiples fragmentos de Rmarkdown en pestañas. Tomado de {sknifedatar}

Modo de uso

Estos son ejemplos básicos sobre cómo utilizar las funciones de la librería:

library(comunicacion)

# Obtengo la paleta completa
comunicacion::dnmye_colores()
#>  [1] "#EE3D8F" "#F7941E" "#FFD100" "#D7DF23" "#50B8B1" "#9283BE" "#37BBED"
#>  [8] "#50535C" "#AAAAAA" "#E7E7E7"

# El código HEX para un color específico 
comunicacion::dnmye_colores("azul verde")
#> [1] "#50B8B1"

Colores institucionales

Paletas de colores primarios y secundarios del manual de estilo de Presidencia la Nación.

# Explorar paleta de colores institucionales

scales::show_col(dnmye_colores())

Cómo contribuir con el proyecto

Para colaborar en este proyecto, se recomienda hacer un Fork, trabajar sobre ese repositorio y, antes de hacer el pull request, correr el devtools::check() para garantizar que no haya conflictos.

comunicacion's People

Contributors

Stargazers

Watchers

Forkers

sildele jgjuara hernancolazo eliansoutu tuqmano ssoubie

comunicacion's Issues

Build error on MacOs - staplr

https://github.com/r-universe/dnme-minturdep/actions/runs/5134567150/jobs/9238910464

implementar uso de Fonts

Emular uso / importacion / instalacion de font Encode siguiendo código de acá https://github.com/hrbrmstr/hrbrthemes

bocetar funciones
chequear en instancias que no tengan instalado Encode en su sistema para ver cómo funciona

Armar función para parámetros estándar de tablas gt

Primer boceto:

estetica_gt <- function(base = data, alineacion = "left",negrita = "bold",ancho = 600,tamaño_fuente = 10,alto_fila = 1)
  {
  
  base %>% 
  tab_options(table.align = alineacion,
              row_group.font.weight = negrita,
              table.width = ancho,
              table.font.size = tamaño_fuente,
              data_row.padding = px(alto_fila))

}

Setear ancho / alto estandar en gráficos para el esqueleto del informe template

Revisar colores y códigos hex en `dnmye_colores()`

A riesgo de exponer mi daltonismo, algunos códigos hex parecieran no coincidir con los colores:

comunicacion::dnmye_colores("rojo")
#EE3D8F

comunicacion::dnmye_colores("violeta")
#9283BE

comunicacion::dnmye_colores("verde oscuro")
#50B8B1

comunicacion::dnmye_colores("gris oscuro")
#50535C

Resolver lugar de los grises en paleta de colores

Opción 1: Pasar grises al centro de la paleta:


  paletas <- list(

    `c2_continuo`  = c("#50B8B1", "#9283BE"),
    `c2_contraste` = c("#50B8B1", "#EE3D8F"),
    `c10_todos`     = c("#EE3D8F", "#F7941E", "#FFD100", "#D7DF23", "#AAAAAA", "#E7E7E7", "#50B8B1",
                        "#9283BE", "#37BBED", "#50535C"))

  #rlang::check_installed("grDevices", reason = "Para usar `dnmye_paletas()`")

  pal <- paletas[[palette]]

  if (reverse) pal <- rev(pal)

  grDevices::colorRampPalette(pal, ...)
}

Opción 2: sacar grises de la paleta C10_todos:


  paletas <- list(

    `c2_continuo`  = c("#50B8B1", "#9283BE"),
    `c2_contraste` = c("#50B8B1", "#EE3D8F"),
    `c8_todos`     = c("#EE3D8F", "#F7941E", "#FFD100", "#D7DF23", "#50B8B1",
                        "#9283BE", "#37BBED", "#50535C"))

  #rlang::check_installed("grDevices", reason = "Para usar `dnmye_paletas()`")

  pal <- paletas[[palette]]

  if (reverse) pal <- rev(pal)

  grDevices::colorRampPalette(pal, ...)
}

Opción 3: Armar dos paletas, una con grises otra sin grises


  paletas <- list(

    `c2_continuo`  = c("#50B8B1", "#9283BE"),
    `c2_contraste` = c("#50B8B1", "#EE3D8F"),
    `c8`     = c("#EE3D8F", "#F7941E", "#FFD100", "#D7DF23", "#50B8B1",
                        "#9283BE", "#37BBED", "#50535C"),
    `c10_todos`     = c("#EE3D8F", "#F7941E", "#FFD100", "#D7DF23", "#AAAAAA", "#E7E7E7", "#50B8B1",
                        "#9283BE", "#37BBED", "#50535C"))

  #rlang::check_installed("grDevices", reason = "Para usar `dnmye_paletas()`")

  pal <- paletas[[palette]]

  if (reverse) pal <- rev(pal)

  grDevices::colorRampPalette(pal, ...)
}

Corregir documentacion de función `scale_fill_dnmye()`

Antes: Constructor de escala de colores de contorno (color) para la dnmye

Debería ser: Constructor de escala de colores de relleno (argumento fill) para la dnmye

Agregar función para crear template por consola a lo `comunicacion::crear_informe()`

Hoy la función armar template vía panel de control al crear un Rmarkdown por File --> New file --> Rmarkdown --> From Template --> comunicacion

Función `gt_theme_dnmye()`

Tenemos 2 sugerencias para la función:

Alineación columnas: actualmente centra a partir de la segunda columna. Se podría especificar que la primera la alinee a la izquierda
Variables coloreadas: sacar el color condicional para las columnas relativas a proporciones, ahí no hace falta