/bjc_revision_Feb2020

Revision for BJC RNR Feb 2020

Primary LanguageR

title author output
Instrucciones de scripts para el análisis de ENVE 2014 en R: BJC Revisión 2020
Patricio R. Estévez Soto
html_document
keep_md
true

Versión 0.1

Estas instrucciones detallan brevemente el procedimiento necesario para correr exitosamente los scripts diseñados para el análisis de la ENVE 2014 en R.

La ejecución consta principalmente de dos partes, la Instalación de paquetes requeridos, y la Ejecución del script.

La instalación de paquetes solo se requiere realizar una vez. La ejecución del script puede realizarse las veces que sean necesarias si se encuentran errores.

Instalación de paquetes requeridos

Los paquetes requeridos por este proyecto son los siguientes:

## devtools
## foreign
## tidyverse
## knitr
## lazyeval
## classInt
## reshape2
## lmtest
## car
## downloader
## dgof
## victim
## sandwich
## arsenal

Algunos de estos paquetes pueden ya estar instalados en nuestra computadora.

Para verificar qué paquetes no se encuentran ya instalados e instalarlos automáticamente, ejecute el siguiente comando:

source("install_packages.R")

Si prefiere, puede instalar los paquetes que hagan falta manualmente con los siguientes comandos:

install.packages('devtools')
install.packages('foreign')
install.packages('tidyverse')
install.packages('knitr')
install.packages('lazyeval')
install.packages('classInt')
install.packages('reshape2')
install.packages('lmtest')
install.packages('car')
install.packages('downloader')
install.packages('dgof')
install.packages('sandwich')
install.packages('arsenal')

Para instalar el paquete victim es necesario usar el siguiente comando (requiere tener devtools instalado).

devtools::install_github("prestevez/victim")

Instalación de Rtools

La siguientes instrucciones están pensadas para un sistema Windows.

Si la instalación reporta tERROR: compilation failed for package "XXXXXXX", o similar, será necesario instalar Rtools en la computadora.

Rtools permite la instalación de paquetes en R desde el código fuente (source). Para instalar Rtools navegamos a la página de Rtools, y descargamos el archivo ejecutable acorde a nuestra versión de R. Corremos el instalador seleccionando la opción default: "Package authoring installation".

Tras la instalación reinicie R y vuelva a correr el comando de instalación desde código fuente.

Finalmente, el script de análisis carga los paquetes, por lo que no es estrictamente necesario cargarlos de antemano.

Ejecución del script

El proyecto está diseñado para requerir la menor intervención posible para su ejecución. Una vez puesto en marcha, el script generará los reportes y outputs relevantes en una carpeta para su posterior revisión y envío.

Además de la instalación de los paquetes necesarios, descrita en la sección anterior, la única intervención necesaria es colocar los archivos .dbf que contienen los datos de la ENVE en el folder del proyecto y asignar el working directory en R al folder del proyecto.

Archivos .dbf ENVE 2014

El análisis utiliza el cuestionario principal y el módulo de delitos de la ENVE 2014. Para poder ejecutar el script, es necesario copiar Los archivos respectivos ("enve2014cuest_ciega_2014.dbf", y "enve2014delitos_ciega_2014.dbf") al folder de este proyecto.

Establecer working directory en R

Establezca el working directory en R para que apunte al folder del proyecto.

Por ejemplo:

getwd() # Devuelve cuál es el working directory actual.

setwd("C:/R/ENVE_EstevezSoto") # Establece el working directory en el folder del proyecto

Sólo se requiere que el path al folder del proyecto sea especificado.

Ejecutar el script

El proyecto está contenido en un archivo R Markdown que permite elaborar reportes automáticos de análisis realizados en R. Cuando el script termina, guarda los resultados en una archivo de texto con formato markdown (extensión .md) que puede ser abierto en cualquier editor de texto en cualquier computadora (Notepad, etc.).

Para correr el análisis, ejecute el siguiente comando en la consola de R:

knitr::knit("BJC_compliance_revision2020.Rmd")

La ejecución no debe ser demasiado tardada, pero depende del equipo en el que se corra; es normal que parezca que no hace nada.

Resultados

El script automáticamente realizará los análisis requeridos y guardará los resultados en un archivo llamado BJC_compliance_revision2020.md en la carpeta del proyecto.

Licencia

Creative Commons Attribution 4.0 License (CC-BY) 2020 Patricio Rodrigo Estévez Soto

Creative Commons Licence
This work is licensed under a Creative Commons Attribution 4.0 International License.