Repository navigation
puremacro 6.3.0: research APIs and second-order HANK
puremacro 6.3.0 adds research APIs for solving equilibria, accounting for simulation uncertainty, and auditing policy models. It merges #232 and #233 while preserving existing entry points and their approximation orders.
- Equilibrium derivatives, reusable dense factorizations, and pseudo-arclength continuation with explicit fold and failure diagnostics.
- Reproducible simulation-aware SMM, separate sampling/simulation uncertainty, and identification-robust tests and confidence sets within documented model classes.
- Bounded research models for trade reallocation, heterogeneous expectations, sovereign banking, and sovereign adaptation.
- Real-Schur HANK solution and experimental second-order full-basis one-asset policies, anticipated-risk terms, pruned simulation, and independent nonlinear audits.
- Shared validation and ownership contracts, immutable retained arrays, public API snapshots, and executable English/Spanish guides.
- The bilingual NUTS example now uses four chains and 1,000 retained draws per chain, with the same convergence and divergence checks.
Install with python -m pip install puremacro==6.3.0 on Python 3.11 or later. Read the research API guide, second-order HANK guide, and full changelog.
The new economic models remain experimental. The second-order HANK benchmark accepts 22 of 24 signed-amplitude cases: the 20-asset negative shocks -0.001 and -0.0005 fail the unchanged distribution audit. Eight of ten finite nonlinear reference solves meet their tolerance; two coarse-grid failures remain recorded. This evidence does not establish household-grid convergence, infinite-horizon/global accuracy, welfare, or reduced-basis/two-asset/capital support. Inspect each returned audit before interpreting a path. The model modules have separate economic closures; combining their outputs requires an explicitly specified joint model.
Validation on bf3e2d320e024e832b11a4b32b8d649c78a1e481: 23,902 local tests passed, 91 skipped, and all seven local release gates passed. The main CI matrix and tag release workflow passed, including nine OS/Python targets, typing/docs, and installed-wheel examples. The opt-in and showcase run passed: 134 opt-in tests, 19 skipped, plus the complete showcase notebook execution. The real Pyodide kernel passed 120 smoke tests. Installed-package checks covered eight new research CLI entry points, four numerical research examples, the second-order HANK guide, and four base workflows. These cohorts overlap. Downloaded PyPI artifact hashes and all 1,051 packaged files were verified against the tagged source, followed by a fresh PyPI installation and executed examples. See the attached release-validation.json for the artifact hashes and scope.
The examples gallery retains the documented Romer–Romer (2010) published t-statistic rounding mismatch; it is not relabeled as passing. Timing checks use the repository's CI scale of 10 and do not certify unscaled wall-clock deadlines.
The pinned course edition keeps its own package version and validation record. This library release does not upgrade or requalify those course environments.
Español. puremacro 6.3.0 incorpora derivadas y continuación de equilibrios, SMM con incertidumbre de simulación, inferencia robusta a identificación y modelos acotados de reasignación comercial, expectativas heterogéneas, banca soberana y adaptación. Incluye HANK experimental de segundo orden con un activo y bases completas, simulación podada y auditorías no lineales. Las API existentes conservan su orden de aproximación. Consulte las API de investigación y la guía HANK.
Los límites numéricos se conservan: 22/24 casos de amplitud HANK superan la auditoría y 8/10 referencias no lineales convergen a la tolerancia declarada. Los casos rechazados no se reclasifican como éxitos. No se certifican convergencia de malla, exactitud global o de horizonte infinito, bienestar ni modelos de dos activos. La edición fija del curso mantiene su entorno y sus comprobaciones independientes.