Cobertura de esquema completo
Indicador UD 2.4
OPS/CIM
11 de abril de 2025
Source:vignettes/articles/es/complete_schedule_es.Rmd
complete_schedule_es.RmdFundamento
El propósito de este análisis es evaluar si la población objetivo recibió todas las vacunas que le corresponden según el esquema de vacunación definido por el país para una ubicación, cohorte y edad específicas.
Imagine la República de “ImmunoNation”. En ese país, el esquema completo de vacunación para un niño podría incluir lo siguiente:
- Al nacer: 1 dosis de la vacuna BCG (que protege contra la tuberculosis).
- Durante los primeros 11 meses: 3 dosis de una vacuna que contiene DTP (esta vacuna combinada protege contra difteria, tétanos y tos ferina).
- A los 12 meses: 1 dosis de la vacuna SRP (que protege contra sarampión, rubéola y paperas).
- En algún momento de la infancia: 1 dosis de la vacuna contra la fiebre amarilla.
Este es solo un ejemplo de cómo podría ser un esquema completo de vacunación. Cada país define las vacunas y el número de dosis necesarias para proteger a su población frente a distintas enfermedades.
Para construir este indicador, se evalúa si cada persona recibió todas las dosis incluidas en el esquema.
Nota
Todas las funciones utilizadas para los análisis de cobertura de esquema completo dentro de immunABC comienzan con el prefijo
cs_.
Glosario
Divisiones político-geográficas
A lo largo de esta viñeta se hace referencia a distintos niveles de división político-geográfica. Estos niveles son definidos por cada país o territorio y pueden recibir nombres diferentes. immunABC no depende de esos nombres locales; por eso, el usuario debe recodificar sus variables para ajustarlas a la estructura que utiliza el paquete.
En concreto, immunABC puede distinguir tres niveles administrativos que, listados del nivel superior al inferior, son: ADM0, ADM1 y ADM2.
- ADM0: El país. Este es el nivel administrativo más alto.
- ADM1: La primera subdivisión geográfica del país. ADM0 contiene varias subdivisiones ADM1.
- ADM2: La segunda subdivisión geográfica del país. Cada ADM1 contiene varias subdivisiones ADM2.
Nombres de vacunas
Los conjuntos de datos de ejemplo utilizan una convención específica para nombrar las dosis de vacunas. Es posible que esta convención no coincida con la que usa su país o institución, pero esto no afecta el uso del paquete si los nombres se aplican de manera consistente.
Por ejemplo, los nombres de las vacunas utilizados en el paquete immunABC son:
| Abreviatura | Nombre completo |
|---|---|
| SRP1 | Vacuna contra sarampión, rubéola y paperas (1.ª dosis) |
| DTP1 | Vacuna contra difteria, tétanos y tos ferina (1.ª dosis) |
| DTP2 | Vacuna contra difteria, tétanos y tos ferina (2.ª dosis) |
| DTP3 | Vacuna contra difteria, tétanos y tos ferina (3.ª dosis) |
| BCG RN | Vacuna Bacillus Calmette–Guérin (al nacer) |
| YFV1 | Vacuna contra la fiebre amarilla (1.ª dosis) |
Uso
Instalar el paquete
El primer paso para ejecutar los análisis de cobertura de esquema completo es instalar el paquete immunABC disponible en GitHub.
devtools::install_github("IM-Data-PAHO/immunabc")Cargar los datos
Las funciones de este módulo requieren tres conjuntos de datos en un formato específico.
- Su RNVe.
- El esquema de vacunación relacionado con este RNVe.
- Una tabla con denominadores poblacionales según el nivel geográfico
de su análisis.
- Esto es opcional para la función
cs_coverage()(pero no se muestra en esta viñeta).
- Esto es opcional para la función
Para facilitar la prueba de immunABC y la comprensión de la estructura requerida, a continuación se presentan los conjuntos de datos de ejemplo que utiliza este módulo.
RNVe
El conjunto de datos immunabc::immunABC.EIR proporciona
un ejemplo de Registro Nominal de Vacunación electrónico (RNVe). Es una
tabla nominal simulada con eventos individuales de vacunación. Cada fila
corresponde a una vacunación e incluye información sobre la residencia
de la persona, el lugar donde fue vacunada (ocurrencia), su fecha de
nacimiento y la dosis recibida.
immunABC.EIR %>% head() %>% kable(caption = "Ejemplo de Registro Nominal de Vacunación electrónico")| ID | date_birth | date_vax | ADM1_residence | ADM2_residence | ADM1_occurrence | ADM2_occurrence | dose |
|---|---|---|---|---|---|---|---|
| 191997 | 2023-08-08 | 2023-12-26 | ADM1_4 | ADM2_4_35 | ADM1_4 | ADM2_4_35 | DTP2 |
| 212189 | 2023-12-20 | 2023-12-26 | ADM1_5 | ADM2_5_61 | ADM1_5 | ADM2_5_61 | BCG RN |
| 118063 | 2022-09-15 | 2023-12-26 | ADM1_2 | ADM2_2_5 | ADM1_2 | ADM2_2_5 | DTP1 |
| 118063 | 2022-09-15 | 2023-12-26 | ADM1_2 | ADM2_2_5 | ADM1_2 | ADM2_2_5 | YFV1 |
| 130751 | 2022-10-27 | 2023-12-12 | ADM1_5 | ADM2_5_55 | ADM1_5 | ADM2_5_55 | YFV1 |
| 136532 | 2021-09-21 | 2023-12-26 | ADM1_3 | ADM2_3_12 | ADM1_3 | ADM2_3_12 | SRP1 |
-
ID: Número único de identificación de la persona. - Fecha de nacimiento (
date_birth): Fecha de nacimiento de la persona. - Fecha de vacunación (
date_vax): Fecha del evento de vacunación. - ADM1: Primer nivel administrativo geográfico del país.
- ADM2: Segundo nivel administrativo geográfico del país.
- Lugar de residencia (
Residence): Lugar donde vive la persona. - Lugar de vacunación (
Occurrence): Lugar donde ocurrió la vacunación. - Dosis (
dose): Variable combinada que representa el tipo de vacuna y su número de dosis correspondiente. Por ejemplo, DTP1 se refiere a la primera dosis de una vacuna que contiene componentes de difteria, tétanos y tos ferina.
Esquema de vacunación
El conjunto de datos immunabc::immunABC.schedule define
el esquema nacional de vacunación, con cada dosis y su edad recomendada
de administración (en días). Esta tabla permite determinar si una
persona tiene las vacunas que le corresponden según el esquema.
immunABC.schedule %>% kable(caption = "Ejemplo de esquema de vacunación")| dose | age_schedule | age_schedule_low | age_schedule_high |
|---|---|---|---|
| SRP1 | 365 | 360 | 420 |
| DTP1 | 60 | 54 | 90 |
| DTP2 | 120 | 116 | 150 |
| DTP3 | 180 | 176 | 210 |
| BCG RN | 0 | 0 | 28 |
| YFV1 | 365 | 360 | 420 |
- Dosis (
dose): Variable combinada que representa el tipo de vacuna y su número de dosis correspondiente. Por ejemplo, DTP1 se refiere a la primera dosis de una vacuna que contiene componentes de difteria, tétanos y tos ferina. - Edad programada (
age_schedule): Edad recomendada de administración de la dosis, en días. - Límite inferior de edad (
age_schedule_low): Límite inferior de la edad objetivo, en días. - Límite superior de edad (
age_schedule_high): Límite superior de la edad objetivo, en días.
Nota
Los nombres de las dosis en la columna
dosedeben coincidir exactamente con los del conjunto de datosimmunABC.EIR.
Denominadores poblacionales
Este módulo requiere una tabla con denominadores poblacionales. El nivel geográfico de esta tabla debe coincidir con el nivel geográfico del análisis. Por ejemplo, para un análisis a nivel ADM1, la tabla de denominadores poblacionales debe tener la siguiente estructura.
immunABC.pop.ADM1 %>% head() %>% kable(caption = "Ejemplo de población a nivel ADM1")| ADM1 | year | age | population |
|---|---|---|---|
| ADM1_1 | 2022 | 0 | 1718.189 |
| ADM1_1 | 2022 | 1 | 1808.964 |
| ADM1_1 | 2023 | 0 | 1703.145 |
| ADM1_1 | 2023 | 1 | 1792.443 |
| ADM1_2 | 2022 | 0 | 6575.261 |
| ADM1_2 | 2022 | 1 | 6922.644 |
Esta tabla está en formato largo y contiene la población
(population) de niños de una edad (age)
específica durante un año (year) determinado para un nivel
ADM1.
Análisis de cobertura de esquema completo
Flujo de trabajo esperado
Las funciones cs_coverage(), cs_barplot() y
cs_upsetplot() permiten analizar y visualizar la cobertura
de esquema completo. Su relación se muestra en la Figura 1.
Ejemplo
A continuación se presenta un ejemplo simplificado para calcular la cobertura de esquema completo en el primer nivel administrativo subnacional, usando la cohorte de nacimiento de 2022.
# calcular la cobertura
coverage_df <- cs_coverage(
data.EIR = immunABC.EIR,
data.schedule = immunABC.schedule,
geo_level = "ADM1",
birth_cohorts = 2022 # esto puede ser un vector de años
)
# mostrar los resultados en una tabla
coverage_df %>%
kable(digits = 2, caption = "Cobertura de esquema completo a nivel ADM1")| year | ADM1 | numerator | population | coverage |
|---|---|---|---|---|
| 2022 | ADM1_1 | 406 | 1733 | 23.43 |
| 2022 | ADM1_2 | 1145 | 12428 | 9.21 |
| 2022 | ADM1_3 | 6508 | 50238 | 12.95 |
| 2022 | ADM1_4 | 1355 | 6382 | 21.23 |
| 2022 | ADM1_5 | 735 | 3488 | 21.07 |
Gráfico de barras
Es posible mostrar los resultados obtenidos previamente en un gráfico
de barras con cs_barplot().
# visualizar el resultado de cs_coverage()
coverage_plot <- cs_barplot(data = coverage_df)
# mostrar
coverage_plot
Gráfico UpSet
La función cs_upsetplot() genera un gráfico UpSet para
evaluar el porcentaje de personas incluidas en el RNVe que recibieron
las distintas combinaciones posibles de vacunas. La barra naranja
representa la proporción de personas que recibieron todas las vacunas
evaluadas; por lo tanto, muestra la cobertura de esquema completo. Las
barras horizontales muestran la proporción de personas que recibió cada
vacuna específica, es decir, la cobertura de esa vacuna.
# producir el gráfico UpSet
coverage_upset <- cs_upsetplot(
data.EIR = immunABC.EIR,
data.schedule = immunABC.schedule,
birth_cohort = 2022
)## Warning: Using `size` aesthetic for lines was deprecated in ggplot2 3.4.0.
## ℹ Please use `linewidth` instead.
## ℹ The deprecated feature was likely used in the ComplexUpset package.
## Please report the issue at
## <https://github.com/krassowski/complex-upset/issues>.
## This warning is displayed once per session.
## Call `lifecycle::last_lifecycle_warnings()` to see where this warning was
## generated.
# mostrar
coverage_upset
En el ejemplo, la cobertura de esquema completo alcanzó el 13,7 % y está representada por la barra naranja.
También se observa que el 24,1 % de las personas en el RNVe recibió únicamente la vacuna BCG, y que la tercera combinación más frecuente (9,1 %) corresponde a personas que recibieron todas las demás vacunas excepto BCG. Esto podría indicar errores en el registro de la BCG al nacer, por ejemplo cuando se usan números de identificación temporales.