Reemplaza los nombres técnicos de las columnas (e.g., `p25_sexo`) por sus descripciones en español del diccionario oficial del INE (e.g., `"25. Es mujer u hombre"`). Detecta automáticamente el censo (1976, 1992, 2001, 2012 o 2024) a partir de los nombres de columna. Útil para tablas y reportes destinados a lectores no técnicos.
Value
El mismo `df` con los nombres de columnas reemplazados por sus descripciones. Las columnas no encontradas en el diccionario conservan su nombre original.
Details
Las descripciones pueden contener espacios y caracteres especiales.
En RMarkdown/Quarto se muestran directamente en tablas. Para referenciarlas
en código R usa backticks: df$`25. Es mujer u hombre`.
La detección automática del censo compara nombres de columna con los codebooks disponibles. Usa `anio` explícito si el data frame tiene muy pocas columnas o solo columnas geográficas.
Examples
# Renombrar columnas de un resumen del diccionario
codebook_meta[1:5, c("variable", "etiqueta", "tabla")] |>
etiquetar_variables()
#> Warning: No se pudo detectar el censo por los nombres de columnas. Usando 2024.
#> ℹ Especifica el año con `anio`: `etiquetar_valores(df, anio = 1992)`
#> variable etiqueta
#> 1 p24_parentes 24. Que parentesco tiene con la jefa o jefe del hogar
#> 2 p25_sexo 25. Es mujer u hombre
#> 3 p26_edad 26. Cuantos años cumplidos tiene
#> 4 p28_cn 28. Su nacimiento está inscrito en el registro civil boliviano
#> 5 p29_ci 29. Tiene o tuvo cédula de identidad boliviana
#> tabla
#> 1 persona
#> 2 persona
#> 3 persona
#> 4 persona
#> 5 persona
# Censo 2024: valores y nombres etiquetados
if (FALSE) { # \dontrun{
get_personas_2024(departamento = "Pando") |>
dplyr::count(p25_sexo, nivel_edu) |>
dplyr::collect() |>
etiquetar_valores() |>
etiquetar_variables()
} # }
# Censo 1992: mismo flujo sin especificar año
if (FALSE) { # \dontrun{
get_personas_1992(departamento = "07") |>
dplyr::count(P25) |>
dplyr::collect() |>
etiquetar_valores() |>
etiquetar_variables()
} # }