-
-
Notifications
You must be signed in to change notification settings - Fork 9
/
README.Rmd
126 lines (88 loc) · 6.49 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# Censo 2017 (Paquete R)
<!-- badges: start -->
[](https://lifecycle.r-lib.org/articles/stages.html#stable-1)
[](https://www.tidyverse.org/lifecycle/#stable)
[](https://github.com/ropensci/censo2017/actions)
[](https://codecov.io/gh/ropensci/censo2017)
[](https://CRAN.R-project.org/package=censo2017)
[](https://doi.org/10.5281/zenodo.4277761)
[](https://www.buymeacoffee.com/pacha?via=github)
[](https://github.com/ropensci/software-review/issues/414)
<!-- badges: end -->
# Acerca de
Provee un acceso conveniente a mas de 17 millones de registros de la base de datos del Censo 2017. Los datos fueron importados desde el DVD oficial del INE usando el [Convertidor REDATAM](https://github.com/discontinuos/redatam-converter/) creado por Pablo De Grande y ademas se proporcionan los mapas que acompanian a estos datos. Estos mismos datos en DVD posteriormente quedaron disponibles en las [Bases de Datos del INE](https://www.ine.cl/estadisticas/sociales/censos-de-poblacion-y-vivienda/poblacion-y-vivienda).
Despues de la primera llamada a `library(censo2017)` se le pedira al usuario que descargue la base usando `censo_descargar_base()` y se puede modificar la ruta de descarga con la variable de entorno `CENSO2017_DIR`. La variable de entorno se puede crear con `usethis::edit_r_environ()`.
La documentacion esta disponible en https://docs.ropensci.org/censo2017/.
# Publico objetivo
Estudiantes, academicos e investigadores que necesiten un acceso conveniente a datos censales directamente en R o RStudio.
# Requerimientos de instalacion
Este paquete necesita 3.5 GB libres para la crear la base de datos localmente.
# Instalacion
Version estable
```
install.packages("censo2017")
```
Version de desarrollo
```
# install.packages("remotes")
remotes::install_github("ropensci/censo2017")
```
# Valor agregado sobre los archivos SHP y REDATAM del INE
Esta version de la base de datos del Censo 2017 presenta algunas diferencias respecto de la original que se obtiene en DVD y corresponde a una version DuckDB derivada a partir de los Microdatos del Censo 2017 en formato DVD.
La modificacion sobre los archivos originales, que incluyen geometrias detalladas disponibles en [Cartografias Censo2017](https://github.com/ropensci/censo2017-cartografias), consistio en unir todos los archivos SHP regionales en una unica tabla por nivel (e.g en lugar de proveer `R01_mapa_comunas`, ..., `R15_mapa_comunas` combine las 15 regiones en una unica tabla `mapa_comunas`).
Los cambios concretos respecto de la base original son los siguientes:
* Nombres de columna en formato "tidy" (e.g. `comuna_ref_id` en lugar de `COMUNA_REF_ID`).
* Agregue los nombres de las unidades geograficas (e.g. se incluye `nom_comuna` en la tabla `comunas` para facilitar los filtros).
* Aniadi la variable `geocodigo` a la tabla de `zonas`. Esto facilita mucho las uniones con las tablas de mapas en SQL.
* Tambien inclui las observaciones 16054 to 16060 en la variable `zonaloc_ref_id`. Esto se debio a que era necesario para crear una llave foranea desde la tabla `mapa_zonas` (ver repositorio [Cartografias Censo2017](https://github.com/ropensci/censo2017-cartografias)) y vincular el `geocodigo` (no todas las zonas del mapa estan presentes en los datos del Censo).
Ademas de los datos del Censo, inclui la descripcion de las variables en formato tabla (y no en XML como se obtiene del DVD). La ventaja de esto es poder consultar rapidamente lo que significan los codigos de variables y su etiquetado, por ejemplo:
```{r message=FALSE, warning=FALSE}
# con la bbdd instalada
library(censo2017)
library(dplyr)
censo_tabla("variables") %>%
filter(variable == "p01")
censo_tabla("variables_codificacion") %>%
filter(variable == "p01")
```
# Relacion de Censo 2017 con Chilemapas
Todos los datos de estos repositorios contemplan 15 regiones pues los archivos del Censo se entregan de esta forma y este paquete esta 100% orientado a facilitar el acceso a datos.
Por su parte, [chilemapas](https://docs.ropensci.org/censo2017) se centra unicamente en los mapas y tambien usa las cartografias del DVD del Censo para entregar mapas simplificados (de menor detalle y mas livianos). Chilemapas cuenta con una transformacion de codigos para dar cuenta de la creacion de la Region de Niuble.
En resumen, censo2017 permite construir estadisticas demograficas y chilemapas ayuda a mostrarlas en un mapa usando ggplot2 (u otro paquete como tmap).
# Cita este trabajo
Si usas `censo2017` en trabajos academicos u otro tipo de publicacion por favor usa la siguiente cita:
```
Mauricio Vargas (2020). censo2017: Base de Datos de Facil Acceso del Censo
2017 de Chile (2017 Chilean Census Easy Access Database). R package version
0.1. https://docs.ropensci.org/censo2017/
```
Entrada para BibTeX:
```
@Manual{,
title = {censo2017: Base de Datos de F\'acil Acceso del Censo 2017 de Chile
(2017 Chilean Census Easy Access Database)},
author = {Mauricio Vargas},
year = {2020},
note = {R package version 0.1},
url = {https://docs.ropensci.org/censo2017/},
doi = {10.5281/zenodo.4277761}
}
```
# Contribuciones
Para contribuir a este proyecto debes estar de acuerdo con el [Codigo de Conducta de rOpenSci](https://ropensci.org/code-of-conduct/). Me es util contar con mas ejemplos, mejoras a las funciones y todo lo que ayude a la comunidad. Si tienes algo que aportar me puedes dejar un issue o pull request.
# Agradecimientos
Muchas gracias a Juan Correa por su asesoria como geografo experto.
# Aportes
Si quieres donar para aportar al desarrollo de este y mas paquetes Open Source, puedes hacerlo en [Buy Me a Coffee](https://www.buymeacoffee.com/pacha/).