Skip to content

bam-engine 0.2.0

Choose a tag to compare

@kganitis kganitis released this 20 Jan 21:09
· 414 commits to main since this release

Major release introducing validation and calibration frameworks for model verification, pipeline hooks for cleaner model extensions (@event(after="..."), before, replace), and 50-80% performance improvements through optimized logging and vectorized market operations.

New packages:

  • validation/ - Acceptance testing with baseline and growth+ scenarios
  • calibration/ - Parameter optimization via sensitivity analysis and grid search

Highlights:

  • Data collection enhancements: Timed results capture via capture_after="event_name"
  • Price event re-ordering: Breakeven price calculation → price adjustment (now uses projected output) → production → average market price update
  • Labor market fixes: Worker wages now update with minimum wage adjustments, sequential firms-workers matching
  • Goods market fixes: Corrected loyalty/preferential attachment behavior

Breaking changes:

  • Config renamed: min_wage → min_wage_ratio, net_worth_init → net_worth_ratio
  • Results API: results.economy → results.economy_data, requires collect=True
  • Defaults changed: 100→300 firms, 500→3000 households, delta 0.4→0.1
  • Event renamed: FirmsCalcCreditMetrics → FirmsCalcFinancialFragility

See CHANGELOG for complete details of what's included in this version.

If you want to get started with using BAM Engine, see the README.