prestevez / bjc_revision_feb2020 Goto Github PK

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.

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")

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.

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.

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.

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.

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.

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.

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

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