pop2net 1.2.3

Pop2net is a Python package designed to generate and manage relations between agents in agent-based models in a simple and flexible way.

Pop2net

Pop2net is a Python package that combines many steps related to network generation and management for agent-based modeling using a bipartite approach: In Pop2net, relations are represented as a graph of actors and locations. While actors are the active entities within an agent-based model, locations act as a contact layer, representing specific contexts through which actors connect. This makes it easy to generate and manage custom network structures in an agent-based model.

Pop2net can be used within custom modeling frameworks and also integrates seamlessly with the agent-based modeling frameworks AgentPy and Mesa.

Installation

You can install Pop2net using pip:

pip install pop2net

Python 3.14.1 has a bug which causes networkX to crash, see this issue. If you use Python 3.14, make sure to use any other path version that 3.14.1.

Documentation

Detailed documentation of all features and a collection of example analyses can be found here.

How to contribute

Contributions are welcome!
See this guide for details on how to get started.

Citation

If you are using Pop2net, please cite the corresponding software release paper in the Journal of Open Source Software:

• Kaffai et al., (2026). Pop2net: Bipartite network generation for agent-based modeling. Journal of Open Source Software, 11(117), 7897, https://doi.org/10.21105/joss.07897

BibTeX:

@article{Kaffai2026, doi = {10.21105/joss.07897}, url = {https://doi.org/10.21105/joss.07897}, year = {2026}, publisher = {The Open Journal}, volume = {11}, number = {117}, pages = {7897}, author = {Kaffai, Marius and Erhard, Lukas and Richter, Maximilian}, title = {Pop2net: Bipartite network generation for agent-based modeling}, journal = {Journal of Open Source Software} }