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í

Contenido

• Modulos de la encuesta (Corte transversal)
• Modulos de la encuesta (Datos de panel)
• I. Instalación
• II. Descripción de la librería
• III. Ejemplo
• IV. Como citar este repositorio
• Licencia

Modulos de la Encuesta Nacional de Hogares (ENAHO)

Los modulos son los siguientes:

Corte transversal

Datos de panel

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

pip install enahodata

II. Descripción de la libreria

1.- Importamos la libreria

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

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:

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.

enahodata(
    modulos = ["01", "02", "03",...],
    ... 
)

• anios: en este parámetro se pone la lista de años.

enahodata(
    ...
    anios = ["2020", "2021", "2022",...]
    ...
)

• descomprimir: con esta opción se selecciona True o False para que se descomprima o no, respectivamente.

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.

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.

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.

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

enahodata(
    ...
    panel: bool = ...,   
)

4.- Plantilla completa

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:

pip install enahodata

En otro archivo ejemplo.py, por ejemplo escribimos el siguiente código:

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 ejemplo.py

Y se creara la siguiente estructura de carpetas, como resultado:

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

Medrano, M., & Palomino, J. (2025). ENAHODATA (versión 0.0.3) [Software]. Zenodo. https://doi.org/10.5281/zenodo.15029826

Licencia

Este repositorio esta autorizado bajo la licencia MIT. Ver LICENCIA para mas detalles.