ABSESpy: Agent-Based Social-ecological systems Modelling Framework in Python

10月 10, 2021

ABSESpy

ABSESpy makes it easier to build artificial Social-ecological systems with real GeoSpatial datasets and fully incorporate human behaviour.

Why `ABSESpy`?

Several characteristics of Agent-Based model (ABM) make it an essential method for social-ecological systems (SES) research:

It focuses on the change of an SES over time from mutual adaptations of agents and their environments.
its ability to generate emergent system-level outcomes from micro-level interactions and macro-level feedback.
its ability to represent the diversity and heterogeneity of human and non-human actors and the spatial characteristics of an SES …

However, there is currently no modelling framework that combines geo-spatial data and actor behaviour (actor is the term for agents in the SES framework) well. ABSESpy is designed for spatial modelling that couples human and nature by:

Modelling environment for agents with geo data: Shapefile, GeoTiff, NetCDF.
Modelling human behaviour of agents with cognition, contagion and responses.
Easily manage all parameters, arguments, and variables with a yaml settings file.

Install

Install with pip or your favourite PyPI package manager.

pip install abses

Basic usage & Documents

You can see how to use ABSESpy in these simple tutorials:

Organize an Agent-based model and easily manage parameters.
Using geo-spatial data as the environment.
Simply applying a human behavior framework.

Access the full Documentation here.

Get in touch

For enthusiastic developers and contributors, all contributions, bug reports, bug fixes, documentation improvements, enhancements, and ideas are welcome.
For SES researchers, welcome to use this package in social-ecological system (SES) studies. If you have a model published, feel free to contribute it to our model library through mailing list.

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.
Report bugs, suggest features or view the source code on GitHub.
For less well-defined questions or ideas or to announce other projects of interest to xarray users, use the mailing list.

License

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

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 AgentPy, pandas, NumPy and Xarray; the full text of these licenses is included in the licenses directory.