mirror of https://github.com/gsi-upm/soil synced 2024-11-21 18:52:28 +00:00

Go to file

J. Fernando Sánchez 9165979b49 merge visualization branch The web server is included as a submodule. The dependencies for the web (tornado) are not installed by default, but they can be installed as an extra: ``` pip install soil[web] ``` Once installed, the soil web can be used like this: ``` soil-web OR python -m soil.web ``` There are other minor changes: * History re-connects to the sqlite database if it is used from a different thread. * Environment accepts additional parameters (so it can run simulations with `visualization_params` or any other in the future). * The simulator class is no longer necessary * Logging is done in the same thread, and the simulation is run in a separate one. This had to be done because it was creating some problems with tornado not being able to find the current thread during logs, which caused hundreds of repeated lines in the web "console". * The player is slightly modified in this version. I noticed that when the visualization was playing, if you clicked somewhere it would change for a second, and then go back to the previous place. The code for the playback seemed too complex, especially speed control, so I rewrote some parts. I might've introduced new bugs.		2018-12-07 18:28:19 +01:00
docs	Improved docs	2017-10-19 18:06:33 +02:00
examples	Added history class	2018-05-04 10:01:49 +02:00
soil	merge visualization branch	2018-12-07 18:28:19 +01:00
tests	Fix state and networkx dynamic attributes	2018-05-07 18:59:19 +02:00
.gitignore	WIP soil	2017-07-03 18:17:52 +02:00
debug.py	WIP soil	2017-07-03 18:17:52 +02:00
docker-compose.yml	merge visualization branch	2018-12-07 18:28:19 +01:00
Dockerfile	merge visualization branch	2018-12-07 18:28:19 +01:00
LICENSE	Create LICENSE	2016-05-30 11:35:09 +02:00
logo_gsi.png	added logos	2017-01-28 11:37:52 +01:00
logo_gsi.svg	Added GSI logo	2017-01-28 10:57:45 +01:00
MANIFEST.in	WIP soil	2017-07-03 18:17:52 +02:00
README.md	Improved docs	2017-10-19 18:06:33 +02:00
requirements.txt	Added history class	2018-05-04 10:01:49 +02:00
setup.py	merge visualization branch	2018-12-07 18:28:19 +01:00
test-requirements.txt	WIP soil	2017-07-03 18:17:52 +02:00

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.

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",
}