desc_ggplot: Gráficos descriptivos automáticos para variables categóricas...

View source: R/desc_ggplot.R

desc_ggplotR Documentation

Gráficos descriptivos automáticos para variables categóricas y numéricas

Description

Esta función genera gráficos descriptivos (barras, histogramas, boxplots) para un conjunto de variables, de forma univariada o bivariada, con opciones para personalizar estilo, leyendas, etiquetas, tamaños de texto, etc.

Usage

desc_ggplot(
  dat,
  covariates = NULL,
  frml = NULL,
  y = NULL,
  nameFile = "descriptive_plots.pdf",
  topdf = FALSE,
  list.plots = FALSE,
  color = "#8D4ABA",
  rowcol = c(1, 1),
  show.freq = TRUE,
  bw = TRUE,
  size.n = 3,
  size.freq = 2.5,
  size.title = 10,
  size.pval = 3,
  show.pval = FALSE,
  show.n = TRUE,
  show.na = FALSE,
  legend.position = "right",
  ...
)

Arguments

dat

Data frame que contiene las variables a analizar.

covariates

Vector de nombres de variables a graficar. Si se usa frml, se sobreescribe.

frml

Fórmula del tipo y ~ x1 + x2 + ... para definir la variable dependiente y las independientes.

y

Variable de agrupación (dependiente) para análisis bivariado. Ignorado si se usa frml.

nameFile

Nombre del archivo PDF de salida si topdf = TRUE.

topdf

Lógico. Si TRUE, guarda los gráficos en un archivo PDF.

list.plots

Lógico. Si TRUE, retorna una lista con los objetos ggplot generados.

color

Color de relleno para histogramas.

rowcol

Vector de longitud 2 que indica el número de filas y columnas en el PDF.

show.freq

Lógico. Si TRUE, muestra frecuencias sobre las barras o dentro de los gráficos.

bw

Lógico. Si TRUE, agrega jitter (dispersión) a los boxplots.

size.n

Tamaño del texto que muestra el número total de observaciones (n).

size.freq

Tamaño del texto para frecuencias o porcentajes.

size.title

Tamaño del título del gráfico.

size.pval

Tamaño del texto del p-valor.

show.pval

Lógico. Si TRUE, incluye el p-valor en los gráficos bivariados.

show.n

Lógico. Si TRUE, muestra el número total de observaciones.

show.na

Lógico. Si TRUE, se incluyen los NA en los análisis.

legend.position

Posición de la leyenda en los gráficos (por ejemplo, "right", "bottom").

...

Argumentos adicionales (no usados actualmente).

Details

La función selecciona automáticamente el tipo de gráfico según el tipo de variable: - Variables factor: gráfico de barras (univariado o apilado bivariado). - Variables numéricas: histograma (univariado) o boxplot (bivariado). - Variables Date o POSIXt: histograma por fechas.

Variables de tipo character son ignoradas con una advertencia.

Value

Por defecto imprime los gráficos. Si list.plots = TRUE, retorna una lista de objetos ggplot. Si topdf = TRUE, guarda los gráficos en un archivo PDF.

Examples

## Not run: 
desc_ggplot(mtcars, covariates = c("mpg", "cyl"), y = "am", topdf = TRUE)

## End(Not run)


miriamMota/mmotaF documentation built on June 15, 2025, 11:35 a.m.