# ENAHODATA
Esta libreria consta de un comando para extraer datos de la Encuesta Nacional de Hogares (ENAHO) del Instituto Nacional de EstadÃstica e Informática (INEI) de Perú que se realiza cada año desde el 2004. Esta encuesta esta organizado por modulos.
> **Ficha técnica**: [Consulta aquÃ](https://proyectos.inei.gob.pe/iinei/srienaho/Descarga/FichaTecnica/498-Ficha.pdf)
Contenido
---------
- [Modulos de la encuesta (Corte transversal)](#corte-transversal)
- [Modulos de la encuesta (Datos de panel)](#datos-de-panel)
- [I. Instalación](#i-instalacion)
- [II. Descripción de la librerÃa](#ii-descripción-de-la-libreria)
- [III. Ejemplo](#iii-ejemplo-práctico)
- [IV. Como citar este repositorio](#iv-como-citar-este-repositorio)
- [Licencia](#licencia)
### Modulos de la Encuesta Nacional de Hogares (ENAHO)
Los modulos son los siguientes:
#### Corte transversal
Nro|Código Módulo|Modulo|Preguntas
:-------|:-------|:---------|:------
1|`01`|CaracterÃsticas de la Vivienda y del Hogar|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=01&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=CaracterÃsticas+de+la+Vivienda+y+del+Hogar" target="_blank">`Preguntas`</a>
2|`02`|CaracterÃsticas de los Miembros del Hogar|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=02&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=CaracterÃsticas+de+los+Miembros+del+Hogar" target="_blank">`Preguntas`</a>
3|`03`|Educación|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=03&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Educación" target="_blank">`Preguntas`</a>
4|`04`|Salud|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=04&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Salud" target="_blank">`Preguntas`</a>
5|`05`|Empleo e Ingresos|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=05&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Empleo+e+Ingresos" target="_blank">`Preguntas`</a>
6|`07`| Gastos en Alimentos y Bebidas (Módulo 601)|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=07&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Gastos+en+Alimentos+y+Bebidas+(Módulo+601)" target="_blank">`Preguntas`</a>
7|`08`|Instituciones Beneficas|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=08&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Instituciones+Beneficas" target="_blank">`Preguntas`</a>
8|`09`|Mantenimiento de la Vivienda|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=09&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Mantenimiento+de+la+Vivienda" target="_blank">`Preguntas`</a>
9|`10`|Transportes y Comunicaciones|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=10&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Transportes+y+Comunicaciones" target="_blank">`Preguntas`</a>
10|`11`|Servicios a la Vivienda|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=11&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Servicios+a+la+Vivienda" target="_blank">`Preguntas`</a>
11|`12`|Esparcimiento , Diversion y Servicios de Cultura|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=12&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Esparcimiento+,+Diversion+y+Servicios+de+Cultura" target="_blank">`Preguntas`</a>
12|`13`|Vestido y Calzado|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=13&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Vestido+y+Calzado" target="_blank">`Preguntas`</a>
13|`15`|Gastos de Transferencias|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=15&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Gastos+de+Transferencias" target="_blank">`Preguntas`</a>
14|`16`|Muebles y Enseres|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=16&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Muebles+y+Enseres" target="_blank">`Preguntas`</a>
15|`17`|Otros Bienes y Servicios|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=17&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Otros+Bienes+y+Servicios" target="_blank">`Preguntas`</a>
16|`18`|Equipamiento del Hogar|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=18&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Equipamiento+del+Hogar" target="_blank">`Preguntas`</a>
17|`22`|Producción AgrÃcola|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=22&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Producción+AgrÃcola" target="_blank">`Preguntas`</a>
18|`23`|Subproductos Agricolas|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=23&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Subproductos+Agricolas" target="_blank">`Preguntas`</a>
19|`24`|Producción Forestal|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=24&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Producción+Forestal" target="_blank">`Preguntas`</a>
20|`25`|Gastos en Actividades Agricolas y/o Forestales|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=25&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Gastos+en+Actividades+Agricolas+y/o+Forestales" target="_blank">`Preguntas`</a>
21|`26`|Producción Pecuaria|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=26&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Producción+Pecuaria" target="_blank">`Preguntas`</a>
22|`27`|Subproductos Pecuarios|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=27&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Subproductos+Pecuarios" target="_blank">`Preguntas`</a>
23|`28`|Gastos en Actividades Pecuarias|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=28&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Gastos+en+Actividades+Pecuarias" target="_blank">`Preguntas`</a>
24|`34`|Sumarias ( Variables Calculadas )|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=34&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Sumarias+(+Variables+Calculadas+)" target="_blank">`Preguntas`</a>
25|`37`|Programas Sociales (Miembros del Hogar)|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=37&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Programas+Sociales++(Miembros+del+Hogar)" target="_blank">`Preguntas`</a>
26|`77`|Ingresos del Trabajador Independiente|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=77&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Ingresos+del+Trabajador+Independiente" target="_blank">`Preguntas`</a>
27|`78`|Bienes y Servicios de Cuidados Personales|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=78&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Bienes+y+Servicios+de+Cuidados+Personales" target="_blank">`Preguntas`</a>
28|`84`|Participación Ciudadana|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=84&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Participación+Ciudadana" target="_blank">`Preguntas`</a>
29|`85`|Gobernabilidad, Democracia y Transparencia|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=85&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Gobernabilidad,+Democracia+y+Transparencia" target="_blank">`Preguntas`</a>
30|`1825`|Beneficiarios de Instituciones sin fines de lucro: Olla comun|<a href="https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=1825&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Beneficiarios+de+Instituciones+sin+fines+de+lucro:+Olla+Común" target="_blank">`Preguntas`</a>
#### Datos de panel
Nro|Año|Código Módulo|Modulo
:-------|:-------|:-------|:---------
1|2023-2018|`1474`|CaracterÃsticas de la Vivienda y del Hogar
2|2023-2018|`1475`|Educación
3|2023-2018|`1476`|Salud
4|2023-2018|`1477`|Empleo e Ingresos
5|2023-2018|`1478`|Sumarias ( Variables Calculadas )
6|2023-2018|`1479`|CaracterÃsticas de los Miembros del Hogar
7|2017-2011|`01`|CaracterÃsticas de la Vivienda y del Hogar
8|2017-2011|`03`|Educación
9|2017-2011|`04`|Salud
10|2017-2011|`05`|Empleo e Ingresos
11|2017-2011|`34`|Sumarias( Variables calculadas )
12|2017-2011|`1314`|CaracterÃsticas de los Miembros del Hogar
## I. Instalacion
#### Requerimientos
Para el correcto funcionamiento del paquete y sus respectivos modulos, es necesario tener instalado los siguientes paquetes adicionales:
- requests
- tqdm
#### Iniciamos la instalacion
```python
pip install enahodata
```
## II. Descripción de la libreria
#### 1.- Importamos la libreria
```python
from enahodata import enahodata
import os
```
- En esta etapa importamos las librerias que se usaran, **enahodata** para extraer el comando **enahodata**.
- También importamos **os** para manejar las carpetas.
#### 2.- Definimos el directorio de trabajo
```python
os.chdir("/path/to/your/directory")
```
- Usamos este código para definir el directorio de trabajo donde se trabajará.
#### 3.- Definimos los paramétros del comando **_enahodata_**
El comando es enahodata, y tiene los siguientes parametros:
```python
enahodata(
modulos: list[str]=["", "", "", ...],
anios: list[str]=["", "", "", ...],
descomprimir: bool = False,
only_dta: bool = False
overwrite: bool = False,
output_dir: str = "NOMBRE_CARPETA",
panel: bool = True or False
)
```
- **modulos:** en este parámetro ponemos la lista de modulos que se quiere descargar. Se puede extraer el codigo de la columna _Código Módulo_.
```python
enahodata(
modulos = ["01", "02", "03",...],
...
)
```
- **anios:** en este parámetro se pone la lista de años.
```python
enahodata(
...
anios = ["2020", "2021", "2022",...]
...
)
```
- **descomprimir:** con esta opción se selecciona _True_ o _False_ para que se descomprima o no, respectivamente.
```python
enahodata(
...
descomprimir:bool = ...,
...
)
```
- **only_data:** con este parametro del comando seleccionamos si se enfocara solo en los archivos _.dta_ o no. Tiene dos valores _True_ o _False_.
```python
enahodata(
...
only_dta: bool = ...,
...
)
```
- **overwrite:** con esta opción se indica si se reemplaza los archivos ya existentes o no. Tiene dos valores _True_ o _False_.
```python
enahodata(
...
overwrite: bool = ...,
...
)
```
- **output_dir:** con este parámetro se indica el nombre que tendra la carpeta donde se almacenaran los archivos de los modulos descargados de la ENAHO.
```python
enahodata(
...
output_dir: str = "NOMBRE_CARPETA",
)
```
- **panel:** con este parámetro se indica si se descargará los datasets de corte transversal o los de panel data. Tiene dos valores _True_ (datos de panel) y _False_ (corte transversal).
```python
enahodata(
...
panel: bool = ...,
)
```
#### 4.- Plantilla completa
```python
from enahodata import enahodata
import os
os.chdir("/path/to/your/directory")
enahodata(
modulos = ["01", "02", "03",...],,
anios = list[str],
descomprimir = ...,
only_dta = ...,
overwrite = ...,
output_dir = "NOMBRE_CARPETA",
panel = ...,
)
```
## III. Ejemplo práctico
Se necesita descargar de los años 2022 y 2023, los siguientes módulos de la Encuesta Nacional de Hogares de Perú:
- CaracterÃsticas de la Vivienda y del Hogar
- Educación
- Salud
Entonces, con la información anterior revisamos el codigo de cada modulo. En este caso los codigos son los siguientes:
- `01` : CaracterÃsticas de la vivienda y del hogar
- `03` : Educación
- `04` : Salud
Luego, realizamos lo siguiente:
```python
pip install enahodata
```
En otro archivo `ejemplo.py`, por ejemplo escribimos el siguiente código:
```python
from enahodata import enahodata
import os
os.chdir("C:\Users\Usuario\Desktop\ejemplo")
enahodata(
modulos=["01","03","04"],
anios=["2022", "2023"],
descomprimir=True,
only_dta=True,
overwrite=True,
output_dir="datos_ENAHO",
panel=False
)
```
Ejecutamos el codigo:
```python
python ejemplo.py
```
Y se creara la siguiente estructura de carpetas, como resultado:
<img src="./img/tree.PNG" width="210" height="">
Donde:
- **/modulo_01_2022_dta_only**
- **/modulo_01_2023_dta_only**
- **/modulo_03_2022_dta_only**
- **/modulo_03_2023_dta_only**
- **/modulo_04_2022_dta_only**
- **/modulo_04_2023_dta_only**
>Son las carpetas donde se encuentran los dataset en formato `.dta`
- **/modulo_01_2022_extract**
- **/modulo_01_2023_extract**
- **/modulo_03_2022_extract**
- **/modulo_03_2023_extract**
- **/modulo_04_2022_extract**
- **/modulo_04_2023_extract**
>En estas carpetas se encuentran, la información descomprimida de la ENAHO, con toda la información que viene desde el portal de microdatos del INEI.
### Nota
- Cuando se active la opción `panel=True`, tener en cuenta que los datasets tienen un peso considerable. El proceso sera el mismo, la diferencia se encuentra en el tamaño de los archivos que se descarán.
- Otro aspecto a tener en cuenta, los códigos a usar para la función debe ser los que pertenecen a la tabla de datos de panel, considerando el periodo de tiempo que son vigentes los codigos a usar.
## IV. Como citar este repositorio
```plaintext
Medrano M. & Palomino J. (2025). ENAHODATA (versión Python) [Software]. GitHub. (https://github.com/MaykolMedrano/enahodata_py)
```
## Licencia
Este repositorio esta autorizado bajo la licencia MIT. Ver <a href="./LICENSE">LICENCIA</a> para mas detalles.
Raw data
{
"_id": null,
"home_page": "https://github.com/MaykolMedrano/enahodata2",
"name": "enahodata",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Per\u00fa, Peru, inei, enaho, microdatos",
"author": "Maykol Medrano Cahuana & Jelsin Stalin Palomino Huaytapuma",
"author_email": "maykolmedrano35@gmail.com & jstpalomino@hotmail.com",
"download_url": null,
"platform": null,
"description": "# ENAHODATA\r\nEsta libreria consta de un comando para extraer datos de la Encuesta Nacional de Hogares (ENAHO) del Instituto Nacional de Estad\u00c3\u00adstica e Inform\u00c3\u00a1tica (INEI) de Per\u00c3\u00ba que se realiza cada a\u00c3\u00b1o desde el 2004. Esta encuesta esta organizado por modulos.\r\n\r\n> **Ficha t\u00c3\u00a9cnica**: [Consulta aqu\u00c3\u00ad](https://proyectos.inei.gob.pe/iinei/srienaho/Descarga/FichaTecnica/498-Ficha.pdf)\r\n\r\nContenido\r\n---------\r\n\r\n- [Modulos de la encuesta (Corte transversal)](#corte-transversal)\r\n- [Modulos de la encuesta (Datos de panel)](#datos-de-panel)\r\n- [I. Instalaci\u00c3\u00b3n](#i-instalacion)\r\n- [II. Descripci\u00c3\u00b3n de la librer\u00c3\u00ada](#ii-descripci\u00c3\u00b3n-de-la-libreria)\r\n- [III. Ejemplo](#iii-ejemplo-pr\u00c3\u00a1ctico)\r\n- [IV. Como citar este repositorio](#iv-como-citar-este-repositorio)\r\n- [Licencia](#licencia)\r\n\r\n### Modulos de la Encuesta Nacional de Hogares (ENAHO)\r\n\r\nLos modulos son los siguientes:\r\n\r\n#### Corte transversal\r\n\r\nNro|C\u00c3\u00b3digo M\u00c3\u00b3dulo|Modulo|Preguntas\r\n:-------|:-------|:---------|:------\r\n1|`01`|Caracter\u00c3\u00adsticas de la Vivienda y del Hogar|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=01&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Caracter\u00c3\u00adsticas+de+la+Vivienda+y+del+Hogar\" target=\"_blank\">`Preguntas`</a>\r\n2|`02`|Caracter\u00c3\u00adsticas de los Miembros del Hogar|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=02&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Caracter\u00c3\u00adsticas+de+los+Miembros+del+Hogar\" target=\"_blank\">`Preguntas`</a>\r\n3|`03`|Educaci\u00c3\u00b3n|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=03&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Educaci\u00c3\u00b3n\" target=\"_blank\">`Preguntas`</a>\r\n4|`04`|Salud|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=04&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Salud\" target=\"_blank\">`Preguntas`</a>\r\n5|`05`|Empleo e Ingresos|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=05&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Empleo+e+Ingresos\" target=\"_blank\">`Preguntas`</a>\r\n6|`07`|\tGastos en Alimentos y Bebidas (M\u00c3\u00b3dulo 601)|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=07&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Gastos+en+Alimentos+y+Bebidas+(M\u00c3\u00b3dulo+601)\" target=\"_blank\">`Preguntas`</a>\r\n7|`08`|Instituciones Beneficas|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=08&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Instituciones+Beneficas\" target=\"_blank\">`Preguntas`</a>\r\n8|`09`|Mantenimiento de la Vivienda|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=09&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Mantenimiento+de+la+Vivienda\" target=\"_blank\">`Preguntas`</a>\r\n9|`10`|Transportes y Comunicaciones|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=10&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Transportes+y+Comunicaciones\" target=\"_blank\">`Preguntas`</a>\r\n10|`11`|Servicios a la Vivienda|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=11&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Servicios+a+la+Vivienda\" target=\"_blank\">`Preguntas`</a>\r\n11|`12`|Esparcimiento , Diversion y Servicios de Cultura|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=12&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Esparcimiento+,+Diversion+y+Servicios+de+Cultura\" target=\"_blank\">`Preguntas`</a>\r\n12|`13`|Vestido y Calzado|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=13&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Vestido+y+Calzado\" target=\"_blank\">`Preguntas`</a>\r\n13|`15`|Gastos de Transferencias|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=15&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Gastos+de+Transferencias\" target=\"_blank\">`Preguntas`</a>\r\n14|`16`|Muebles y Enseres|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=16&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Muebles+y+Enseres\" target=\"_blank\">`Preguntas`</a>\r\n15|`17`|Otros Bienes y Servicios|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=17&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Otros+Bienes+y+Servicios\" target=\"_blank\">`Preguntas`</a>\r\n16|`18`|Equipamiento del Hogar|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=18&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Equipamiento+del+Hogar\" target=\"_blank\">`Preguntas`</a>\r\n17|`22`|Producci\u00c3\u00b3n Agr\u00c3\u00adcola|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=22&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Producci\u00c3\u00b3n+Agr\u00c3\u00adcola\" target=\"_blank\">`Preguntas`</a>\r\n18|`23`|Subproductos Agricolas|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=23&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Subproductos+Agricolas\" target=\"_blank\">`Preguntas`</a>\r\n19|`24`|Producci\u00c3\u00b3n Forestal|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=24&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Producci\u00c3\u00b3n+Forestal\" target=\"_blank\">`Preguntas`</a>\r\n20|`25`|Gastos en Actividades Agricolas y/o Forestales|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=25&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Gastos+en+Actividades+Agricolas+y/o+Forestales\" target=\"_blank\">`Preguntas`</a>\r\n21|`26`|Producci\u00c3\u00b3n Pecuaria|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=26&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Producci\u00c3\u00b3n+Pecuaria\" target=\"_blank\">`Preguntas`</a>\r\n22|`27`|Subproductos Pecuarios|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=27&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Subproductos+Pecuarios\" target=\"_blank\">`Preguntas`</a>\r\n23|`28`|Gastos en Actividades Pecuarias|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=28&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Gastos+en+Actividades+Pecuarias\" target=\"_blank\">`Preguntas`</a>\r\n24|`34`|Sumarias ( Variables Calculadas )|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=34&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Sumarias+(+Variables+Calculadas+)\" target=\"_blank\">`Preguntas`</a>\r\n25|`37`|Programas Sociales (Miembros del Hogar)|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=37&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Programas+Sociales++(Miembros+del+Hogar)\" target=\"_blank\">`Preguntas`</a>\r\n26|`77`|Ingresos del Trabajador Independiente|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=77&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Ingresos+del+Trabajador+Independiente\" target=\"_blank\">`Preguntas`</a>\r\n27|`78`|Bienes y Servicios de Cuidados Personales|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=78&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Bienes+y+Servicios+de+Cuidados+Personales\" target=\"_blank\">`Preguntas`</a>\r\n28|`84`|Participaci\u00c3\u00b3n Ciudadana|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=84&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Participaci\u00c3\u00b3n+Ciudadana\" target=\"_blank\">`Preguntas`</a>\r\n29|`85`|Gobernabilidad, Democracia y Transparencia|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=85&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Gobernabilidad,+Democracia+y+Transparencia\" target=\"_blank\">`Preguntas`</a>\r\n30|`1825`|Beneficiarios de Instituciones sin fines de lucro: Olla comun|<a href=\"https://proyectos.inei.gob.pe/microdatos/Detalle_Encuesta.asp?CU=19558&CodEncuesta=906&CodModulo=1825&NombreEncuesta=Condiciones+de+Vida+y+Pobreza+-+ENAHO&NombreModulo=Beneficiarios+de+Instituciones+sin+fines+de+lucro:+Olla+Com\u00c3\u00ban\" target=\"_blank\">`Preguntas`</a>\r\n\r\n#### Datos de panel\r\n\r\nNro|A\u00c3\u00b1o|C\u00c3\u00b3digo M\u00c3\u00b3dulo|Modulo\r\n:-------|:-------|:-------|:---------\r\n1|2023-2018|`1474`|Caracter\u00c3\u00adsticas de la Vivienda y del Hogar\r\n2|2023-2018|`1475`|Educaci\u00c3\u00b3n\r\n3|2023-2018|`1476`|Salud\r\n4|2023-2018|`1477`|Empleo e Ingresos\r\n5|2023-2018|`1478`|Sumarias ( Variables Calculadas )\r\n6|2023-2018|`1479`|Caracter\u00c3\u00adsticas de los Miembros del Hogar\r\n7|2017-2011|`01`|Caracter\u00c3\u00adsticas de la Vivienda y del Hogar\t\r\n8|2017-2011|`03`|Educaci\u00c3\u00b3n\r\n9|2017-2011|`04`|Salud\r\n10|2017-2011|`05`|Empleo e Ingresos\r\n11|2017-2011|`34`|Sumarias( Variables calculadas )\r\n12|2017-2011|`1314`|Caracter\u00c3\u00adsticas de los Miembros del Hogar\r\n## I. Instalacion\r\n\r\n#### Requerimientos\r\nPara el correcto funcionamiento del paquete y sus respectivos modulos, es necesario tener instalado los siguientes paquetes adicionales:\r\n\r\n- requests\r\n- tqdm\r\n\r\n#### Iniciamos la instalacion\r\n```python\r\npip install enahodata\r\n```\r\n\r\n## II. Descripci\u00c3\u00b3n de la libreria \r\n\r\n#### 1.- Importamos la libreria\r\n\r\n```python\r\nfrom enahodata import enahodata \r\nimport os\r\n```\r\n\r\n- En esta etapa importamos las librerias que se usaran, **enahodata** para extraer el comando **enahodata**.\r\n- Tambi\u00c3\u00a9n importamos **os** para manejar las carpetas.\r\n\r\n#### 2.- Definimos el directorio de trabajo\r\n```python\r\nos.chdir(\"/path/to/your/directory\")\r\n```\r\n- Usamos este c\u00c3\u00b3digo para definir el directorio de trabajo donde se trabajar\u00c3\u00a1.\r\n\r\n#### 3.- Definimos los param\u00c3\u00a9tros del comando **_enahodata_**\r\nEl comando es enahodata, y tiene los siguientes parametros:\r\n```python\r\nenahodata(\r\n modulos: list[str]=[\"\", \"\", \"\", ...],\r\n anios: list[str]=[\"\", \"\", \"\", ...],\r\n descomprimir: bool = False,\r\n only_dta: bool = False\r\n overwrite: bool = False,\r\n output_dir: str = \"NOMBRE_CARPETA\", \r\n panel: bool = True or False\r\n)\r\n```\r\n- **modulos:** en este par\u00c3\u00a1metro ponemos la lista de modulos que se quiere descargar. Se puede extraer el codigo de la columna _C\u00c3\u00b3digo M\u00c3\u00b3dulo_.\r\n```python\r\nenahodata(\r\n modulos = [\"01\", \"02\", \"03\",...],\r\n ... \r\n)\r\n```\r\n\r\n- **anios:** en este par\u00c3\u00a1metro se pone la lista de a\u00c3\u00b1os.\r\n```python\r\nenahodata(\r\n ...\r\n anios = [\"2020\", \"2021\", \"2022\",...]\r\n ...\r\n)\r\n```\r\n- **descomprimir:** con esta opci\u00c3\u00b3n se selecciona _True_ o _False_ para que se descomprima o no, respectivamente.\r\n```python\r\nenahodata(\r\n ...\r\n descomprimir:bool = ...,\r\n ...\r\n)\r\n```\r\n- **only_data:** con este parametro del comando seleccionamos si se enfocara solo en los archivos _.dta_ o no. Tiene dos valores _True_ o _False_.\r\n```python\r\nenahodata(\r\n ...\r\n only_dta: bool = ...,\r\n ...\r\n)\r\n```\r\n- **overwrite:** con esta opci\u00c3\u00b3n se indica si se reemplaza los archivos ya existentes o no. Tiene dos valores _True_ o _False_.\r\n```python\r\nenahodata(\r\n ...\r\n overwrite: bool = ...,\r\n ...\r\n)\r\n```\r\n- **output_dir:** con este par\u00c3\u00a1metro se indica el nombre que tendra la carpeta donde se almacenaran los archivos de los modulos descargados de la ENAHO. \r\n```python\r\nenahodata(\r\n ...\r\n output_dir: str = \"NOMBRE_CARPETA\", \r\n)\r\n```\r\n\r\n- **panel:** con este par\u00c3\u00a1metro se indica si se descargar\u00c3\u00a1 los datasets de corte transversal o los de panel data. Tiene dos valores _True_ (datos de panel) y _False_ (corte transversal). \r\n```python\r\nenahodata(\r\n ...\r\n panel: bool = ..., \r\n)\r\n```\r\n\r\n\r\n#### 4.- Plantilla completa\r\n\r\n```python\r\nfrom enahodata import enahodata \r\nimport os\r\n\r\nos.chdir(\"/path/to/your/directory\")\r\n\r\nenahodata(\r\n modulos = [\"01\", \"02\", \"03\",...],,\r\n anios = list[str],\r\n descomprimir = ...,\r\n only_dta = ...,\r\n overwrite = ...,\r\n output_dir = \"NOMBRE_CARPETA\", \r\n panel = ...,\r\n)\r\n\r\n```\r\n\r\n## III. Ejemplo pr\u00c3\u00a1ctico\r\n\r\nSe necesita descargar de los a\u00c3\u00b1os 2022 y 2023, los siguientes m\u00c3\u00b3dulos de la Encuesta Nacional de Hogares de Per\u00c3\u00ba:\r\n- Caracter\u00c3\u00adsticas de la Vivienda y del Hogar\r\n- Educaci\u00c3\u00b3n \r\n- Salud\r\n\r\nEntonces, con la informaci\u00c3\u00b3n anterior revisamos el codigo de cada modulo. En este caso los codigos son los siguientes:\r\n- `01` : Caracter\u00c3\u00adsticas de la vivienda y del hogar\r\n- `03` : Educaci\u00c3\u00b3n\r\n- `04` : Salud\r\n\r\nLuego, realizamos lo siguiente:\r\n```python\r\npip install enahodata\r\n```\r\nEn otro archivo `ejemplo.py`, por ejemplo escribimos el siguiente c\u00c3\u00b3digo:\r\n```python\r\nfrom enahodata import enahodata\r\nimport os\r\n\r\nos.chdir(\"C:\\Users\\Usuario\\Desktop\\ejemplo\")\r\n\r\nenahodata(\r\n modulos=[\"01\",\"03\",\"04\"],\r\n anios=[\"2022\", \"2023\"],\r\n descomprimir=True,\r\n only_dta=True,\r\n overwrite=True, \r\n output_dir=\"datos_ENAHO\",\r\n panel=False \r\n)\r\n\r\n```\r\nEjecutamos el codigo:\r\n```python\r\npython ejemplo.py\r\n```\r\n\r\n\r\nY se creara la siguiente estructura de carpetas, como resultado:\r\n\r\n<img src=\"./img/tree.PNG\" width=\"210\" height=\"\">\r\n\r\nDonde:\r\n- **/modulo_01_2022_dta_only** \r\n- **/modulo_01_2023_dta_only** \r\n- **/modulo_03_2022_dta_only** \r\n- **/modulo_03_2023_dta_only** \r\n- **/modulo_04_2022_dta_only** \r\n- **/modulo_04_2023_dta_only** \r\n>Son las carpetas donde se encuentran los dataset en formato `.dta`\r\n\r\n- **/modulo_01_2022_extract** \r\n- **/modulo_01_2023_extract** \r\n- **/modulo_03_2022_extract** \r\n- **/modulo_03_2023_extract** \r\n- **/modulo_04_2022_extract** \r\n- **/modulo_04_2023_extract** \r\n\r\n>En estas carpetas se encuentran, la informaci\u00c3\u00b3n descomprimida de la ENAHO, con toda la informaci\u00c3\u00b3n que viene desde el portal de microdatos del INEI.\r\n\r\n### Nota\r\n- Cuando se active la opci\u00c3\u00b3n `panel=True`, tener en cuenta que los datasets tienen un peso considerable. El proceso sera el mismo, la diferencia se encuentra en el tama\u00c3\u00b1o de los archivos que se descar\u00c3\u00a1n.\r\n- Otro aspecto a tener en cuenta, los c\u00c3\u00b3digos a usar para la funci\u00c3\u00b3n debe ser los que pertenecen a la tabla de datos de panel, considerando el periodo de tiempo que son vigentes los codigos a usar.\r\n\r\n## IV. Como citar este repositorio\r\n```plaintext\r\nMedrano M. & Palomino J. (2025). ENAHODATA (versi\u00c3\u00b3n Python) [Software]. GitHub. (https://github.com/MaykolMedrano/enahodata_py)\r\n```\r\n\r\n## Licencia\r\n\r\nEste repositorio esta autorizado bajo la licencia MIT. Ver <a href=\"./LICENSE\">LICENCIA</a> para mas detalles.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Library that automates the download of the modules of the National Household Survey (ENAHO in spanish) conducted by the National Institute of Statistics and Informatics of Peru each year.",
"version": "0.0.3",
"project_urls": {
"Homepage": "https://github.com/MaykolMedrano/enahodata2"
},
"split_keywords": [
"per\u00fa",
" peru",
" inei",
" enaho",
" microdatos"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "20b19d3f8dea35f023d269abda9eee373cb132290762f6a629ca36a7f0f2a589",
"md5": "0a5d7317bbe3e7be97f4c3e6e3a3f626",
"sha256": "522b3746b1be3702792b42490080bd2975042acce32b7690357c3195ca7f06c9"
},
"downloads": -1,
"filename": "enahodata-0.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0a5d7317bbe3e7be97f4c3e6e3a3f626",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9759,
"upload_time": "2025-01-23T03:43:45",
"upload_time_iso_8601": "2025-01-23T03:43:45.406808Z",
"url": "https://files.pythonhosted.org/packages/20/b1/9d3f8dea35f023d269abda9eee373cb132290762f6a629ca36a7f0f2a589/enahodata-0.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-23 03:43:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MaykolMedrano",
"github_project": "enahodata2",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "certifi",
"specs": [
[
"==",
"2024.12.14"
]
]
},
{
"name": "charset-normalizer",
"specs": [
[
"==",
"3.4.1"
]
]
},
{
"name": "colorama",
"specs": [
[
"==",
"0.4.6"
]
]
},
{
"name": "idna",
"specs": [
[
"==",
"3.10"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.32.3"
]
]
},
{
"name": "tqdm",
"specs": [
[
"==",
"4.67.1"
]
]
},
{
"name": "urllib3",
"specs": [
[
"==",
"2.3.0"
]
]
}
],
"lcname": "enahodata"
}
JSON
