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 -U mesa-geo

Mesa-Geo pre-releases can be installed with:

pip install -U --pre mesa-geo

You can also use pip to install the GitHub version:

pip install -U -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.9.1.tar.gz (71.8 kB view details)

Uploaded Source

Built Distribution

mesa_geo-0.9.1-py3-none-any.whl (31.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mesa_geo-0.9.1.tar.gz
  • Upload date:
  • Size: 71.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for mesa_geo-0.9.1.tar.gz
Algorithm Hash digest
SHA256 d0e6cc596c9178ac7b341f6d7ae415d867c37cc157d19f1f3fa4e7ddb36ac23a
MD5 05ea900ec3adad15378d54297304e3b7
BLAKE2b-256 8a25f681bb46e6655860d65b5635e0ba5d1012df62218d36c2bcd41d179db3c0

See more details on using hashes here.

Provenance

The following attestation bundles were made for mesa_geo-0.9.1.tar.gz:

Publisher: release.yml on projectmesa/mesa-geo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

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

File metadata

  • Download URL: mesa_geo-0.9.1-py3-none-any.whl
  • Upload date:
  • Size: 31.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for mesa_geo-0.9.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5678d06f0d8d8e8f1ac5f7bb5526a23a583188025aa75e3d3f84d434bfb3a0b4
MD5 73df3afa36652cbbb578e7b0eef6596a
BLAKE2b-256 3022f3c3764f1450a0d8c33916644b1371b58add28b3427d9079ff30f56097e5

See more details on using hashes here.

Provenance

The following attestation bundles were made for mesa_geo-0.9.1-py3-none-any.whl:

Publisher: release.yml on projectmesa/mesa-geo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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