Missing classes for vizualization

[zsoltturbine]

Hi,

I'm using mesa 3.2 to create an interactive "game" to present cancer/immune-system interaction for educational purposes. I have a working model, but I'm struggling to create the visualisation. All tutorial (even the this one updated 2 weeks ago) uses classes like SpaceRenderer and AgentPortrayalStyle which are not exist in 3.2 and Migration Guide which is... let's call it 'minimalist' does not really help in this case. Could you please recommend me an up-to-date tutorial? Thanks in advance! Zsolt

[quaquel]

Is there a reason you cannot update to MESA 3.3?

[Thakor-Yashpal]

Hi @zoitlisof,

This is a great question. As @quaquel's comment implies, the core issue is that the tutorials you're following are for MESA 3.3, which introduced new visualization classes like SpaceAwareVis and AgentPortrayalVis. Since you're on 3.2, you don't have them. The best solution for your project is to upgrade to MESA 3.3.

This does show we have a gap in our documentation that could be confusing for new users. It's not clear which tutorials apply to which version.

I can work on this. I can submit a Pull Request to update the documentation, adding a clear note on the visualization pages to warn users about this 3.2 vs. 3.3 difference. This will help guide users on older versions.

If a maintainer can confirm this is a good idea, please assign this issue to me, and I'll get started on the documentation PR.

[EwoutH]

A small note in https://github.com/projectmesa/mesa/blob/main/docs/tutorials/4_visualization_basic.ipynb might be useful that the tutorial is updated for and requires Mesa 3.3.

@zsoltturbine like suggested, either keep using Mesa 3.2 but follow an old version of the tutorial, or update to Mesa 3.3 and follow the latest version (recommended).

[Srinath0916]

Hi @EwoutH I've implemented the solution for this issue by adding clear version requirement warnings to all visualization tutorials (4-8).

The warnings clearly state that Mesa 3.3+ is required and provide upgrade instructions. This should resolve the confusion users face when following tutorials with older Mesa versions.

Ready to open a PR.