Mesa 3.0 beta 1

Highlights

Mesa 3.0 beta 1 is our last beta release before the Mesa 3.0 stable release. We are restructuring our examples and have move 9 core examples from mesa-examples to mesa itself (#2358). The 5 basic examples are now directly importable (#2381):

from examples.basic import BoidFlockers, BoltzmannWealthModel, ConwaysGameOfLife, Schelling, VirusOnNetwork

The 5 basic examples will always use stable Mesa features, we are also working on 4 more advanced example which can also include experimental features.

All our core examples can now be viewed in the examples folder. mesa-examples will continue to exists for user showcases. We're also working on making the examples visible in the ReadtheDocs (#2382) and on an website (mesa-examples#139). Follow all our work on the examples in this tracking issue #2364.

Furthermore, the visualizations are improved by making visualization elements scalable and more clearly labeling the plots, and the Model now has an rng argument for an SPEC 7 compliant NumPy random number generator (#2352).

What's Changed

⚠️ Breaking changes

• replace model with random in AgentSet init by @quaquel in #2350

🧪 Experimental features

• cell space: Add convenience properties for grid width and height by @quaquel in #2348
• Bugfix for deepcopy / pickling discrete spaces by @quaquel in #2378

🎉 New features added

• Move core example models back (v2) by @EwoutH in #2358
• Add Model.rng for SPEC-7 compliant numpy random number generation by @quaquel in #2352

🛠 Enhancements made

• use GridDraggable instead of Column in SolaraViz by @wang-boyu in #2344
• update legend, xlabel & format of matplotlib plots by @wang-boyu in #2346
• init.py: Import mesa.experimental by @EwoutH in #2374
• Importable examples by @Corvince in #2381

🐛 Bugs fixed

• experimental init: Fix Solara import by making it lazy by @EwoutH in #2357
• fix: pass model.random to schedulers by @quaquel in #2359
• fix: register agent after creating unique_id and pos attributes by @wang-boyu in #2368
• solara: viz tutorial: fix histogram code by @Corvince in #2379

🔍 Examples updated

• Cleanup and restructure basic example models by @EwoutH in #2365
• Ruff basic examples by @EwoutH in #2370

📜 Documentation improvements

• Update migration_guide.md by @quaquel in #2347

🔧 Maintenance

• Code coverage: ignore experimental and visualization by @Corvince in #2361
• add codecov token, fixes #2363 by @Corvince in #2366
• add test_time back by @quaquel in #2367
• Release notes: Add example category by @EwoutH in #2369

Full Changelog: v3.0.0b0...v3.0.0b1