KarlNaumann / MacroStat

90%

Build Type

push

github

Committed by web-flow

Commit Message

feat(core): support non-SFC models and variable-shape agent state (#77)

* feat(core): make Variables SFC-optional and shape-axis-aware

- get_stock/flow/index_variables and verify_sfc_info skip variables
  without an "sfc" key (non-SFC path); no opt-in flag needed
- new_state() reinterprets info[k]["sectors"] as a shape-axis list.
  Each entry is an int literal or a string resolved via
  Parameters.__getitem__ (which falls through to hyper). All entries
  resolving to positive ints → that shape tuple; otherwise legacy
  len(sectors) fallback preserves SFC-style label lists bit-identical
- delete per-step gather_timeseries() inside record_state; rely on the
  single end-of-forward() call (behavior.py:154). Recording stays
  stack-based for autograd safety; storage path is linear instead of
  quadratic in T
- compute_theoretical_steady_state now calls gather_timeseries() at
  end of method to honor the single-gather contract
- to_pandas falls back to positional integer columns when sector_map
  labels do not match the recorded tensor's column count (het-agent
  case); SFC label-match path unchanged

* test(core): add het-agent fixture and Variables shape-axis tests

- test_variables_hetagent.py: six targeted unit tests covering
  hyper-axis resolution, int literal, multi-level SFC routing via
  the level field, non-SFC skip path, legacy label-list fallback,
  and legacy multi-label sector
- test_hetagent_fixture.py: synthetic toy non-SFC heterogeneous-agent
  model with FirmCapital shape (N_firms=20,) and HouseholdWealth shape
  (N_households=100,). End-to-end test (init → simulate → to_pandas)
  and autograd-Jacobian test (decay parameter, finite non-zero grad)

* docs: update Migration Notes and SDE section for het-agent infra

- Migration Notes: record that the Variables SFC-optional and
  variable-shape abstraction landed (dispatch MacroStat_HetAgentInfra,
  branch feat/hetagent-infra). Mark-0 and Poledna ports unblocked
- Migration Notes: document... (continued)

Coverage Stats

499 of 544 branches covered (91.73%)

Branch coverage included in aggregate %.

25 of 41 new or added lines in 2 files covered. (60.98%)

3 existing lines in 1 file now uncovered.

3344 of 3710 relevant lines covered (90.13%)

5.41 hits per line