Reasignación Comercial Dinámica e Incidencia en los Hogares
🇬🇧 English · 🇪🇸 Español
El módulo puremacro.trade.reallocation_incidence enlaza las transiciones comerciales de previsión perfecta con dos países y dos sectores (trade_reallocation.md) con el bienestar de grupos de hogares normalizado al punto de referencia (trade_household.md) y las cuentas ICIO de la OCDE incluidas. En lugar de tratar cada región como un único agente representativo, mide cómo los salarios sectoriales, las rentas del capital netas de inversión, las devoluciones arancelarias y los precios al consumidor distribuyen ganancias y pérdidas entre grupos de hogares en cada fecha \(t = 0, \dots, T-1\).
Estructura Matemática e Identidades Contables
Agregación ICIO de la OCDE (calibrate_reallocation_from_icio)
Dada una tabla multirregional y multisectorial (Z, F, VA_L, VA_K, TLS, TFD, output) y dos particiones exhaustivas —country_groups (por defecto USA frente a ROW en la ICIO OCDE) y sector_groups (por defecto Tradable CIIU A–C frente a Services)—, el puente conserva el valor agregado total al mapear las cuotas empíricas de gasto hacia ReallocationEconomy:
La oferta laboral de cada país se normaliza proporcionalmente al valor agregado laboral regional (\(\sum_c L_c = 2\)), mientras la base de flujos ("final_demand", "consumption" o "total_absorption") selecciona si \(E_{i,s,c}\) mide la demanda final total C + I + Cx, el consumo C o la absorción bruta Z + F.
Presupuestos de Grupos y Bienestar (evaluate_transition_household_incidence)
En cada fecha \(t \in \{0, \dots, T-1\}\) de una transición ReallocationTransitionResult convergida y auditada, el gasto nominal agregado en consumo del país \(c\) cumple:
Cada grupo de hogares \(g \in \mathcal{G}_c\) recibe pesos salariales sectoriales \((\lambda^L_{g,0}, \lambda^L_{g,1})\), peso de capital \(\lambda^K_g\), peso de devolución arancelaria \(\lambda^R_g\) y cuota de desembolso en inversión/ajuste \(\lambda^I_g\), cada uno sumando \(1.0\) dentro del país \(c\):
Dado que cada componente de ingreso y gasto particiona exactamente el total nacional, la suma del gasto nominal de los grupos iguala de forma idéntica al consumo nacional (\(\sum_{g \in \mathcal{G}_c} m_{t,g} = P_{c,t} C_{c,t}\)) y el ingreso bruto grupal iguala a la absorción bruta (\(P_{c,t} A_{c,t}\)) en cada fecha.
Las preferencias de demanda se calibran en los precios de referencia del estado estacionario inicial \(p^{\text{rel}}_{0,c,s} = 1\) mediante puremacro.trade.household.calibrate_household bajo "fixed_baskets", "cobb_douglas", "stone_geary" o "ces". A lo largo de la senda, los precios relativos sectoriales \(p^{\text{rel}}_{t,c,s} = P_{t,c,s} / P_{0,c,s}\) y presupuestos \(m_{t,g}\) producen:
- Índice de Costo de Vida de Konüs e Ingreso Real: \(P^{\text{COL}}_{t,g} = e_g(p^{\text{rel}}_t, u_{0,g}) / m_{0,g}\) y \(m^{\text{real}}_{t,g} = m_{t,g} / P^{\text{COL}}_{t,g}\).
- Bienestar Monetario por Periodo: Variación equivalente \(EV_{t,g} = e_g(1, u_{t,g}) - m_{0,g}\) y variación compensatoria \(CV_{t,g} = m_{t,g} - e_g(p^{\text{rel}}_t, u_{0,g})\).
- Resúmenes en Valor Presente de la Senda: Valor presente \(PV\_EV_g = \sum_{t=0}^{T-1} \beta^t EV_{t,g} + \frac{\beta^T}{1-\beta} EV^{\text{term}}_g\) y porcentaje equivalente en consumo intertemporal CRRA \(\text{CEV}_g\) evaluado sobre \(c^{\text{eq}}_{t,g} = m_{0,g} + EV_{t,g}\).
- Brecha de Desigualdad entre Grupos: Rango máximo-menos-mínimo y desviación estándar ponderada por presupuesto de \(EV\%_{t,g}\) por país a lo largo de \(t = 0, \dots, T-1\).
Flujo de Calibración e Incidencia
El ejemplo siguiente calibra (USA, ROW) x (Tradable, Services) desde la tabla ICIO OCDE 2019 incluida, aplica un arancel estadounidense del 20% a las importaciones transables, resuelve la transición dinámica y evalúa la incidencia por grupos:
from puremacro.trade.reallocation import solve_reallocation_transition
from puremacro.trade.reallocation_incidence import (
calibrate_reallocation_from_icio,
evaluate_transition_household_incidence,
make_sector_household_groups,
reallocation_tariffs_from_scenarios,
)
from puremacro.trade.scenarios import TariffScenario
cal = calibrate_reallocation_from_icio()
scenario = TariffScenario(
importer="USA",
tariffs={("ROW", "Tradable"): 0.20},
name="us_tradable_20pct",
)
tariffs = reallocation_tariffs_from_scenarios(scenario, cal.economy, horizon=25)
transition = solve_reallocation_transition(cal.economy, tariffs)
groups = make_sector_household_groups(
cal.economy,
include_capital_owners=True,
basket_tilt=0.05,
)
incidence = evaluate_transition_household_incidence(
transition,
groups,
rule="cobb_douglas",
)
print(incidence.summary(lang="en"))
Regiones Personalizadas y Preferencias Heterogéneas
Quien llama puede definir particiones ICIO 2x2 arbitrarias (como MEX+USA frente a ROW), inspeccionar la exposición inflacionaria desagregada por canasta de gasto y combinar distintas reglas de demanda (fixed_baskets, stone_geary, ces) en una misma evaluación:
from puremacro.trade.data import load_icio_data
from puremacro.trade.reallocation import solve_reallocation_transition
from puremacro.trade.reallocation_incidence import (
HouseholdGroupSpec,
calibrate_reallocation_from_icio,
evaluate_transition_household_incidence,
reallocation_tariffs_from_scenarios,
)
from puremacro.trade.scenarios import TariffScenario
icio = load_icio_data(return_structured=True)
mex_usa = ("MEX", "USA")
row = tuple(c for c in icio.country_codes if c not in mex_usa)
cal_na = calibrate_reallocation_from_icio(
icio,
country_groups={"MEX+USA": mex_usa, "ROW": row},
sector_groups={"Goods": ("A", "B", "C"), "Services": tuple(s for s in icio.sector_codes if s not in ("A", "B", "C"))},
expenditure_basis="consumption",
)
tariffs = reallocation_tariffs_from_scenarios(
TariffScenario(importer="MEX+USA", tariffs={("ROW", "Goods"): 0.15}),
cal_na.economy,
horizon=20,
)
tr = solve_reallocation_transition(cal_na.economy, tariffs)
custom_groups = (
HouseholdGroupSpec(
name="NA_Goods_Workers_LowElasticity",
country="MEX+USA",
labor_weights=(1.0, 0.0),
capital_weight=0.0,
rebate_weight=0.5,
investment_weight=0.0,
expenditure_shares=(0.65, 0.35),
rule="stone_geary",
supernumerary_share=0.5,
),
HouseholdGroupSpec(
name="NA_Services_and_Capital",
country="MEX+USA",
labor_weights=(0.0, 1.0),
capital_weight=1.0,
rebate_weight=0.5,
investment_weight=1.0,
expenditure_shares=(0.20, 0.80),
rule="ces",
ces_elasticity=2.0,
),
HouseholdGroupSpec(
name="ROW_Representative",
country="ROW",
labor_weights=(1.0, 1.0),
non_labor_weight=1.0,
rule="cobb_douglas",
),
)
res = evaluate_transition_household_incidence(tr, custom_groups)
print(res.inequality_dataframe().head())
Límites Transparentes de Calibración y Divulgación
Las tablas insumo-producto de un solo año no identifican parámetros intertemporales, de sustitución ni de ajuste. Cada llamada a calibrate_reallocation_from_icio registra explícitamente las siguientes fronteras de modelización dentro de result.audit.stylized_assumptions y result.diagnostic:
| Parámetro o Supuesto | Origen en ICIO | Estado de Identificación y Divulgación |
|---|---|---|
sector_weights |
Demanda agregada observada | Identificado por cuotas de final_demand, consumption o total_absorption. |
home_shares |
Flujos domésticos e importados | Identificado bajo la base elegida; el alto sesgo local de ROW (~0.98) exige un sourcing_cost bajo. |
labor_supply |
labor_va agregado |
Escala relativa regional de ingreso laboral normalizada para sumar 2.0. |
capital_share |
capital_va / va incluido |
El archivo OCDE 2023 usa la convención 2/3 trabajo y 1/3 capital; promediado a un escalar global. |
productivity |
No identificado por separado | Los flujos nominales en USD de un año confunden precios y PTF física; se fija en ones((2, 2)). |
beta, delta, risk_aversion |
Ausentes en IO estática | Supuestos estilizados anuales (0.96, 0.08, 2.0) en lugar de momentos estimados. |
trade_elasticity, costos de ajuste |
Ausentes en IO estática | Supuestos estilizados (trade_elasticity=4.0, capital_cost=4.0, labor_cost=5.0, sourcing_cost=0.01). |
Insumos intermedios (Z) y aranceles |
Omitidos o agregados en TLS/TFD |
ReallocationEconomy modela valor agregado bajo autarquía financiera (balanza comercial nula) y aranceles base cero. |
Auditorías de Conservación, Diagnósticos y Referencia de API
Cada evaluación aplica verificaciones estrictas de rechazo antes de devolver resultados:
- Solo Transiciones Convergidas y Auditadas: Pasar una instancia
ReallocationTransitionResultno convergida o alterada lanzaTransitionError(subclase deValueError). - Partición Exacta de Factores y Presupuestos: Sumas nacionales inválidas de pesos laborales, de capital, de devoluciones o de inversión (distintas de
1.0), cuotas de gasto negativas o que no suman1.0, o presupuestos grupales no positivos lanzanValueError/TransitionError. - Verificación de Identidad con Choque Cero: Cuando
tariffs == 0en toda la senda,evaluate_transition_household_incidenceverifica \(|EV_{t,g}| < 10^{-12}\), \(|CV_{t,g}| < 10^{-12}\) y \(|P^{\text{COL}}_{t,g} - 1| < 10^{-12}\) para todo grupo y fecha. - Diagnósticos Estandarizados y Exportación Bilingüe: Tanto
ReallocationCalibrationResultcomoTransitionHouseholdIncidenceResultadjuntan unSolverDiagnosticRecord(puremacro.solvers.diagnostics) y exponen.summary(lang="en"|"es"),.to_dataframe(),.to_markdown(),.to_latex(),.to_typst()y.to_dict().
Guías relacionadas: trade_reallocation.md · trade_household.md · trade_distributional.md · trade_stability.md.