Summary

Updates deprecation warnings for visualization portrayal components to specify "will be removed in Mesa 4.0" and upgrades warnings from PendingDeprecationWarning to FutureWarning (following our deprecation policy).

What's Deprecated

• Returning dictionaries from agent_portrayal functions
• Returning dictionaries from propertylayer_portrayal
• Passing portrayal arguments directly to draw_agents() and draw_propertylayer() methods

Migration

Use AgentPortrayalStyle and PropertyLayerStyle instead of dictionaries:

# Old
def agent_portrayal(agent):
    return {"color": "red", "marker": "s", "size": 30}

# New
def agent_portrayal(agent):
    return AgentPortrayalStyle(color="red", marker="s", size=30)

For draw_agents() and draw_propertylayer(), use setup_agents() and setup_propertylayer() before calling the draw methods.

See the migration guide for details.