Skip to content

Mesa is an agent-based modeling framework in Python

License

Notifications You must be signed in to change notification settings

jaslinshaleem54/mesa

This branch is 1336 commits behind projectmesa/mesa:main.

Folders and files

NameName
Last commit message
Last commit date
Jul 14, 2018
Oct 30, 2020
May 10, 2020
Oct 29, 2020
Oct 29, 2020
May 28, 2019
Apr 26, 2020
Sep 24, 2020
Sep 25, 2019
Oct 30, 2020
Aug 27, 2020
May 14, 2018
May 12, 2020
Oct 4, 2018
May 6, 2020
May 8, 2020
Jun 10, 2020
May 7, 2019
May 7, 2019
Apr 7, 2020
Oct 4, 2018
Aug 24, 2018
Oct 30, 2020

Repository files navigation

Mesa: Agent-based modeling in Python 3+

https://api.travis-ci.org/projectmesa/mesa.svg?branch=master

Mesa is an Apache2 licensed agent-based modeling (or ABM) framework in Python.

It allows users to quickly create agent-based models using built-in core components (such as spatial grids and agent schedulers) or customized implementations; visualize them using a browser-based interface; and analyze their results using Python's data analysis tools. Its goal is to be the Python 3-based alternative to NetLogo, Repast, or MASON.

A screenshot of the Schelling Model in Mesa

Above: A Mesa implementation of the Schelling segregation model, being visualized in a browser window and analyzed in a Jupyter notebook.

Features

  • Modular components
  • Browser-based visualization
  • Built-in tools for analysis
  • Example model library

Using Mesa

Getting started quickly:

$ pip install mesa

You can also use pip to install the github version:

$ pip install -e git+https://github.com/projectmesa/mesa#egg=mesa

Take a look at the examples folder for sample models demonstrating Mesa features.

For more help on using Mesa, check out the following resources:

Running Mesa in Docker

You can run Mesa in a Docker container in a few ways.

If you are a Mesa developer, first install docker-compose and then run:

$ docker-compose build --pull
...
$ docker-compose up -d dev # start the docker container
$ docker-compose exec dev bash # enter the docker container that has your current version of Mesa installed at /opt/mesa
$ mesa runserver examples/Schelling # or any other example model in examples

The docker-compose file does two important things:

  • It binds the docker container's port 8521 to your host system's port 8521 so you can interact with the running model as usual by visiting localhost:8521 on your browser
  • It mounts the mesa root directory (relative to the docker-compose.yml file) into /opt/mesa and runs pip install -e on that directory so your changes to mesa should be reflected in the running container.

If you are a model developer that wants to run Mesa on a model (assuming you are currently in your top-level model directory with the run.py file):

$ docker run --rm -it -p127.0.0.1:8521:8521 -v${PWD}:/code comses/mesa:dev mesa runserver /code

Contributing back to Mesa

If you run into an issue, please file a ticket for us to discuss. If possible, follow up with a pull request.

If you would like to add a feature, please reach out via ticket or the dev email list for discussion. A feature is most likely to be added if you build it!

About

Mesa is an agent-based modeling framework in Python

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 74.9%
  • JavaScript 23.1%
  • HTML 1.7%
  • Other 0.3%