You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
J. Fernando Sánchez 5559d37e57 version 0.20.4 1 week ago
docs Update examples 2 months ago
examples Bug fixes and minor improvements 2 weeks ago
soil version 0.20.4 1 week ago
tests Bug fixes and minor improvements 2 weeks ago
.dockerignore Fix Windows bug 2 years ago
.gitignore Partial MESA compatibility and several fixes 7 months ago
.gitlab-ci.yml CI: delay PyPI check 3 months ago
CHANGELOG.md version 0.20.4 1 week ago
Dockerfile Python3.7, testing and bug fixes 4 years ago
LICENSE Create LICENSE 6 years ago
MANIFEST.in 0.13.8 3 years ago
Makefile Avoid writing gexf in test 3 years ago
README.md Partial MESA compatibility and several fixes 7 months ago
debug.py WIP soil 5 years ago
docker-compose.yml Python3.7, testing and bug fixes 4 years ago
logo_gsi.png added logos 5 years ago
logo_gsi.svg Added GSI logo 5 years ago
requirements.txt Partial MESA compatibility and several fixes 7 months ago
setup.cfg Python3.7, testing and bug fixes 4 years ago
setup.py WIP: mesa compatibility 7 months ago
test-requirements.txt WIP: mesa compatibility 7 months ago

README.md

SOIL

Soil is an extensible and user-friendly Agent-based Social Simulator for Social Networks. Learn how to run your own simulations with our documentation.

Follow our tutorial to develop your own agent models.

Citation

If you use Soil in your research, don't forget to cite this paper:

@inbook{soil-gsi-conference-2017,
    author = "S{\'a}nchez, Jes{\'u}s M. and Iglesias, Carlos A. and S{\'a}nchez-Rada, J. Fernando",
    booktitle = "Advances in Practical Applications of Cyber-Physical Multi-Agent Systems: The PAAMS Collection",
    doi = "10.1007/978-3-319-59930-4_19",
    editor = "Demazeau Y., Davidsson P., Bajo J., Vale Z.",
    isbn = "978-3-319-59929-8",
    keywords = "soil;social networks;agent based social simulation;python",
    month = "June",
    organization = "PAAMS 2017",
    pages = "234-245",
    publisher = "Springer Verlag",
    series = "LNAI",
    title = "{S}oil: {A}n {A}gent-{B}ased {S}ocial {S}imulator in {P}ython for {M}odelling and {S}imulation of {S}ocial {N}etworks",
    url = "https://link.springer.com/chapter/10.1007/978-3-319-59930-4_19",
    volume = "10349",
    year = "2017",
}

Mesa compatibility

Soil is in the process of becoming fully compatible with MESA. As of this writing,

This is a non-exhaustive list of tasks to achieve compatibility:

  • Environments.agents and mesa.Agent.agents are not the same. env is a property, and it only takes into account network and environment agents. Might rename environment_agents to other_agents or sth like that
  • Integrate soil.Simulation with mesa's runners:
    • soil.Simulation could mimic/become a mesa.batchrunner
  • Integrate soil.Environment with mesa.Model:
    • Soil.Environment inherits from mesa.Model
    • Soil.Environment includes a Mesa-like Scheduler (see the soil.time module.
  • Integrate soil.Agent with mesa.Agent:
    • Rename agent.id to unique_id?
    • mesa agents can be used in soil simulations (see examples/mesa)
  • Document the new APIs and usage

@Copyright GSI - Universidad Politécnica de Madrid 2017-2021

SOIL