Mesa 3.0.0__py3-none-any.whl → 3.0.0a0__py3-none-any.whl

mesa/{experimental/solara_viz.py → visualization/jupyter_viz.py}

@@ -1,10 +1,11 @@
-"""Mesa visualization module for creating interactive model visualizations.
+"""
+Mesa visualization module for creating interactive model visualizations.
 
 This module provides components to create browser- and Jupyter notebook-based visualizations of
 Mesa models, allowing users to watch models run step-by-step and interact with model parameters.
 
 Key features:
-    - SolaraViz: Main component for creating visualizations, supporting grid displays and plots
+    - JupyterViz: Main component for creating visualizations, supporting grid displays and plots
     - ModelController: Handles model execution controls (step, play, pause, reset)
     - UserInputs: Generates UI elements for adjusting model parameters
     - Card: Renders individual visualization elements (space, measures)
@@ -16,21 +17,22 @@ custom visualization components.
 Usage:
     1. Define an agent_portrayal function to specify how agents should be displayed
     2. Set up model_params to define adjustable parameters
-    3. Create a SolaraViz instance with your model, parameters, and desired measures
+    3. Create a JupyterViz instance with your model, parameters, and desired measures
     4. Display the visualization in a Jupyter notebook or run as a Solara app
 
 See the Visualization Tutorial and example models for more details.
 """
 
+import sys
 import threading
 
 import reacton.ipywidgets as widgets
 import solara
 from solara.alias import rv
 
-import mesa.experimental.components.altair as components_altair
-import mesa.experimental.components.matplotlib as components_matplotlib
-from mesa.experimental.UserParam import Slider
+import mesa.visualization.components.altair as components_altair
+import mesa.visualization.components.matplotlib as components_matplotlib
+from mesa.visualization.UserParam import Slider
 
 
 # TODO: Turn this function into a Solara component once the current_step.value
@@ -38,7 +40,8 @@ from mesa.experimental.UserParam import Slider
 def Card(
     model, measures, agent_portrayal, space_drawer, dependencies, color, layout_type
 ):
-    """Create a card component for visualizing model space or measures.
+    """
+    Create a card component for visualizing model space or measures.
 
     Args:
         model: The Mesa model instance
@@ -68,7 +71,7 @@ def Card(
                 )
             elif space_drawer:
                 # if specified, draw agent space with an alternate renderer
-                space_drawer(model, agent_portrayal, dependencies=dependencies)
+                space_drawer(model, agent_portrayal)
         elif "Measure" in layout_type:
             rv.CardTitle(children=["Measure"])
             measure = measures[layout_type["Measure"]]
@@ -83,7 +86,7 @@ def Card(
 
 
 @solara.component
-def SolaraViz(
+def JupyterViz(
     model_class,
     model_params,
     measures=None,
@@ -93,15 +96,15 @@ def SolaraViz(
     play_interval=150,
     seed=None,
 ):
-    """Initialize a component to visualize a model.
+    """
+    Initialize a component to visualize a model.
 
     Args:
         model_class: Class of the model to instantiate
         model_params: Parameters for initializing the model
         measures: List of callables or data attributes to plot
         name: Name for display
-        agent_portrayal: Options for rendering agents (dictionary);
-            Default drawer supports custom `"size"`, `"color"`, and `"shape"`.
+        agent_portrayal: Options for rendering agents (dictionary)
         space_drawer: Method to render the agent space for
             the model; default implementation is the `SpaceMatplotlib` component;
             simulations with no space to visualize should
@@ -155,61 +158,98 @@ def SolaraViz(
         """Update the random seed for the model."""
         reactive_seed.value = model.random.random()
 
-    dependencies = [
-        *list(model_parameters.values()),
-        current_step.value,
-        reactive_seed.value,
-    ]
-
-    # if space drawer is disabled, do not include it
-    layout_types = [{"Space": "default"}] if space_drawer else []
+    # jupyter
+    dependencies = [current_step.value, reactive_seed.value]
 
-    if measures:
-        layout_types += [{"Measure": elem} for elem in range(len(measures))]
-
-    grid_layout_initial = make_initial_grid_layout(layout_types=layout_types)
-    grid_layout, set_grid_layout = solara.use_state(grid_layout_initial)
-
-    with solara.Sidebar():
-        with solara.Card("Controls", margin=1, elevation=2):
-            solara.InputText(
-                label="Seed",
-                value=reactive_seed,
-                continuous_update=True,
-            )
+    def render_in_jupyter():
+        """Render the visualization components in Jupyter notebook."""
+        with solara.GridFixed(columns=2):
             UserInputs(user_params, on_change=handle_change_model_params)
             ModelController(model, play_interval, current_step, reset_counter)
-            solara.Button(label="Reseed", color="primary", on_click=do_reseed)
-        with solara.Card("Information", margin=1, elevation=2):
-            solara.Markdown(md_text=f"Step - {current_step}")
-
-    items = [
-        Card(
-            model,
-            measures,
-            agent_portrayal,
-            space_drawer,
-            dependencies,
-            color="white",
-            layout_type=layout_types[i],
-        )
-        for i in range(len(layout_types))
-    ]
-    solara.GridDraggable(
-        items=items,
-        grid_layout=grid_layout,
-        resizable=True,
-        draggable=True,
-        on_grid_layout=set_grid_layout,
-    )
+            solara.Markdown(md_text=f"###Step - {current_step}")
 
+        with solara.GridFixed(columns=2):
+            # 4. Space
+            if space_drawer == "default":
+                # draw with the default implementation
+                components_matplotlib.SpaceMatplotlib(
+                    model, agent_portrayal, dependencies=dependencies
+                )
+            elif space_drawer == "altair":
+                components_altair.SpaceAltair(
+                    model, agent_portrayal, dependencies=dependencies
+                )
+            elif space_drawer:
+                # if specified, draw agent space with an alternate renderer
+                space_drawer(model, agent_portrayal)
+            # otherwise, do nothing (do not draw space)
+
+            # 5. Plots
+            if measures:
+                for measure in measures:
+                    if callable(measure):
+                        # Is a custom object
+                        measure(model)
+                    else:
+                        components_matplotlib.PlotMatplotlib(
+                            model, measure, dependencies=dependencies
+                        )
+
+    def render_in_browser():
+        """Render the visualization components in a web browser."""
+        # if space drawer is disabled, do not include it
+        layout_types = [{"Space": "default"}] if space_drawer else []
+
+        if measures:
+            layout_types += [{"Measure": elem} for elem in range(len(measures))]
+
+        grid_layout_initial = make_initial_grid_layout(layout_types=layout_types)
+        grid_layout, set_grid_layout = solara.use_state(grid_layout_initial)
+
+        with solara.Sidebar():
+            with solara.Card("Controls", margin=1, elevation=2):
+                solara.InputText(
+                    label="Seed",
+                    value=reactive_seed,
+                    continuous_update=True,
+                )
+                UserInputs(user_params, on_change=handle_change_model_params)
+                ModelController(model, play_interval, current_step, reset_counter)
+                solara.Button(label="Reseed", color="primary", on_click=do_reseed)
+            with solara.Card("Information", margin=1, elevation=2):
+                solara.Markdown(md_text=f"Step - {current_step}")
+
+        items = [
+            Card(
+                model,
+                measures,
+                agent_portrayal,
+                space_drawer,
+                dependencies,
+                color="white",
+                layout_type=layout_types[i],
+            )
+            for i in range(len(layout_types))
+        ]
+        solara.GridDraggable(
+            items=items,
+            grid_layout=grid_layout,
+            resizable=True,
+            draggable=True,
+            on_grid_layout=set_grid_layout,
+        )
 
-JupyterViz = SolaraViz
+    if ("ipykernel" in sys.argv[0]) or ("colab_kernel_launcher.py" in sys.argv[0]):
+        # When in Jupyter or Google Colab
+        render_in_jupyter()
+    else:
+        render_in_browser()
 
 
 @solara.component
 def ModelController(model, play_interval, current_step, reset_counter):
-    """Create controls for model execution (step, play, pause, reset).
+    """
+    Create controls for model execution (step, play, pause, reset).
 
     Args:
         model: The model being visualized
@@ -240,7 +280,7 @@ def ModelController(model, play_interval, current_step, reset_counter):
         """Advance the model by one step."""
         model.step()
         previous_step.value = current_step.value
-        current_step.value = model.steps
+        current_step.value = model._steps
 
     def do_play():
         """Run the model continuously."""
@@ -311,7 +351,8 @@ def ModelController(model, play_interval, current_step, reset_counter):
 
 
 def split_model_params(model_params):
-    """Split model parameters into user-adjustable and fixed parameters.
+    """
+    Split model parameters into user-adjustable and fixed parameters.
 
     Args:
         model_params: Dictionary of all model parameters
@@ -330,7 +371,8 @@ def split_model_params(model_params):
 
 
 def check_param_is_fixed(param):
-    """Check if a parameter is fixed (not user-adjustable).
+    """
+    Check if a parameter is fixed (not user-adjustable).
 
     Args:
         param: Parameter to check
@@ -348,8 +390,8 @@ def check_param_is_fixed(param):
 
 @solara.component
 def UserInputs(user_params, on_change=None):
-    """Initialize user inputs for configurable model parameters.
-
+    """
+    Initialize user inputs for configurable model parameters.
     Currently supports :class:`solara.SliderInt`, :class:`solara.SliderFloat`,
     :class:`solara.Select`, and :class:`solara.Checkbox`.
 
@@ -358,6 +400,7 @@ def UserInputs(user_params, on_change=None):
         min and max values, and other fields specific to the input type.
         on_change: Function to be called with (name, value) when the value of an input changes.
     """
+
     for name, options in user_params.items():
 
         def change_handler(value, name=name):
@@ -416,7 +459,8 @@ def UserInputs(user_params, on_change=None):
 
 
 def make_text(renderer):
-    """Create a function that renders text using Markdown.
+    """
+    Create a function that renders text using Markdown.
 
     Args:
         renderer: Function that takes a model and returns a string
@@ -432,7 +476,8 @@ def make_text(renderer):
 
 
 def make_initial_grid_layout(layout_types):
-    """Create an initial grid layout for visualization components.
+    """
+    Create an initial grid layout for visualization components.
 
     Args:
         layout_types: List of layout types (Space or Measure)

{mesa-3.0.0.dist-info → mesa-3.0.0a0.dist-info}/METADATA

@@ -1,13 +1,12 @@
 Metadata-Version: 2.3
 Name: Mesa
-Version: 3.0.0
+Version: 3.0.0a0
 Summary: Agent-based modeling (ABM) in Python
 Project-URL: homepage, https://github.com/projectmesa/mesa
 Project-URL: repository, https://github.com/projectmesa/mesa
 Author-email: Project Mesa Team <projectmesa@googlegroups.com>
 License: Apache 2.0
 License-File: LICENSE
-License-File: NOTICE
 Keywords: ABM,agent,based,model,modeling,multi-agent,simulation
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Science/Research
@@ -18,63 +17,32 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Scientific/Engineering :: Artificial Life
 Requires-Python: >=3.10
+Requires-Dist: click
+Requires-Dist: cookiecutter
+Requires-Dist: matplotlib
+Requires-Dist: networkx
 Requires-Dist: numpy
 Requires-Dist: pandas
+Requires-Dist: solara
 Requires-Dist: tqdm
-Provides-Extra: all
-Requires-Dist: ipython; extra == 'all'
-Requires-Dist: matplotlib; extra == 'all'
-Requires-Dist: myst-nb; extra == 'all'
-Requires-Dist: myst-parser; extra == 'all'
-Requires-Dist: networkx; extra == 'all'
-Requires-Dist: pydata-sphinx-theme; extra == 'all'
-Requires-Dist: pytest; extra == 'all'
-Requires-Dist: pytest-cov; extra == 'all'
-Requires-Dist: pytest-mock; extra == 'all'
-Requires-Dist: ruff; extra == 'all'
-Requires-Dist: scipy; extra == 'all'
-Requires-Dist: seaborn; extra == 'all'
-Requires-Dist: solara; extra == 'all'
-Requires-Dist: sphinx; extra == 'all'
 Provides-Extra: dev
-Requires-Dist: matplotlib; extra == 'dev'
-Requires-Dist: networkx; extra == 'dev'
-Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: coverage; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
 Requires-Dist: pytest-mock; extra == 'dev'
-Requires-Dist: ruff; extra == 'dev'
-Requires-Dist: solara; extra == 'dev'
+Requires-Dist: pytest>=4.6; extra == 'dev'
+Requires-Dist: ruff~=0.1.1; extra == 'dev'
 Requires-Dist: sphinx; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: ipython; extra == 'docs'
-Requires-Dist: matplotlib; extra == 'docs'
 Requires-Dist: myst-nb; extra == 'docs'
 Requires-Dist: myst-parser; extra == 'docs'
-Requires-Dist: networkx; extra == 'docs'
 Requires-Dist: pydata-sphinx-theme; extra == 'docs'
 Requires-Dist: seaborn; extra == 'docs'
-Requires-Dist: solara; extra == 'docs'
 Requires-Dist: sphinx; extra == 'docs'
-Provides-Extra: examples
-Requires-Dist: matplotlib; extra == 'examples'
-Requires-Dist: networkx; extra == 'examples'
-Requires-Dist: pytest; extra == 'examples'
-Requires-Dist: scipy; extra == 'examples'
-Requires-Dist: solara; extra == 'examples'
-Provides-Extra: network
-Requires-Dist: networkx; extra == 'network'
-Provides-Extra: rec
-Requires-Dist: matplotlib; extra == 'rec'
-Requires-Dist: networkx; extra == 'rec'
-Requires-Dist: solara; extra == 'rec'
-Provides-Extra: viz
-Requires-Dist: matplotlib; extra == 'viz'
-Requires-Dist: solara; extra == 'viz'
 Description-Content-Type: text/markdown
 
 # Mesa: Agent-based modeling in Python
@@ -107,30 +75,13 @@ can be displayed in browser windows or Jupyter.*
 
 ## Using Mesa
 
-To install our latest stable release (3.0.x), run:
+Getting started quickly:
 
 ``` bash
-pip install -U mesa
+pip install mesa
 ```
 
-To install our latest pre-release, run:
-
-``` bash
-pip install -U --pre mesa
-```
-Starting with Mesa 3.0, we don't install all our dependencies anymore by default.
-```bash
-# You can customize the additional dependencies you need, if you want. Available are:
-pip install -U --pre mesa[network,viz]
-
-# This is equivalent to our recommended dependencies:
-pip install -U --pre mesa[rec]
-
-# To install all, including developer, dependencies:
-pip install -U --pre mesa[all]
-```
-
-You can also use `pip` to install the latest GitHub version:
+You can also use `pip` to install the github version:
 
 ``` bash
 pip install -U -e git+https://github.com/projectmesa/mesa@main#egg=mesa
@@ -142,18 +93,15 @@ Or any other (development) branch on this repo or your own fork:
 pip install -U -e git+https://github.com/YOUR_FORK/mesa@YOUR_BRANCH#egg=mesa
 ```
 
-## Resources
 For resources or help on using Mesa, check out the following:
 
 -   [Intro to Mesa Tutorial](http://mesa.readthedocs.org/en/stable/tutorials/intro_tutorial.html) (An introductory model, the Boltzmann
     Wealth Model, for beginners or those new to Mesa.)
--   [Visualization Tutorial](https://mesa.readthedocs.io/stable/tutorials/visualization_tutorial.html) (An introduction into our Solara visualization)
 -   [Complexity Explorer Tutorial](https://www.complexityexplorer.org/courses/172-agent-based-models-with-python-an-introduction-to-mesa) (An advanced-beginner model,
     SugarScape with Traders, with instructional videos)
--   [Mesa Examples](https://github.com/projectmesa/mesa-examples) (A repository of seminal ABMs using Mesa and
+-   [Mesa Examples](https://github.com/projectmesa/mesa-examples/tree/main/examples) (A repository of seminal ABMs using Mesa and
     examples of employing specific Mesa Features)
 -   [Docs](http://mesa.readthedocs.org/) (Mesa's documentation, API and useful snippets)
-    -   [Development version docs](https://mesa.readthedocs.io/latest/) (the latest version docs if you're using a pre-release Mesa version)
 -   [Discussions](https://github.com/projectmesa/mesa/discussions) (GitHub threaded discussions about Mesa)
 -   [Matrix Chat](https://matrix.to/#/#project-mesa:matrix.org) (Chat Forum via Matrix to talk about Mesa)
 

mesa-3.0.0a0.dist-info/RECORD

@@ -0,0 +1,38 @@
+mesa/__init__.py,sha256=HulQ0a6D9eQCogbsJEKTSLOt9SGOlPwMq7-DDlbmtaU,618
+mesa/agent.py,sha256=fx_h8RnX5DJCmfJtloIb_fprXXp8bFzC3_RnLOLlOvY,12902
+mesa/batchrunner.py,sha256=Kxi0pe2Zeg40R-J07JhEllkpBmREWb7RHuoTenLYEw0,6055
+mesa/datacollection.py,sha256=CQ2QsW-mkEVbDVTsOkLy8NAQEKeoILdLB0zWS2sxnyk,11444
+mesa/main.py,sha256=7MovfNz88VWNnfXP0kcERB6C3GfkVOh0hb0o32hM9LU,1602
+mesa/model.py,sha256=GqayRWhohSS96kMwHCNGI7XvEkwI8GHS2SRL6SZ9N5E,5810
+mesa/space.py,sha256=9eDEUQBcck8QYWvRn3fDw2zS2bO1Yjc7VjvvrMikzPE,62447
+mesa/time.py,sha256=9gNoyUqYkt_gUPFBMhm38pK87mcntwAZ1lJzxqW3BSA,15211
+mesa/cookiecutter-mesa/cookiecutter.json,sha256=tBSWli39fOWUXGfiDCTKd92M7uKaBIswXbkOdbUufYY,337
+mesa/cookiecutter-mesa/hooks/post_gen_project.py,sha256=8JoXZKIioRYEWJURC0udj8WS3rg0c4So62sOZSGbrMY,294
+mesa/cookiecutter-mesa/{{cookiecutter.snake}}/README.md,sha256=Yji4lGY-NtQSnW-oBj0_Jhs-XhCfZA8R1mBBM_IllGs,80
+mesa/cookiecutter-mesa/{{cookiecutter.snake}}/app.pytemplate,sha256=g0a-i2ihi4RJFGqVQSPqJ0Rbn3WXSh9s8dVwAfPIkCE,586
+mesa/cookiecutter-mesa/{{cookiecutter.snake}}/setup.pytemplate,sha256=UtRpLM_CkeUZRec-Ef_LiO_x7SKaWN11fOiH9T1UmTw,214
+mesa/cookiecutter-mesa/{{cookiecutter.snake}}/{{cookiecutter.snake}}/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mesa/cookiecutter-mesa/{{cookiecutter.snake}}/{{cookiecutter.snake}}/model.pytemplate,sha256=Aml4Z6E1yj7E7DtHNSUqnKNRUdkxG9WWtJyW8fkxCng,1870
+mesa/experimental/__init__.py,sha256=MaSRE9cTFIWwMZsbRKfnCiCBkhvtzJdgWlg3Dls7Unw,67
+mesa/experimental/cell_space/__init__.py,sha256=trFVKf2l5RbkCUyxP09Kox_J3ak2YdM4o3t40Tsjjm4,628
+mesa/experimental/cell_space/cell.py,sha256=AUnvVnXWhdgzr0bLKDRDO9c93v22Zkw6W-tWxhEhGdQ,4578
+mesa/experimental/cell_space/cell_agent.py,sha256=G4u9ht4gW9ns1y2L7pFumF3K4HiP6ROuxwrxHZ-mL1M,1107
+mesa/experimental/cell_space/cell_collection.py,sha256=4FmfDEg9LoFiJ0mF_nC8KUt9fCJ7Q21erjWPeBTQ_lw,2293
+mesa/experimental/cell_space/discrete_space.py,sha256=ta__YojsrrhWL4DgMzUqZpSgbeexKMrA6bxlYPJGfK0,1921
+mesa/experimental/cell_space/grid.py,sha256=gYDExuFBMF3OThUkhbXmolQFKBOqTukcibjfgXicP00,6948
+mesa/experimental/cell_space/network.py,sha256=mAaFHBdd4s9kxUWHbViovLW2-pU2yXH0dtY_vF8sCJg,1179
+mesa/experimental/devs/__init__.py,sha256=CWam15vCj-RD_biMyqv4sJfos1fsL823P7MDEGrbwW8,174
+mesa/experimental/devs/eventlist.py,sha256=AM-gpivXQ889Ewt66T_ai6Yy6ldx0G69Unu1lasSNxI,4907
+mesa/experimental/devs/simulator.py,sha256=0SMC7daIOyL2rYfoQOOTaTOYDos0gLeBUbU1Krd42HA,9557
+mesa/experimental/devs/examples/epstein_civil_violence.py,sha256=KqH9KI-A_BYt7oWi9kaOhTzjrf2pETqzSpAQG8ewud0,9667
+mesa/experimental/devs/examples/wolf_sheep.py,sha256=h5z-eDqMpYeOjrq293N2BcQbs_LDVsgtg9vblXJM7XQ,7697
+mesa/visualization/UserParam.py,sha256=WgnY3Q0padtGqUCaezgYzd6cZ7LziuIQnGKP3DBuHZY,1641
+mesa/visualization/__init__.py,sha256=0utc6SZqru1rhxhBxoFGeQNawLHen5RnILvon12Bd_8,104
+mesa/visualization/jupyter_viz.py,sha256=GKlLADaloVwdl5OQr0bxoXLUHBEozr5tUtZHQLg_Z9c,16987
+mesa/visualization/components/altair.py,sha256=V2CQ-Zr7PeijgWtYBNH3VklGVfrf1ee70XVh0DBBONQ,2366
+mesa/visualization/components/matplotlib.py,sha256=cmW3D2ebDcOd6TiBr_kHcBjhh8NeNEMNsz8eJP8N9sU,4289
+mesa-3.0.0a0.dist-info/METADATA,sha256=kyMeHZK6f-_eUgcMSoWoB-IGV6rWiShgrEvxkd9jCM8,7771
+mesa-3.0.0a0.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
+mesa-3.0.0a0.dist-info/entry_points.txt,sha256=IOcQtetGF8l4wHpOs_hGb19Rz-FS__BMXOJR10IBPsA,39
+mesa-3.0.0a0.dist-info/licenses/LICENSE,sha256=OGUgret9fRrm8J3pdsPXETIjf0H8puK_Nmy970ZzT78,572
+mesa-3.0.0a0.dist-info/RECORD,,

mesa-3.0.0.dist-info/licenses/NOTICE → mesa-3.0.0a0.dist-info/licenses/LICENSE

@@ -1,10 +1,10 @@
-Copyright 2014-2024 Core Mesa Team and contributors
+Copyright 2023 Core Mesa Team and contributors
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at
 
-    https://www.apache.org/licenses/LICENSE-2.0
+    http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,

mesa/examples/README.md

@@ -1,37 +0,0 @@
-# Mesa core examples
-These examples are a collection of classic agent based models built using Mesa. These core examples are maintained by the Mesa team and are intended to demonstrate the capabilities of Mesa.
-
-More user examples and showcases can be found in the [mesa-examples](https://github.com/projectmesa/mesa-examples) repository.
-
-## Basic Examples
-The basic examples are relatively simple and only use stable Mesa features. They are good starting points for learning how to use Mesa.
-
-### [Boltzmann Wealth Model](examples/basic/boltzmann_wealth_model)
-Completed code to go along with the [tutorial](https://mesa.readthedocs.io/latest/tutorials/intro_tutorial.html) on making a simple model of how a highly-skewed wealth distribution can emerge from simple rules.
-
-### [Boids Flockers Model](examples/basic/boid_flockers)
-[Boids](https://en.wikipedia.org/wiki/Boids)-style flocking model, demonstrating the use of agents moving through a continuous space following direction vectors.
-
-### [Conway's Game of Life](examples/basic/conways_game_of_life)
-Implementation of [Conway's Game of Life](https://en.wikipedia.org/wiki/Conway%27s_Game_of_Life), a cellular automata where simple rules can give rise to complex patterns.
-
-### [Schelling Segregation Model](examples/basic/schelling)
-Mesa implementation of the classic [Schelling segregation](http://nifty.stanford.edu/2014/mccown-schelling-model-segregation/) model.
-
-### [Virus on a Network Model](examples/basic/virus_on_network)
-This model is based on the NetLogo [Virus on a Network](https://ccl.northwestern.edu/netlogo/models/VirusonaNetwork) model.
-
-## Advanced Examples
-The advanced examples are more complex and may use experimental Mesa features. They are good starting points for learning how to build more complex models.
-
-### [Epstein Civil Violence Model](examples/advanced/epstein_civil_violence)
-Joshua Epstein's [model](https://www.pnas.org/doi/10.1073/pnas.092080199) of how a decentralized uprising can be suppressed or reach a critical mass of support.
-
-### [Demographic Prisoner's Dilemma on a Grid](examples/advanced/pd_grid)
-Grid-based demographic prisoner's dilemma model, demonstrating how simple rules can lead to the emergence of widespread cooperation -- and how a model activation regime can change its outcome.
-
-### [Sugarscape Model with Traders](examples/advanced/sugarscape_g1mt)
-This is Epstein & Axtell's Sugarscape model with Traders, a detailed description is in Chapter four of *Growing Artificial Societies: Social Science from the Bottom Up (1996)*. The model shows how emergent price equilibrium can happen via decentralized dynamics.
-
-### [Wolf-Sheep Predation Model](examples/advanced/wolf_sheep)
-Implementation of an ecological model of predation and reproduction, based on the NetLogo [Wolf Sheep Predation](http://ccl.northwestern.edu/netlogo/models/WolfSheepPredation) model.

mesa/examples/__init__.py

@@ -1,21 +0,0 @@
-from mesa.examples.advanced.epstein_civil_violence.model import EpsteinCivilViolence
-from mesa.examples.advanced.pd_grid.model import PdGrid
-from mesa.examples.advanced.sugarscape_g1mt.model import SugarscapeG1mt
-from mesa.examples.advanced.wolf_sheep.model import WolfSheep
-from mesa.examples.basic.boid_flockers.model import BoidFlockers
-from mesa.examples.basic.boltzmann_wealth_model.model import BoltzmannWealthModel
-from mesa.examples.basic.conways_game_of_life.model import ConwaysGameOfLife
-from mesa.examples.basic.schelling.model import Schelling
-from mesa.examples.basic.virus_on_network.model import VirusOnNetwork
-
-__all__ = [
-    "BoidFlockers",
-    "BoltzmannWealthModel",
-    "ConwaysGameOfLife",
-    "Schelling",
-    "VirusOnNetwork",
-    "EpsteinCivilViolence",
-    "PdGrid",
-    "SugarscapeG1mt",
-    "WolfSheep",
-]