Agents.jl is a Julia framework for agent-based modeling (ABM). It provides a structure and components for quickly implementing agent-based models, run them in batch, collect data, and visualize them. To that end, it provides the following functionalities:
- Default grids to run the simulation, including simple or toroidal 1D grids, simple or toroidal regular rectangular and triangular 2D grids, and simple or toroidal regular cubic 3D grids with von Neumann or Moore neighborhoods. More space structure are to be implemented include arbitrary random networks.
- Running the simulations in parallel on multiple cores.
- Automatic data collection in a
DataFrameat desired intervals. - Exploring the simulation results interactively in Data Voyager 2.
- Batch running and batch data collection
- Visualize agent distributions on grids
Julia is a language that is especially suitable for ABMs, because a) it runs fast, b) it is easy to express your ideas in and quick to write, and c) it has rich and easy-to-use packages for data analysis.
Agents.jl is lightweight and modular. It has a short learning curve, and allows one to extend its capabilities and express complicated modeling scenarios. Agents.jl is inspired by Mesa framework for Python.
Install using the following command inside Julia:
]add AgentsIt is compatible with Julia 0.7+.
For a tutorial, read the docs:
Any contribution to Agents.jl is welcome in the following ways:
- Modifying the code or documentation with a pull request.
- Reporting bugs and suggestions in the issues section of the project's Github.
Modifications to the documentation can be previewed by building the documentation locally, which is made possible by a script located in docs/make.jl. The Documenter package is required and can be installed by running import Pkg; Pkg.add("Documenter") in a REPL session. Then the documentation can be built and previewed in build/ first by running julia docs/make.jl from a terminal.