Help for package enaho

Type:

Package

Title:

Encuesta Nacional de Hogares (Peruvian Home National Survey)

Version:

0.2.5

Maintainer:

Andrés Christiansen <andres.christiansen@iea-hamburg.de>

Description:

Descarga, lee y analiza bases de la Encuesta Nacional de Hogares (ENAHO) y otras encuestas del Instituto Nacional de Estadística e Informática (INEI) del Perú. (Downloads, reads, and combines data from the Peruvian Home National Survey and other surveys from the National Institute for Statistics (INEI).)

License:

GPL-2 | GPL-3 [expanded from: GPL (≥ 2.0)]

Encoding:

UTF-8

Language:

RoxygenNote:

7.3.2

Depends:

R (≥ 3.5)

Imports:

haven, tibble, tidyselect

URL:

https://dopatendo.github.io/enaho/

Suggests:

knitr, rmarkdown

VignetteBuilder:

knitr

NeedsCompilation:

Packaged:

2025-09-29 07:23:24 UTC; andreschristiansen

Author:

Andrés Christiansen

[aut, cre]

Repository:

CRAN

Date/Publication:

2025-09-29 08:00:08 UTC

Combinar bases de la ENAHO

Description

Combina bases de la ENAHO descargadas con descargar.inei. y leídas con leer.inei.

Usage

combinar.inei(x, combinarsolocomunes = FALSE)

Arguments

x

una lista de bases leídas con leer.inei.

combinarsolocomunes

un valor lógico que indica si sólo deben combinarse las columnas comunes.

Value

un data frame.

Examples

directorio = system.file("extdata", package = "enaho")
leido <- leer.inei(modulo = 37, periodos = 2011, directorio = directorio, tipo = c("t1","t2"))
combinar.inei(leido)

Descargar

Description

Descarga datos disponibles del portal de Microdatos del INEI.

Usage

descargar.inei(
  encuesta = "ENAHO",
  modulo,
  periodos,
  dirdescarga = getwd(),
  tipo = "anual",
  ensilencio = FALSE
)

Arguments

encuesta

el nombre de una encuesta del INEI. Las opciones dispobibles son "ENAHO", "ENAHOpanel" y "ENDES". No importa si está escrito en mayúscula o minúscula.

modulo

el código del módulo deseado.

periodos

los años deseados.

dirdescarga

el directorio de descarga.

tipo

el tipo de período deseado. Las opciones son "anual", "t1" (primer trimestre), "t2" (segundo trimestre), "t3" (tercer trimestre), y "t4" (cuarto trimestre). Las opciones pueden combinarse.

ensilencio

un valor lógico que indica si el progreso de la función debe ser omitido.

Value

guarda los archivos descargados en el disco.

Examples

descargar.inei(modulo = 37, periodos = 2011, dirdescarga = tempdir(), tipo = "t1")

Leer bases de la ENAHO

Description

Lee bases de la ENAHO descargadas con descargar.inei. Si más de una base es leída, se carga una lista, cuyos elementos son cada una de las bases. En caso que el INEI provea más de una base por módulo y período se leerá la base con mayor peso.

Usage

leer.inei(
  encuesta = "ENAHO",
  modulo,
  periodos,
  directorio = getwd(),
  tipo = "anual",
  columnas = NULL,
  solocomunes = FALSE,
  ensilencio = FALSE,
  combinar = FALSE,
  combinarsolocomunes = FALSE
)

Arguments

encuesta

el nombre de una encuesta del INEI. Las opciones dispobibles son "ENAHO", "ENAHOpanel" y "ENDES". No importa si está escrito en mayúscula o minúscula.

modulo

el código del módulo deseado.

periodos

los años deseados.

directorio

el directorio de donde están las carpetas generadas por descargar.inei.

tipo

el tipo de período deseado. Las opciones son "anual", "t1" (primer trimestre), "t2" (segundo trimestre), "t3" (tercer trimestre), y "t4" (cuarto trimestre). Las opciones pueden combinarse.

columnas

una cadena de texto que indica qué columnas seleccionar.

solocomunes

un valor lógico que indica si sólo deben leerse las columnas comunes.

ensilencio

un valor lógico que indica si el progreso de la función debe ser omitido.

combinar

un valor lógico que indica si las bases deben ser combinadas en un único data frame.

combinarsolocomunes

un valor lógico que indica si sólo deben combinarse las columnas comunes.

Value

un data frame o una lista.

Examples

directorio = system.file("extdata", package = "enaho")
leer.inei(modulo = 37, periodos = 2011, directorio = directorio, tipo = "t1")

Leer bases de la ENAHO desde la web

Description

Lee bases de la ENAHO deste la web del INEI. Aplica las mismas reglas que leer.inei.

Usage

leer.inei.web(
  encuesta = "ENAHO",
  modulo,
  periodos,
  tipo = "anual",
  ensilencio = FALSE,
  combinar = FALSE,
  combinarsolocomunes = FALSE
)

Arguments

encuesta

el nombre de una encuesta del INEI. Las opciones dispobibles son "ENAHO", "ENAHOpanel" y "ENDES". No importa si está escrito en mayúscula o minúscula.

modulo

el código del módulo deseado.

periodos

los años deseados.

tipo

el tipo de período deseado. Las opciones son "anual", "t1" (primer trimestre), "t2" (segundo trimestre), "t3" (tercer trimestre), y "t4" (cuarto trimestre). Las opciones pueden combinarse.

ensilencio

un valor lógico que indica si el progreso de la función debe ser omitido.

combinar

un valor lógico que indica si las bases deben ser combinadas en un único data frame.

combinarsolocomunes

un valor lógico que indica si sólo deben combinarse las columnas comunes.

Value

un data frame o una lista.

Examples

leer.inei.web(modulo = 37, periodos = 2011, tipo = "t1")

Media

Description

Estima medias de variables en bases leídas con leer.inei o leer.inei.web.

Usage

media.inei(
  x,
  base,
  estratos = NULL,
  combinarestratos = FALSE,
  dividirperiodos = FALSE,
  ruralidad = 6:8,
  pesos = NULL,
  var = c("insesgado"),
  decimales = NULL
)

Arguments

x

una cadena de caracteres con los nombres de las variables a estimar.

base

una base leída con leer.inei o leer.inei.web en forma de tibble o en forma de lista.

estratos

una cadena de caracteres con los nombres de las variables que deben ser consideradas como estratos. Además se puede usar (sólo en las bases de la ENAHO) "area" y "region", con las que se calcularán los resultados para los estratos urbano y rural, y para cada región.

combinarestratos

un valor lógico que indica si debe calcularse también la combinación entre estratos. Por ejemplo, si los estatos son "area" y "region", se estimará también para cada área de cada región.

dividirperiodos

un valor lógico que indica si los resultados deben ser separados por período.

ruralidad

un vector numérico que indica que valores de la variable "ESTRATO" deben ser considerados rurales. Usualmente del 6 al 8.

pesos

una cadena de caracteres con el nombre de la(s) variable(s) que representan los pesos. Si es NULL las proporciones se estiman sin pesarlas.

var

una cadena de texto que indica el método a usar para la varianza: "insesgado" calcula la estimación insesgada (n-1); "MV" calcula la estimación de máxima verosimilitud.

decimales

un valor numérico que indica cuántos decimales se necesitan. Si es NULL no se redondea.

Value

un data frame o una lista.

Examples

directorio = system.file("extdata", package = "enaho")
leido <- leer.inei(modulo = 37, periodos = 2011, directorio = directorio, tipo = c("t1","t2"))
media.inei(x = c("P7061"),base = leido,pesos = "FACTRIM")

Módulos de una encuesta

Description

Muestra los módulos de una encuesta y en que año se encuentran disponibles.

Usage

modulos(encuesta = "ENAHO", modulo = NULL)

Arguments

encuesta

el nombre de una encuesta del INEI. Las opciones dispobibles son "ENAHO", "ENAHOpanel" y "ENDES". No importa si está escrito en mayúscula o minúscula.

modulo

el código de los módulos que mostrar. Si es NULL muestra todos los disponibles. Si no es NULL muestra los períodos disponibles.

Value

un data frame.

Examples

modulos()

Proporción

Description

Estima proporciones de variables en bases leídas con leer.inei o leer.inei.web.

Usage

proporcion.inei(
  x,
  base,
  estratos = NULL,
  combinarestratos = FALSE,
  dividirperiodos = FALSE,
  ruralidad = 6:8,
  pesos = NULL,
  forzaretiquetas = FALSE,
  porcentaje = FALSE,
  decimales = NULL,
  formatolargo = FALSE
)

Arguments

x

una cadena de caracteres con los nombres de las variables a estimar.

base

una base leída con leer.inei o leer.inei.web en forma de tibble o en forma de lista.

estratos

combinarestratos

un valor lógico que indica si debe calcularse también la combinación entre estratos. Por ejemplo, si los estatos son "area" y "region", se estimará también para cada área de cada región.

dividirperiodos

un valor lógico que indica si los resultados deben ser separados por período.

ruralidad

un vector numérico que indica que valores de la variable "ESTRATO" deben ser considerados rurales. Usualmente del 6 al 8.

pesos

una cadena de caracteres con el nombre de la(s) variable(s) que representan los pesos. Si es NULL las proporciones se estiman sin pesarlas.

forzaretiquetas

un valor lógico que indica si las etiquetas del período con más etiquetas deben ser forzadas para todos los períodos. No es poco común que las etiquetas de una variable cambien con los años, si esto ocurre, esta función las interpretará como distintas. Por ejemplo "INCIAL" y "EDUCACION INICIAL". Sin embargo, usando este argumento se puede forzar a que se interpreten los mismos valores todos los años. Usar con discreción, y, si es posible, siempre después de una exploración de datos usando forzaretiquetas = FALSE.

porcentaje

un valor lógico que indica si los resultados deben presentarse como porcentaje en vez de proporción.

decimales

un valor numérico que indica cuántos decimales se necesitan. Si es NULL no se redondea.

formatolargo

un valor lógico que indica si los resultados debes estar en formato largo. Si se incluye más de una variable, se darán los resultados en formato largo.

Value

un data frame o una lista.

Examples

directorio = system.file("extdata", package = "enaho")
leido <- leer.inei(modulo = 37, periodos = 2011, directorio = directorio, tipo = c("t1","t2"))
proporcion.inei(x = c("P7061"),base = leido,pesos = "FACTRIM")

Identificar variables

Description

Identifica las variables disponibles por periodo y tipo de bases de la ENAHO descargadas con descargar.inei.

Usage

variablesxperiodo(
  encuesta = "ENAHO",
  modulo,
  periodos,
  directorio = getwd(),
  tipo = "anual",
  ultimaetiqueta = TRUE,
  mostraretiqueta = FALSE
)

Arguments

encuesta

el nombre de una encuesta del INEI. Las opciones dispobibles son "ENAHO", "ENAHOpanel" y "ENDES". No importa si está escrito en mayúscula o minúscula.

modulo

el código del módulo deseado.

periodos

los años deseados.

directorio

el directorio de donde están las carpetas generadas por descargar.inei.

tipo

el tipo de período deseado. Las opciones son "anual", "t1" (primer trimestre), "t2" (segundo trimestre), "t3" (tercer trimestre), y "t4" (cuarto trimestre). Las opciones pueden combinarse.

ultimaetiqueta

un valor lógico que indica si debe usarse la última etiqueta. Dado que la etiqueta de las variables puede cambiar con los años, se puede elegir qué etiqueta usar, la del período más reciente que tiene esa variable ultimaetiqueta = TRUE o del primer período que tiene esa variable ultimaetiqueta = FALSE.

mostraretiqueta

un valor lógico que indica si deben mostrarse las etiquetas.

Value

un data frame donde 1 significa que la variable está disponible y 0 que no está disponible.

Examples

directorio = system.file("extdata", package = "enaho")
variablesxperiodo(modulo = 37, periodos = 2011, directorio = directorio, tipo = c("t1","t2"))