Skip to content

Commit

Permalink
Improve Mesa 3.0 beta 1 release notes (#2384)
Browse files Browse the repository at this point in the history
Add some more information about the examples and mention the SPEC 7 random number generator.
  • Loading branch information
EwoutH authored Oct 18, 2024
1 parent d2df9d4 commit 4ed0d6d
Showing 1 changed file with 7 additions and 4 deletions.
11 changes: 7 additions & 4 deletions HISTORY.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,16 @@ title: Release History
---

# 3.0.0b1 (2024-10-17)

## Highlights
Basic exmaples are now importable in Mesa, includes boid_flockers, boltzmann_wealth_model, conways_game_of_life, schelling, and virus_on_network models. With this change they are also integrated into the Mesa tutorial in the docs.
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](https://github.com/projectmesa/mesa-examples) to mesa itself ([#2358](https://github.com/projectmesa/mesa/pull/2358)). The 5 basic examples are now directly importable ([#2381](https://github.com/projectmesa/mesa/pull/2381)):
```Python
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.

Also, in this release, visualizations are improved by making visualization elements scalable and more clearly labeling the plots.
All our core examples can now be viewed in the [`examples`](https://github.com/projectmesa/mesa/tree/main/examples) folder. [mesa-examples](https://github.com/projectmesa/mesa-examples) will continue to exists for user showcases. We're also working on making the examples visible in the ReadtheDocs ([#2382](https://github.com/projectmesa/mesa/pull/2382)) and on an website ([mesa-examples#139](https://github.com/projectmesa/mesa-examples/issues/139)). Follow all our work on the examples in this tracking issue [#2364](https://github.com/projectmesa/mesa/issues/2364).

<!-- Release notes generated using configuration in .github/release.yml at main -->
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](https://scientific-python.org/specs/spec-0007/) compliant NumPy random number generator ([#2352](https://github.com/projectmesa/mesa/pull/2352)). Following SPEC 7, you have to pass either `seed` or `rng`. Whichever one you pass will be used to seed both `random.Random`, and `numpy.random.Generator.`

## What's Changed
### ⚠️ Breaking changes
Expand Down

0 comments on commit 4ed0d6d

Please sign in to comment.