About

The HyperContagion library provides algorithms for simulating and visualizing contagion processes on complex systems with group (higher-order) interactions.

Repository: https://github.com/nwlandry/hypercontagion
PyPI: https://pypi.org/project/hypercontagion/
Documentation: https://hypercontagion.readthedocs.io/

Installation

To install and use HyperContagion as an end user, execute

pip install hypercontagion

To install for development purposes, first clone the repository and then execute

pip install -e .['all']

If that command does not work, you may try the following instead

pip install -e .\[all\]

HyperContagion was developed and tested for Python 8-3.11 on Mac OS, Windows, and Ubuntu.

Academic References

The Why, How, and When of Representations for Complex Systems, Leo Torres, Ann S. Blevins, Danielle Bassett, and Tina Eliassi-Rad.
Networks beyond pairwise interactions: Structure and dynamics, Federico Battiston, Giulia Cencetti, Iacopo Iacopini, Vito Latora, Maxime Lucas, Alice Patania, Jean-Gabriel Young, and Giovanni Petri.
What are higher-order networks?, Christian Bick, Elizabeth Gross, Heather A. Harrington, Michael T. Schaub.

Contributing

If you want to contribute to this project, please make sure to read the code of conduct and the contributing guidelines.

The best way to contribute to HyperContagion is by submitting a bug or request a new feature by opening a new issue.

To get more actively involved, you are invited to browse the issues page and choose one that you can work on. The core developers will be happy to help you understand the codebase and any other doubts you may have while working on your contribution.

Contributors

The core HyperContagion team members:

Nicholas Landry
Joel Miller

License

This project is licensed under the BSD 3-Clause License.