Metadata-Version: 2.1
Name: abses
Version: 0.2.0a0
Summary: ABSESpy makes it easier to build artificial Social-ecological systems with real GeoSpatial datasets and fully incorporate human behaviour.
License: Apache 2.0 License
Author: Shuang Song
Author-email: songshgeo@gmail.com
Requires-Python: >=3.9,<4
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: fiona (>=1.9.4.post1,<2.0.0)
Requires-Dist: hydra-core (>=1.3.2,<2.0.0)
Requires-Dist: mesa-geo (>=0.5.0,<0.6.0)
Requires-Dist: netcdf4 (>=1.6.2,<2.0.0)
Requires-Dist: pint (>=0.20.1,<0.21.0)
Requires-Dist: prettytable (>=3.6.0,<4.0.0)
Requires-Dist: xarray (>=2023.8.0,<2024.0.0)
Description-Content-Type: text/markdown

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


<div style="text-align: center;">
    <!-- License Badge -->
    <a href="http://www.apache.org/licenses/">
        <img src="https://img.shields.io/github/license/songshgeo/absespy" alt="license">
    </a>
    <!-- Downloads Badge -->
    <img src="https://img.shields.io/github/downloads/songshgeo/absespy/total" alt="downloads">
    <!-- Code Size Badge -->
    <img src="https://img.shields.io/github/languages/code-size/songshgeo/absespy" alt="codesize">
    <!-- Tag Badge -->
    <img src="https://img.shields.io/github/v/tag/songshgeo/absespy" alt="tag">
    <br>
    <!-- Website Badge -->
    <a href="https://cv.songshgeo.com/">
        <img src="https://img.shields.io/badge/Website-SongshGeo-brightgreen.svg" alt="github">
    </a>
    <!-- Stars Badge -->
    <img src="https://img.shields.io/github/stars/songshgeo/absespy?style=social" alt="stars">
    <!-- Twitter Badge -->
    <a href="https://twitter.com/shuangsong11">
        <img src="https://img.shields.io/twitter/follow/shuangsong11?style=social" alt="twitter">
    </a>
</div>

<!-- Language: [English Readme](#) | [简体中文](README_ch) -->

An Agent-Based computational framework makes modeling artificial **[Social-ecological systems](https://songshgeo.github.io/ABSESpy/docs/about/)** easier.

## Why `ABSESpy`?

Agent-based model (ABM) is essential for social-ecological systems (SES) research. `ABSESpy` is designed for modeling **couples humans and nature systems** by:

- Allow users to develop modules separately and coupling them together.
- Automatically portray interactions between social actors and natural cells with `Networkx`
- By applying a [human behavior modeling framework]((https://songshgeo.github.io/ABSESpy/docs/background/#human-behaviour-framework)), users can define, select, and track agents of the model in more intuitive ways.
- Manage and test complex parameters [with a `yaml` file](https://songshgeo.github.io/ABSESpy/tutorial/notebooks/parameters/).
- access information between cells and social actors by their locations
- Auto-update real-world datasets and relate the ticks counter to the real-world time.
## Basic Usage & Documents

Install with pip or your favorite PyPI package manager.

```
pip install abses
```

Access the [Documentation here](https://songshgeo.github.io/ABSESpy/).

<img src="https://songshgeo-picgo-1302043007.cos.ap-beijing.myqcloud.com/uPic/DQg0xJ.jpg" alt="Drawing" style="width: 600px;"/>

## Get in touch

- **For enthusiastic developers and contributors**, all contributions, bug reports, bug fixes, documentation improvements, enhancements, and ideas are welcome.
- **SES researchers** are welcome to use this package in social-ecological system (SES) studies. It would be appreciated if you contribute a published model to our gallery.

If you need any help when using `ABSESpy`, don't hesitate to get in touch with us through:

- Ask usage questions ("How to do?") on [_GitHub_ Discussions](https://github.com/SongshGeo/ABSESpy/discussions).
- Report bugs, suggest features, or view the source code [on _GitHub_ Issues](https://github.com/SongshGeo/ABSESpy/issues).
- Use the [mailing list](https://groups.google.com/g/absespy) for less well-defined questions or ideas or to announce other projects of interest to `ABSESpy` users.

## License

Copyright 2023, `ABSESpy` [Shuang Song](https://cv.songshgeo.com/)

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

[https://www.apache.org/licenses/LICENSE-2.0](https://www.apache.org/licenses/LICENSE-2.0)

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

`ABSESpy` bundles portions of `Mesa`, `mesa-geo`, `pandas`, `NumPy`, and `Xarray`; the full text of these licenses are included in the licenses directory.

## Thanks to all contributors

<a href="https://github.com/ABSESpy/ABSESpy/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=ABSESpy/ABSESpy" />
</a>

