Metadata-Version: 2.4
Name: abses
Version: 0.9.1
Summary: ABSESpy makes it easier to build artificial Social-ecological systems with real GeoSpatial datasets and fully incorporate human behaviour.
Project-URL: Homepage, https://github.com/SongshGeoLab/ABSESpy
Project-URL: Documentation, https://absespy.github.io/ABSESpy/
Project-URL: Repository, https://github.com/SongshGeoLab/ABSESpy
Author-email: Shuang Song <songshgeo@gmail.com>
License: Apache 2.0 License
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: <3.14,>=3.11
Requires-Dist: fiona>1.8
Requires-Dist: fontawesome>=5
Requires-Dist: geocube>=0.5.0
Requires-Dist: geopandas<1,>=0
Requires-Dist: hydra-core<1.4,>=1.3
Requires-Dist: icons
Requires-Dist: loguru>=0.7
Requires-Dist: mesa-geo>=0.9.1
Requires-Dist: mesa>=3.1.0
Requires-Dist: netcdf4>=1.6
Requires-Dist: numpy<2
Requires-Dist: pendulum>=3.0.0
Requires-Dist: rioxarray>=0.13
Requires-Dist: seaborn>=0.13
Requires-Dist: typing-extensions<5,>=4
Requires-Dist: urllib3
Requires-Dist: xarray>=2023
Provides-Extra: docs
Requires-Dist: mike>=2.0.0; extra == 'docs'
Requires-Dist: mkdocs-awesome-pages-plugin>=2.9.2; extra == 'docs'
Requires-Dist: mkdocs-bibtex>=2.11.0; extra == 'docs'
Requires-Dist: mkdocs-callouts>=1.9.1; extra == 'docs'
Requires-Dist: mkdocs-exclude>=1.0.2; extra == 'docs'
Requires-Dist: mkdocs-git-authors-plugin>=0.7.2; extra == 'docs'
Requires-Dist: mkdocs-git-revision-date-localized-plugin>=1.2.0; extra == 'docs'
Requires-Dist: mkdocs-glightbox>=0.3.4; extra == 'docs'
Requires-Dist: mkdocs-jupyter>=0.25.1; extra == 'docs'
Requires-Dist: mkdocs-macros-plugin>=1.0.4; extra == 'docs'
Requires-Dist: mkdocs-minify-plugin>=0.7.1; extra == 'docs'
Requires-Dist: mkdocs-redirects>=1.2.1; extra == 'docs'
Requires-Dist: mkdocs-simple-hooks>=0.1.5; extra == 'docs'
Requires-Dist: mkdocs-static-i18n>=1.3.0; extra == 'docs'
Requires-Dist: mkdocs>=1.6.1; extra == 'docs'
Requires-Dist: mkdocstrings>=0.30.1; extra == 'docs'
Requires-Dist: mkdocstrings[python]>=0.24.0; extra == 'docs'
Requires-Dist: nbconvert>=7.16.6; extra == 'docs'
Requires-Dist: nbmake>=1.5.5; extra == 'docs'
Requires-Dist: pymdown-extensions>=10.7; extra == 'docs'
Description-Content-Type: text/markdown

# ABSESpy: Agent-Based Modeling Framework for Social-Ecological Systems

![ABSES_banner](https://songshgeo-picgo-1302043007.cos.ap-beijing.myqcloud.com/uPic/CleanShot%202023-10-19%20at%2019.08.12@2x.png)

<div align="center"><p>
    <a href="https://github.com/SongshGeoLab/ABSESpy/actions">
        <img alt="Tests" src="https://img.shields.io/github/actions/workflow/status/SongshGeoLab/ABSESpy/tests.yml?branch=dev&style=for-the-badge&logo=github&label=Tests&color=C9CBFF&logoColor=D9E0EE&labelColor=302D41" />
    </a>
    <a href="https://www.python.org/">
        <img alt="Python" src="https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-blue?style=for-the-badge&logo=python&color=8bd5ca&logoColor=D9E0EE&labelColor=302D41" />
    </a>
    <a href="#contributors-">
        <img alt="Contributors" src="https://img.shields.io/badge/all_contributors-1-orange.svg?style=for-the-badge&logo=probot&color=C9CBFF&logoColor=D9E0EE&labelColor=302D41" />
    </a>
    <a href="https://github.com/SongshGeoLab/ABSESpy/releases/latest">
        <img alt="Latest release" src="https://img.shields.io/github/v/release/SongshGeoLab/ABSESpy?style=for-the-badge&logo=probot&color=C9CBFF&logoColor=D9E0EE&labelColor=302D41" />
    </a>
    <a href="https://github.com/SongshGeoLab/ABSESpy/pulse">
        <img alt="Last commit" src="https://img.shields.io/github/last-commit/SongshGeoLab/ABSESpy?style=for-the-badge&logo=probot&color=8bd5ca&logoColor=D9E0EE&labelColor=302D41"/>
    </a>
    <a href="https://github.com/SongshGeoLab/ABSESpy/blob/main/LICENSE">
        <img alt="License" src="https://img.shields.io/github/license/SongshGeoLab/ABSESpy?style=for-the-badge&logo=probot&color=ee999f&logoColor=D9E0EE&labelColor=302D41" />
    </a>
    <a href="https://github.com/SongshGeoLab/ABSESpy/stargazers">
        <img alt="Stars" src="https://img.shields.io/github/stars/SongshGeoLab/ABSESpy?style=for-the-badge&logo=probot&color=c69ff5&logoColor=D9E0EE&labelColor=302D41" />
    </a>
    <a href="https://github.com/SongshGeoLab/ABSESpy/issues">
        <img alt="Issues" src="https://img.shields.io/github/issues/SongshGeoLab/ABSESpy?style=for-the-badge&logo=probot&color=F5E0DC&logoColor=D9E0EE&labelColor=302D41" />
    </a>
    <a href="https://github.com/SongshGeoLab/ABSESpy">
        <img alt="Repo Size" src="https://img.shields.io/github/repo-size/SongshGeoLab/ABSESpy?color=%23DDB6F2&label=SIZE&logo=codesandbox&style=for-the-badge&logoColor=D9E0EE&labelColor=302D41" />
    </a>

<a href="https://twitter.com/intent/follow?screen_name=shuangsong11">
    <img alt="follow on Twitter" src="https://img.shields.io/twitter/follow/shuangsong11?style=for-the-badge&logo=twitter&color=8aadf3&logoColor=D9E0EE&labelColor=302D41" />
</a>

<!-- Website Badge -->
<a href="https://cv.songshgeo.com/">
    <img src="https://img.shields.io/badge/Website-SongshGeo-brightgreen.svg?style=for-the-badge&logo=twitter&color=8aadf3&logoColor=D9E0EE&labelColor=302D41" alt="github">
</a>

  <!-- <p align="center">
    <img src="https://stars.medv.io/SongshGeoLab/ABSESpy.svg", title="commits"/>
  </p> -->

---
Language: [English Readme] | [简体中文]

**[<kbd> <br> Install <br> </kbd>][Install]**
**[<kbd> <br> Getting started <br> </kbd>][Getting Started]**
**[<kbd> <br> Tutorials <br> </kbd>][Tutorials]**
**[<kbd> <br> Contribute <br> </kbd>][Contribute]**

</div>

`ABSESpy` is a novel agent-based modeling (ABM) framework that facilitates socio-ecological systems (SES) research. It serves as an extension package of [Mesa], the most popular ABM framework, and further enhances agents' interactions with other components, especially grid-like spaces. With a configuration file for managing parameters and an improved data Input/Output system, `ABSESpy`'s modularity and low-coupling design enable elegant maintenance of large modeling projects. In addition, `ABSESpy` includes a schedule that aligns models' tick with the calendar time. These innovations position `ABSESpy` as a valuable tool in fostering more ABMs for real-world SES issues. Its ultimate aim is to become the go-to choice for ABM when working with a human-involved changing world.

## Features

<img src="https://songshgeo-picgo-1302043007.cos.ap-beijing.myqcloud.com/uPic/ABSESpy%20API.jpg" alt="ABSESpy API structure" style="max-width:400px;max-height:400px;width:auto;height:auto;">


- 🌍 Modeling social-ecological system with geo-data.
- 🤖 Managing and manipulating agents with ease of cake.
- 🕙 Make your model coherent with real-world time.
- 📁 Handling complex models with a configuration file.
- 🙋 and more...

  [Mesa]: https://github.com/projectmesa/mesa
  [Contribute]: https://absespy.github.io/ABSESpy/home/contribution/
  [Getting Started]: https://absespy.github.io/ABSESpy/home/get_started/
  [Install]: https://absespy.github.io/ABSESpy/home/Installation/
  [Tutorials]: https://absespy.github.io/ABSESpy/tutorial/tutorial/
  [简体中文]: README.zh-cn.md
  [English Readme]: README.md

## Contributors ✨

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
  <tbody>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="http://cv.songshgeo.com"><img src="https://avatars.githubusercontent.com/u/45836839?v=4?s=100" width="100px;" alt="Shuang Song"/><br /><sub><b>Shuang Song</b></sub></a><br /><a href="https://github.com/SongshGeoLab/ABSESpy/commits?author=SongshGeo" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/ekmanib"><img src="https://avatars.githubusercontent.com/u/94269701?v=4?s=100" width="100px;" alt="Elías José Mantilla Ibarra"/><br /><sub><b>Elías José Mantilla Ibarra</b></sub></a><br /><a href="https://github.com/SongshGeoLab/ABSESpy/commits?author=ekmanib" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/CtJiao"><img src="https://avatars.githubusercontent.com/u/94903112?v=4?s=100" width="100px;" alt="Chentai Jiao"/><br /><sub><b>Chentai Jiao</b></sub></a><br /><a href="https://github.com/SongshGeoLab/ABSESpy/commits?author=CtJiao" title="Documentation">📖</a></td>
    </tr>
  </tbody>
</table>

<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!