mesa-geo

GIS Extension for Mesa Agent-Based Modeling

https://github.com/projectmesa/mesa-geo

Science Score: 77.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    2 of 12 committers (16.7%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (17.1%) to scientific vocabulary

Keywords

agent-based-modeling complex-systems geospatial-modeling gis mesa mesa-geo python simulation

Keywords from Contributors

agent-based-simulation complexity-analysis modeling-agents simulation-environment simulation-framework spatial-models mesh yolov5s optimizer interpretability
Last synced: 6 months ago · JSON representation ·

Repository

GIS Extension for Mesa Agent-Based Modeling

Basic Info
  • Host: GitHub
  • Owner: projectmesa
  • License: apache-2.0
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 2.1 MB
Statistics
  • Stars: 190
  • Watchers: 10
  • Forks: 67
  • Open Issues: 16
  • Releases: 16
Topics
agent-based-modeling complex-systems geospatial-modeling gis mesa mesa-geo python simulation
Created over 8 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct Citation

README.md

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: bash pip install -U mesa-geo

Mesa-Geo pre-releases can be installed with: bash pip install -U --pre mesa-geo

You can also use pip to install the GitHub version: bash 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: bash 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 click the "Cite this repository" button in the right sidebar of the repository landing page, and choose either the APA or BibTeX citation format.

Owner

  • Name: Project Mesa
  • Login: projectmesa
  • Kind: organization

Mesa is an open-source Python library for agent-based modeling, ideal for simulating complex systems and exploring emergent behaviors.

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite the associated paper (see preferred-citation)."
authors:
- family-names: Wang
  given-names: Boyu
  orcid: "https://orcid.org/0000-0001-9879-2138"
- family-names: Hess
  given-names: Vincent
  orcid: "https://orcid.org/0000-0002-9242-8500"
- family-names: Crooks
  given-names: Andrew
  orcid: "https://orcid.org/0000-0002-5034-6654"
title: "Mesa-Geo: A GIS Extension for the Mesa Agent-Based Modeling Framework in Python"
preferred-citation:
  type: conference-paper
  authors:
  - family-names: Wang
    given-names: Boyu
    orcid: "https://orcid.org/0000-0001-9879-2138"
  - family-names: Hess
    given-names: Vincent
    orcid: "https://orcid.org/0000-0002-9242-8500"
  - family-names: Crooks
    given-names: Andrew
    orcid: "https://orcid.org/0000-0002-5034-6654"
  doi: 10.1145/3557989.3566157
  url: "https://doi.org/10.1145/3557989.3566157"
  publisher:
    name: Association for Computing Machinery
  title: "Mesa-Geo: A GIS Extension for the Mesa Agent-Based Modeling Framework in Python"
  collection-title: "Proceedings of the 5th ACM SIGSPATIAL International Workshop on GeoSpatial Simulation"
  start: 1
  end: 10
  numpages: 10
  conference:
    name: "GeoSim '22"
    city: Seattle
    region: Washington
    country: USA
  year: 2022
  isbn: 9781450395373

GitHub Events

Total
  • Create event: 7
  • Release event: 2
  • Issues event: 9
  • Watch event: 32
  • Delete event: 2
  • Member event: 6
  • Issue comment event: 53
  • Push event: 38
  • Pull request review event: 8
  • Pull request event: 36
  • Fork event: 13
Last Year
  • Create event: 7
  • Release event: 2
  • Issues event: 9
  • Watch event: 32
  • Delete event: 2
  • Member event: 6
  • Issue comment event: 53
  • Push event: 38
  • Pull request review event: 8
  • Pull request event: 36
  • Fork event: 13

Committers

Last synced: about 2 years ago

All Time
  • Total Commits: 168
  • Total Committers: 12
  • Avg Commits per committer: 14.0
  • Development Distribution Score (DDS): 0.417
Past Year
  • Commits: 47
  • Committers: 5
  • Avg Commits per committer: 9.4
  • Development Distribution Score (DDS): 0.383
Top Committers
Name Email Commits
Wang Boyu b****y@g****m 98
Corvince v****s@u****t 23
pre-commit-ci[bot] 6****] 13
Corvince 1****e 12
Corvince v****s@p****e 4
rht r****t@p****m 4
dependabot[bot] 4****] 4
Catherine Devlin d****h@c****m 3
glicerico s****s@g****m 3
Majd Al-Shihabi m****l@g****m 2
Sascha Holzhauer S****r@u****e 1
dhruv4 d****4 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 63
  • Total pull requests: 164
  • Average time to close issues: 6 months
  • Average time to close pull requests: 4 days
  • Total issue authors: 22
  • Total pull request authors: 10
  • Average comments per issue: 3.14
  • Average comments per pull request: 2.48
  • Merged pull requests: 147
  • Bot issues: 1
  • Bot pull requests: 40
Past Year
  • Issues: 7
  • Pull requests: 44
  • Average time to close issues: 22 days
  • Average time to close pull requests: 5 days
  • Issue authors: 7
  • Pull request authors: 6
  • Average comments per issue: 1.29
  • Average comments per pull request: 1.98
  • Merged pull requests: 40
  • Bot issues: 1
  • Bot pull requests: 15
Top Authors
Issue Authors
  • wang-boyu (33)
  • SongshGeo (3)
  • EwoutH (3)
  • eecoo (2)
  • Corvince (2)
  • giacrava (2)
  • Harshpanday (2)
  • jackiekazil (2)
  • rcriii42 (1)
  • PRIYANSHU2026 (1)
  • mrceresa (1)
  • tpike3 (1)
  • NickGotts (1)
  • dependabot[bot] (1)
  • majdal (1)
Pull Request Authors
  • wang-boyu (96)
  • EwoutH (39)
  • pre-commit-ci[bot] (37)
  • tpike3 (29)
  • dependabot[bot] (10)
  • rht (6)
  • SongshGeo (2)
  • catherinedevlin (1)
  • PRIYANSHU2026 (1)
  • Holzhauer (1)
  • AdamZh0u (1)
Top Labels
Issue Labels
enhancement (18) sprint (6) bug (5) help wanted (4) docs (4) good first issue (2) breaking (2) maintenance (2) wontfix (1) question (1) feature (1) dependency (1) ignore-for-release (1) ci (1)
Pull Request Labels
ignore-for-release (51) docs (24) ci (19) bug (14) dependency (12) enhancement (10) maintenance (10) dependencies (4) breaking (4) packaging (3) testing (3) feature (2) github_actions (1)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 1,474 last-month
  • Total dependent packages: 2
  • Total dependent repositories: 3
  • Total versions: 16
  • Total maintainers: 3
pypi.org: mesa-geo

GIS Agent-based modeling (ABM) in Python

  • Versions: 16
  • Dependent Packages: 2
  • Dependent Repositories: 3
  • Downloads: 1,474 Last month
Rankings
Forks count: 5.8%
Stargazers count: 6.5%
Dependent packages count: 7.3%
Average: 7.3%
Downloads: 8.0%
Dependent repos count: 9.1%
Maintainers (3)
Last synced: 6 months ago

Dependencies

.github/workflows/build_lint.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v3 composite
  • codecov/codecov-action v2 composite
pyproject.toml pypi
setup.py pypi