Skip to main content

GIS Agent-based modeling (ABM) in Python

Project description

Mesa-Geo: GIS Extension for Mesa Agent-Based Modeling

CI/CD GitHub CI Read the Docs Codecov
Package PyPI PyPI - License PyPI - Downloads
Meta linting - Ruff code style: black Hatch project DOI
Chat chat

Mesa-Geo implements a GeoSpace that can host GIS-based GeoAgents, which are like normal Agents, except they have a geometry attribute that is a Shapely object and a crs attribute for its Coordinate Reference System. You can use Shapely directly to create arbitrary geometries, but in most cases you will want to import your geometries from a file. Mesa-Geo allows you to create GeoAgents from any vector data file (e.g. shapefiles), valid GeoJSON objects or a GeoPandas GeoDataFrame.

Using Mesa-Geo

To install Mesa-Geo, run

pip install mesa-geo

You can also use pip to install the GitHub version:

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

Or any other (development) branch on this repo or your own fork:

pip install -U -e git+https://github.com/YOUR_FORK/mesa-geo@YOUR_BRANCH#egg=mesa-geo

Take a look at the examples repository for sample models demonstrating Mesa-Geo features.

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

Contributing to Mesa-Geo

Want to join the team or just curious about what is happening with Mesa & Mesa-Geo? You can...

  • Join our Matrix chat room in which questions, issues, and ideas can be (informally) discussed.
  • Come to a monthly dev session (you can find dev session times, agendas and notes at Mesa discussions.
  • Just check out the code at GitHub.

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 join a dev session (see Mesa discussions). A feature is most likely to be added if you build it!

Don't forget to check out the Contributors guide.

Citing Mesa-Geo

To cite Mesa-Geo in your publication, you can use the CITATION.bib.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mesa_geo-0.8.1.tar.gz (66.7 kB view details)

Uploaded Source

Built Distribution

mesa_geo-0.8.1-py3-none-any.whl (23.5 kB view details)

Uploaded Python 3

File details

Details for the file mesa_geo-0.8.1.tar.gz.

File metadata

  • Download URL: mesa_geo-0.8.1.tar.gz
  • Upload date:
  • Size: 66.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.5

File hashes

Hashes for mesa_geo-0.8.1.tar.gz
Algorithm Hash digest
SHA256 b0af1bc36661be5b193c1d3edbbf94518a2afed2b9e1ef074fa34cf665e0c124
MD5 09d7aed0a1454c7a9765104794169d9f
BLAKE2b-256 6a6075f57dc885936391b80e0260658c47e5b133f08f43e490d18c9b08c79538

See more details on using hashes here.

File details

Details for the file mesa_geo-0.8.1-py3-none-any.whl.

File metadata

  • Download URL: mesa_geo-0.8.1-py3-none-any.whl
  • Upload date:
  • Size: 23.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.5

File hashes

Hashes for mesa_geo-0.8.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9691b794dfd56350ac4846463072bdd82b4d2398185f1c189d975975ce2d7c96
MD5 5f8d52e3e471450af1c36291e7c2621f
BLAKE2b-256 748b98f20c7c5d31e25295c9ab887de0bbd5f6c5e90abfdd1ecb3f0e23c4d818

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page