Curso de R para DaTax

Domina R para el Análisis en la Administración Tributaria

Bienvenida

Este curso enseña programación práctica en R aplicada a la administración tributaria. Aprenderás a analizar datos de contribuyentes, automatizar reportes y crear visualizaciones profesionales—sin necesidad de experiencia previa en programación.

Desarrollado por el equipo DaTax del Banco Mundial para administraciones tributarias de todo el mundo.

Qué Aprenderás

Al finalizar este curso, serás capaz de:

🎯 Objetivos de Aprendizaje

Gestión de Datos - Importar y exportar conjuntos de datos tributarios (CSV, Excel y otros formatos) - Limpiar y transformar registros de contribuyentes de manera eficiente - Manejar millones de filas con confianza

Análisis de Datos - Filtrar y segmentar poblaciones de contribuyentes - Calcular estadísticas tributarias y métricas de cumplimiento - Agrupar y resumir información por región, sector o periodo - Combinar conjuntos de datos de distintos sistemas tributarios

Visualización de Datos - Crear gráficos profesionales para reportes y presentaciones - Visualizar tendencias de recaudación, tasas de cumplimiento y distribuciones - Diseñar gráficos listos para publicación con ggplot2

Flujos de Trabajo Reproducibles - Escribir scripts de R claros y bien documentados - Automatizar tareas de análisis repetitivas - Compartir análisis reproducibles con colegas

¿Por Qué Aprender R para la Administración Tributaria?

Gratuito y de Código Abierto: sin costos de licencia para tu institución
Potente: capaz de manejar millones de registros de contribuyentes
Reproducible: cada paso del análisis queda documentado
Eficiente: automatiza reportes mensuales y análisis rutinarios
En Crecimiento: gran comunidad de usuarios en gobierno e investigación

Requisitos Previos

✓ Lo Que Necesitas

Requerido - Una computadora con R y RStudio instalados (ver guía de instalación abajo)
- Habilidades básicas de computación (abrir archivos, usar carpetas)
- Conexión a internet para descargar los materiales del curso

No Requerido - No necesitas experiencia previa en programación
- No necesitas conocimientos de estadística
- No necesitas experiencia previa en R o cualquier otro lenguaje

Este curso está diseñado para principiantes absolutos. Si sabes trabajar con Excel, puedes aprender R.

Estructura del Curso

El curso consta de 5 módulos secuenciales diseñados para desarrollar tus habilidades de forma progresiva:

Módulo 1: Introducción a R — Conceptos básicos de R, interfaz de RStudio, variables y tipos de datos fundamentales.

Módulo 2: Importación y Exportación de Datos — Lectura de archivos CSV y Excel, manejo de formatos y exportación de resultados.

Módulo 3: Manipulación de Datos con dplyr — Filtrado, selección, creación de variables y resúmenes de datos.

Módulo 4: Reestructuración y Unión de Datos — Transformar datos entre formato ancho y largo. Combinar múltiples conjuntos.

Módulo 5: Visualización de Datos con ggplot2 — Crear gráficos profesionales y comunicar resultados efectivamente.

Cada módulo incluye explicaciones paso a paso, ejercicios prácticos con datos tributarios reales, scripts plantilla y soluciones completas.

Primeros Pasos

Paso 1: Instalar R y RStudio

Debes instalar dos componentes: R (el lenguaje de programación) y RStudio (la interfaz que facilita su uso).

Importante: Orden de Instalación

Instala R primero y luego RStudio. RStudio necesita que R esté previamente instalado.

Instalando R

Visita el sitio de R
https://cloud.r-project.org/
Haz clic en “Download R for Windows”
Este enlace aparece en la parte superior de la página.
Haz clic en “base” o “install R for the first time”
Esto te lleva a la página de descarga de la instalación básica.
Haz clic en “Download R-4.x.x for Windows”
(El número de versión puede variar, por ejemplo R-4.4.1).
Se descargará un archivo .exe.
Ejecuta el instalador
- Doble clic en el archivo .exe descargado
- Si Windows pregunta si deseas permitir cambios, selecciona Sí
- Selecciona English (u otro idioma preferido)
- Haz clic en Next en todas las pantallas aceptando los valores por defecto
- Haz clic en Finish al completar la instalación
Verifica la instalación
- Busca el ícono de R en tu escritorio o menú de inicio
- No es necesario abrir R directamente; usarás RStudio

Visita el sitio de R
https://cloud.r-project.org/
Haz clic en “Download R for macOS”
Selecciona la versión correcta
- Macs nuevos (M1, M2, M3): el archivo “Apple silicon arm64”
- Macs antiguos (Intel): el archivo “Intel 64-bit”
- Si no estás seguro, ve al menú Apple → “About This Mac”
Descarga el archivo .pkg y ejecútalo.
Sigue los pasos de instalación, acepta la licencia y, si se solicita, ingresa tu contraseña.
Instala XQuartz (si se requiere)
https://www.xquartz.org/
Verifica la instalación
Busca R en la carpeta Applications. No es necesario abrirlo directamente.

Visita el sitio de R
https://cloud.r-project.org/
Haz clic en “Download R for Linux”
Elige tu distribución (Ubuntu, Debian, Fedora, etc.)

Instala según tu sistema:

Ubuntu/Debian:

sudo apt update
sudo apt install r-base r-base-dev

Fedora:

sudo dnf install R

Verifica instalación:
En la terminal escribe R --version y deberías ver la versión instalada.

Instalando RStudio

Con R instalado, instala RStudio:

Visita https://posit.co/download/rstudio-desktop/
Haz clic en el instalador para Windows
Ejecuta el archivo .exe y sigue los pasos por defecto
Abre RStudio desde el escritorio o menú de inicio

Descarga el instalador para macOS desde el mismo sitio
Abre el archivo .dmg y arrastra el ícono de RStudio a la carpeta Applications
Abre RStudio desde Applications

Descarga el paquete .deb o .rpm correspondiente
Ubuntu/Debian:

sudo dpkg -i rstudio-2024.xx.x-amd64.deb
sudo apt-get install -f

Fedora/RedHat:

sudo dnf install rstudio-2024.xx.x-x86_64.rpm

Abre RStudio desde el menú o ejecutando rstudio en la terminal.

Verificar Instalación

Abre RStudio (no R directamente).
Deberías ver 4 paneles: Console, Environment/History, Files/Plots/Help, Script Editor.
Prueba escribiendo en la Console:
```
2 + 2
```
Si obtienes [1] 4, ¡todo está listo!

Instalación Exitosa

Si viste [1] 4 en la consola, estás listo para comenzar.
Problemas comunes: - RStudio no abre: instala R primero
- “R not found”: reinstala R y reinicia RStudio
- Bloqueo en Mac: Seguridad y Privacidad → “Open Anyway”

Paso 2: Descargar Materiales del Curso

Visita la página Teaching Materials para descargar: - Plantillas de ejercicios (.R)
- Scripts con soluciones (.R)
- Conjuntos de datos tributarios
- Guías de referencia rápida

Paso 3: Comienza a Aprender

Haz clic en “1. Introduction to R” en la barra lateral izquierda para comenzar tu primer módulo.
Avanza en orden: cada módulo se basa en los conceptos del anterior.

¿Listo para Comenzar?

🚀 Comienza tu Camino en R

Ya tienes R y RStudio instalados. Sabes dónde encontrar los materiales del curso.
Ahora haz clic en “1. Introduction to R” para comenzar el Módulo 1.

Recuerda: todo experto fue principiante alguna vez. Tómate tu tiempo, practica y experimenta.

Desarrollado por El Equipo DaTax del Banco Mundial | Ver en GitHub

--- title: "Curso de R para DaTax" subtitle: "Domina R para el Análisis en la Administración Tributaria" format: html --- ## Bienvenida Este curso enseña programación práctica en R aplicada a la administración tributaria. Aprenderás a analizar datos de contribuyentes, automatizar reportes y crear visualizaciones profesionales—sin necesidad de experiencia previa en programación. Desarrollado por el equipo **DaTax del Banco Mundial** para administraciones tributarias de todo el mundo. --- ## Qué Aprenderás Al finalizar este curso, serás capaz de: ::: {.callout-note icon=false} ## 🎯 Objetivos de Aprendizaje **Gestión de Datos** - Importar y exportar conjuntos de datos tributarios (CSV, Excel y otros formatos) - Limpiar y transformar registros de contribuyentes de manera eficiente - Manejar millones de filas con confianza **Análisis de Datos** - Filtrar y segmentar poblaciones de contribuyentes - Calcular estadísticas tributarias y métricas de cumplimiento - Agrupar y resumir información por región, sector o periodo - Combinar conjuntos de datos de distintos sistemas tributarios **Visualización de Datos** - Crear gráficos profesionales para reportes y presentaciones - Visualizar tendencias de recaudación, tasas de cumplimiento y distribuciones - Diseñar gráficos listos para publicación con ggplot2 **Flujos de Trabajo Reproducibles** - Escribir scripts de R claros y bien documentados - Automatizar tareas de análisis repetitivas - Compartir análisis reproducibles con colegas ::: ### ¿Por Qué Aprender R para la Administración Tributaria? - **Gratuito y de Código Abierto**: sin costos de licencia para tu institución - **Potente**: capaz de manejar millones de registros de contribuyentes - **Reproducible**: cada paso del análisis queda documentado - **Eficiente**: automatiza reportes mensuales y análisis rutinarios - **En Crecimiento**: gran comunidad de usuarios en gobierno e investigación --- ## Requisitos Previos ::: {.callout-important icon=false} ## ✓ Lo Que Necesitas **Requerido** - Una computadora con R y RStudio instalados (ver guía de instalación abajo) - Habilidades básicas de computación (abrir archivos, usar carpetas) - Conexión a internet para descargar los materiales del curso **No Requerido** - No necesitas experiencia previa en programación - No necesitas conocimientos de estadística - No necesitas experiencia previa en R o cualquier otro lenguaje ::: Este curso está diseñado para principiantes absolutos. Si sabes trabajar con Excel, puedes aprender R. --- ## Estructura del Curso El curso consta de **5 módulos secuenciales** diseñados para desarrollar tus habilidades de forma progresiva: **Módulo 1: Introducción a R** — Conceptos básicos de R, interfaz de RStudio, variables y tipos de datos fundamentales. **Módulo 2: Importación y Exportación de Datos** — Lectura de archivos CSV y Excel, manejo de formatos y exportación de resultados. **Módulo 3: Manipulación de Datos con dplyr** — Filtrado, selección, creación de variables y resúmenes de datos. **Módulo 4: Reestructuración y Unión de Datos** — Transformar datos entre formato ancho y largo. Combinar múltiples conjuntos. **Módulo 5: Visualización de Datos con ggplot2** — Crear gráficos profesionales y comunicar resultados efectivamente. Cada módulo incluye explicaciones paso a paso, ejercicios prácticos con datos tributarios reales, scripts plantilla y soluciones completas. --- ## Primeros Pasos ### Paso 1: Instalar R y RStudio Debes instalar dos componentes: **R** (el lenguaje de programación) y **RStudio** (la interfaz que facilita su uso). ::: {.callout-warning} ## Importante: Orden de Instalación Instala **R primero** y luego **RStudio**. RStudio necesita que R esté previamente instalado. ::: #### Instalando R ::: {.panel-tabset} ## Windows 1. **Visita el sitio de R** [https://cloud.r-project.org/](https://cloud.r-project.org/) 2. **Haz clic en "Download R for Windows"** Este enlace aparece en la parte superior de la página. 3. **Haz clic en "base" o "install R for the first time"** Esto te lleva a la página de descarga de la instalación básica. 4. **Haz clic en "Download R-4.x.x for Windows"** (El número de versión puede variar, por ejemplo R-4.4.1). Se descargará un archivo `.exe`. 5. **Ejecuta el instalador** - Doble clic en el archivo `.exe` descargado - Si Windows pregunta si deseas permitir cambios, selecciona **Sí** - Selecciona **English** (u otro idioma preferido) - Haz clic en **Next** en todas las pantallas aceptando los valores por defecto - Haz clic en **Finish** al completar la instalación 6. **Verifica la instalación** - Busca el ícono de R en tu escritorio o menú de inicio - No es necesario abrir R directamente; usarás RStudio ## Mac 1. **Visita el sitio de R** [https://cloud.r-project.org/](https://cloud.r-project.org/) 2. **Haz clic en "Download R for macOS"** 3. **Selecciona la versión correcta** - **Macs nuevos (M1, M2, M3)**: el archivo “Apple silicon arm64” - **Macs antiguos (Intel)**: el archivo “Intel 64-bit” - Si no estás seguro, ve al menú Apple → “About This Mac” 4. **Descarga el archivo `.pkg`** y ejecútalo. Sigue los pasos de instalación, acepta la licencia y, si se solicita, ingresa tu contraseña. 5. **Instala XQuartz (si se requiere)** [https://www.xquartz.org/](https://www.xquartz.org/) 6. **Verifica la instalación** Busca R en la carpeta Applications. No es necesario abrirlo directamente. ## Linux 1. **Visita el sitio de R** [https://cloud.r-project.org/](https://cloud.r-project.org/) 2. **Haz clic en "Download R for Linux"** Elige tu distribución (Ubuntu, Debian, Fedora, etc.) 3. **Instala según tu sistema:** **Ubuntu/Debian:** ```bash sudo apt update sudo apt install r-base r-base-dev ``` **Fedora:** ```bash sudo dnf install R ``` 4. **Verifica instalación:** En la terminal escribe `R --version` y deberías ver la versión instalada. ::: #### Instalando RStudio Con R instalado, instala RStudio: ::: {.panel-tabset} ## Windows 1. **Visita** [https://posit.co/download/rstudio-desktop/](https://posit.co/download/rstudio-desktop/) 2. **Haz clic en el instalador para Windows** 3. **Ejecuta el archivo `.exe`** y sigue los pasos por defecto 4. **Abre RStudio** desde el escritorio o menú de inicio ## Mac 1. **Descarga el instalador para macOS** desde el mismo sitio 2. **Abre el archivo `.dmg`** y arrastra el ícono de RStudio a la carpeta **Applications** 3. **Abre RStudio** desde Applications ## Linux 1. Descarga el paquete `.deb` o `.rpm` correspondiente **Ubuntu/Debian:** ```bash sudo dpkg -i rstudio-2024.xx.x-amd64.deb sudo apt-get install -f ``` **Fedora/RedHat:** ```bash sudo dnf install rstudio-2024.xx.x-x86_64.rpm ``` 2. **Abre RStudio** desde el menú o ejecutando `rstudio` en la terminal. ::: #### Verificar Instalación 1. **Abre RStudio** (no R directamente). 2. **Deberías ver 4 paneles:** Console, Environment/History, Files/Plots/Help, Script Editor. 3. **Prueba escribiendo en la Console:** ```r 2 + 2 ``` Si obtienes `[1] 4`, ¡todo está listo! ::: {.callout-tip} ## Instalación Exitosa Si viste `[1] 4` en la consola, estás listo para comenzar. Problemas comunes: - **RStudio no abre**: instala R primero - **“R not found”**: reinstala R y reinicia RStudio - **Bloqueo en Mac**: Seguridad y Privacidad → “Open Anyway” ::: --- ### Paso 2: Descargar Materiales del Curso Visita la página [Teaching Materials](teaching_materials.qmd) para descargar: - Plantillas de ejercicios (.R) - Scripts con soluciones (.R) - Conjuntos de datos tributarios - Guías de referencia rápida --- ### Paso 3: Comienza a Aprender Haz clic en **"1. Introduction to R"** en la barra lateral izquierda para comenzar tu primer módulo. Avanza en orden: cada módulo se basa en los conceptos del anterior. --- ## ¿Listo para Comenzar? ::: {.callout-tip icon=false} ## 🚀 Comienza tu Camino en R Ya tienes R y RStudio instalados. Sabes dónde encontrar los materiales del curso. Ahora haz clic en **"1. Introduction to R"** para comenzar el Módulo 1. Recuerda: todo experto fue principiante alguna vez. Tómate tu tiempo, practica y experimenta. ::: --- <div style="text-align: center; margin-top: 2em; padding-top: 1em; border-top: 1px solid #ddd; color: #666; font-size: 0.9em;"> Desarrollado por **El Equipo DaTax del Banco Mundial** | [Ver en GitHub](https://github.com/rdoino-wb/datax_r) </div>