Comparativo (cross-dataset)¶

Endpoints que cruzan CDMX × CONSAR × ENIGH con caveats editoriales del equipo.

→ Para uso narrado, ver Tutorial comparativo.

Namespace¶

datos_mexico.endpoints.comparativo.ComparativoNamespace ¶

ComparativoNamespace(http: HttpClient)

Bases: BaseNamespace

Endpoints comparativos cross-dataset.

Estos endpoints son el diferenciador editorial del Observatorio Datos México: cruzan información de los tres datasets principales (Servidores Públicos CDMX, CONSAR/SAR, ENIGH 2024 NS) y devuelven, además de métricas precomputadas, texto editorial pre-escrito por el equipo (note, narrative, interpretacion, caveats, caveats_interpretativos). Estos campos son contenido humano y el SDK no los altera.

Examples:

>>> from datos_mexico import DatosMexico
>>> with DatosMexico() as client:
...     ing = client.comparativo.ingreso_cdmx_vs_nacional()
...     print(f"Ratio nacional/servidor: "
...           f"{ing.ratio_hogar_nacional_sobre_servidor}")

ingreso_cdmx_vs_nacional ¶

ingreso_cdmx_vs_nacional() -> ComparativoIngreso

Compara sueldo medio/mediano del servidor CDMX vs ingreso medio del hogar.

Cruza el sueldo del servidor público de la CDMX con el ingreso corriente medio del hogar nacional y del hogar CDMX (ENIGH 2024 NS). Incluye brechas absolutas y razones (ratio_*) precomputadas y notas metodológicas del observatorio en note y caveats.

Endpoint: GET /api/v1/comparativo/ingreso/cdmx-vs-nacional

gastos_cdmx_vs_nacional ¶

gastos_cdmx_vs_nacional() -> ComparativoGastos

Compara gasto monetario medio CDMX vs nacional, desagregado por rubro.

Devuelve el gasto monetario medio mensual de los hogares (nacional y CDMX) y un array rubros con el detalle por rubro (delta absoluto, delta %, peso del rubro dentro del gasto monetario total).

Endpoint: GET /api/v1/comparativo/gastos/cdmx-vs-nacional

decil_servidores_cdmx ¶

decil_servidores_cdmx() -> ComparativoDecilServidores

Posición del servidor CDMX en deciles ENIGH bajo distintos escenarios.

Cruza percentiles de sueldo del servidor CDMX (p25/p50/p75/p90) con los deciles de ingreso del hogar nacional ENIGH bajo varios supuestos (perceptor único, dos perceptores, etc.). El payload incluye narrative y caveats_interpretativos con narrativa estructurada del observatorio para evitar simplificaciones.

Endpoint: GET /api/v1/comparativo/decil-servidores-cdmx

top_vs_bottom ¶

top_vs_bottom() -> ComparativoTopVsBottom

Comparación bracket alto (top percentiles) vs bracket bajo.

Cruza el extremo alto de la distribución de sueldos CDMX con el decil 10 ENIGH y el extremo bajo con el decil 1, incluyendo narrative e insights editoriales.

Endpoint: GET /api/v1/comparativo/top-vs-bottom

bancarizacion ¶

bancarizacion() -> ComparativoBancarizacion

Hogares con uso de tarjeta débito/crédito CDMX vs nacional.

Devuelve porcentajes y razón (CDMX/nacional) bajo la definicion_operativa que documenta el endpoint. Útil como proxy de bancarización financiera.

Endpoint: GET /api/v1/comparativo/bancarizacion

actividad_cdmx_vs_nacional ¶

actividad_cdmx_vs_nacional() -> ComparativoActividad

Hogares con actividad agropecuaria/no-agropecuaria CDMX vs nacional.

Compara el porcentaje y conteo expandido de hogares con actividad agropecuaria vs no-agropecuaria entre CDMX y nacional. Incluye note y nota_hipotesis editoriales.

Endpoint: GET /api/v1/comparativo/actividad-cdmx-vs-nacional

aportes_vs_jubilaciones_actuales ¶

aportes_vs_jubilaciones_actuales() -> (
    ComparativoAportesVsJubilaciones
)

Aportes (deducciones) actuales del servidor CDMX vs jubilaciones ENIGH.

Endpoint cross-dataset que contrasta deducciones del servidor CDMX activo con jubilaciones actualmente recibidas por hogares ENIGH. El campo interpretacion aclara que no es una comparación actuarial: son dos realidades coexistentes del sistema de pensiones, no una proyección.

Endpoint: GET /api/v1/comparativo/aportes-vs-jubilaciones-actuales

Modelos¶

Modelos Pydantic para el namespace comparativo.

Endpoints cross-dataset que cruzan información de Servidores Públicos CDMX, CONSAR/SAR y ENIGH en un solo payload, con campos editoriales pre-escritos por el equipo del observatorio (note, narrative, interpretacion, caveats, ...). Los nombres de los campos editoriales son heterogéneos entre endpoints: cada uno usa la nomenclatura acordada por el equipo y se preservan tal cual del API.

Convenciones específicas de este módulo:

Campos monetarios y métricas derivadas (ratio_*, pct_*, delta_*, brecha_*) se exponen como Decimal vía BeforeValidator(_to_decimal) para preservar precisión aritmética.
Campos de texto editorial (note, nota_hipotesis, narrative, interpretacion, definicion_operativa) son str requeridos según el spec; el SDK no los altera.
caveats siempre es list[str] (puede estar vacía).
Algunos endpoints exponen objetos schema-libre (cdmx_servidor en decil-servidores-cdmx, top_bracket/bottom_bracket en top-vs-bottom). Se tipan como dict[str, Any] y se documenta que el shape evoluciona server-side.

Comparativo (cross-dataset)¶

Namespace¶

datos_mexico.endpoints.comparativo.ComparativoNamespace ¶

ingreso_cdmx_vs_nacional ¶

gastos_cdmx_vs_nacional ¶

decil_servidores_cdmx ¶

top_vs_bottom ¶

bancarizacion ¶

actividad_cdmx_vs_nacional ¶

aportes_vs_jubilaciones_actuales ¶

Modelos¶

IngresoCdmxServidor ¶

IngresoEnighHogar ¶

GastoRubroComparativo ¶

DecilBound ¶

EscenarioMapeoRow ¶

EscenarioResponse ¶

CaveatsInterpretativos ¶

ActividadComparativa ¶

CdmxAportesActuales ¶

EnighJubilacionesActuales ¶

ComparativoIngreso ¶

ComparativoGastos ¶

ComparativoDecilServidores ¶

ComparativoTopVsBottom ¶

ComparativoBancarizacion ¶

ComparativoActividad ¶

ComparativoAportesVsJubilaciones ¶