Citation and References

If you use py3plex in your research, please cite our work. The quickest recipe:

  • Always cite the primary journal article for general usage (analysis, visualization, CLI, DSL).

  • Add algorithm-specific citations when you rely on a particular method (community detection, embedding, ranking).

  • Where possible, include the DOI to keep references unambiguous.

Primary Citation

Recommended citation for py3plex (general use of the library and DSL):

@Article{Skrlj2019,
  author    = {{\v{S}}krlj, Bla{\v{z}} and Kralj, Jan and Lavra{\v{c}}, Nada},
  title     = {Py3plex toolkit for visualization and analysis of multilayer networks},
  journal   = {Applied Network Science},
  year      = {2019},
  volume    = {4},
  number    = {1},
  pages     = {94},
  doi       = {10.1007/s41109-019-0203-7},
  url       = {https://doi.org/10.1007/s41109-019-0203-7}
}

Plain text:

Škrlj, B., Kralj, J., & Lavrač, N. (2019). Py3plex toolkit for visualization and analysis of multilayer networks. Applied Network Science, 4(1), 94. https://doi.org/10.1007/s41109-019-0203-7

Conference Paper

For the initial algorithmic work and early benchmarks, add this citation alongside the primary one:

@InProceedings{Skrlj2019Conference,
  author    = {{\v{S}}krlj, Bla{\v{z}} and Kralj, Jan and Lavra{\v{c}}, Nada},
  editor    = {Aiello, Luca Maria and Cherifi, Chantal and Cherifi, Hocine
               and Lambiotte, Renaud and Li{\'o}, Pietro and Rocha, Luis M.},
  title     = {Py3plex: A Library for Scalable Multilayer Network Analysis and Visualization},
  booktitle = {Complex Networks and Their Applications VII},
  year      = {2019},
  publisher = {Springer International Publishing},
  address   = {Cham},
  pages     = {757--768},
  isbn      = {978-3-030-05411-3},
  doi       = {10.1007/978-3-030-05411-3_60}
}

Algorithm-Specific Citations

When using specific algorithms, please also cite the original papers in addition to the primary py3plex article. Cite only the methods you actively use.

Multilayer Modularity

Use when reporting multilayer modularity community detection results.

@Article{Mucha2010,
  author  = {Mucha, Peter J. and Richardson, Thomas and Macon, Kevin
             and Porter, Mason A. and Onnela, Jukka-Pekka},
  title   = {Community structure in time-dependent, multiscale, and multiplex networks},
  journal = {Science},
  year    = {2010},
  volume  = {328},
  number  = {5980},
  pages   = {876--878},
  doi     = {10.1126/science.1184819}
}

Node2Vec

Use when generating node embeddings with Node2Vec.

@InProceedings{Grover2016,
  author    = {Grover, Aditya and Leskovec, Jure},
  title     = {node2vec: Scalable Feature Learning for Networks},
  booktitle = {Proceedings of the 22nd ACM SIGKDD International Conference
               on Knowledge Discovery and Data Mining},
  year      = {2016},
  pages     = {855--864},
  doi       = {10.1145/2939672.2939754}
}

Louvain Algorithm

Use when computing Louvain community detection results.

@Article{Blondel2008,
  author  = {Blondel, Vincent D. and Guillaume, Jean-Loup and Lambiotte, Renaud
             and Lefebvre, Etienne},
  title   = {Fast unfolding of communities in large networks},
  journal = {Journal of Statistical Mechanics: Theory and Experiment},
  year    = {2008},
  volume  = {2008},
  number  = {10},
  pages   = {P10008},
  doi     = {10.1088/1742-5468/2008/10/P10008}
}

Infomap

Use when computing Infomap community detection results.

@Article{Rosvall2008,
  author  = {Rosvall, Martin and Bergstrom, Carl T.},
  title   = {Maps of random walks on complex networks reveal community structure},
  journal = {Proceedings of the National Academy of Sciences},
  year    = {2008},
  volume  = {105},
  number  = {4},
  pages   = {1118--1123},
  doi     = {10.1073/pnas.0706851105}
}

MultiXRank

Use when running MultiXRank for multilayer ranking.

@Article{Baptista2022,
  author  = {Baptista, Anthony and Gonzalez, Aur{\'e}lien and Baudot, Ana{\"\i}s},
  title   = {Universal multilayer network exploration by random walk with restart},
  journal = {Communications Physics},
  year    = {2022},
  volume  = {5},
  number  = {1},
  pages   = {170},
  doi     = {10.1038/s42005-022-00937-9}
}

DeepWalk

Use when generating DeepWalk embeddings.

@InProceedings{Perozzi2014,
  author    = {Perozzi, Bryan and Al-Rfou, Rami and Skiena, Steven},
  title     = {DeepWalk: Online Learning of Social Representations},
  booktitle = {Proceedings of the 20th ACM SIGKDD International Conference
               on Knowledge Discovery and Data Mining},
  year      = {2014},
  pages     = {701--710},
  doi       = {10.1145/2623330.2623732}
}

Multilayer Network Theory

Foundational papers on multilayer networks. Cite when you rely on formal multilayer definitions or theoretical background.

@Article{Kivela2014,
  author  = {Kivel{\"a}, Mikko and Arenas, Alex and Barthelemy, Marc
             and Gleeson, James P. and Moreno, Yamir and Porter, Mason A.},
  title   = {Multilayer networks},
  journal = {Journal of Complex Networks},
  year    = {2014},
  volume  = {2},
  number  = {3},
  pages   = {203--271},
  doi     = {10.1093/comnet/cnu016}
}

@Article{Boccaletti2014,
  author  = {Boccaletti, Stefano and Bianconi, Ginestra and Criado, Regino
             and del Genio, Charo I. and G{\'o}mez-Garde{\~n}es, Jes{\'u}s
             and Romance, Miguel and Sendi{\~n}a-Nadal, Irene and Wang, Zhen
             and Zanin, Massimiliano},
  title   = {The structure and dynamics of multilayer networks},
  journal = {Physics Reports},
  year    = {2014},
  volume  = {544},
  number  = {1},
  pages   = {1--122},
  doi     = {10.1016/j.physrep.2014.07.001}
}

@Article{DeDomenico2013,
  author  = {De Domenico, Manlio and Sol{\'e}-Ribalta, Albert and Cozzo, Emanuele
             and Kivel{\"a}, Mikko and Moreno, Yamir and Porter, Mason A.
             and G{\'o}mez, Sergio and Arenas, Alex},
  title   = {Mathematical formulation of multilayer networks},
  journal = {Physical Review X},
  year    = {2013},
  volume  = {3},
  number  = {4},
  pages   = {041022},
  doi     = {10.1103/PhysRevX.3.041022}
}

Complete Citation List

For algorithm citations, see the Algorithm Selection Guide, which includes all major algorithms with their original references and DOIs.

Acknowledgments

Development and Contributors

py3plex is developed and maintained by:

  • Blaž Škrlj (lead developer) - Jožef Stefan Institute, Ljubljana, Slovenia

  • Jan Kralj (contributor) - Jožef Stefan Institute

  • Nada Lavrač (contributor) - Jožef Stefan Institute

Funding and Support

This work has been supported by:

  • Jožef Stefan Institute, Ljubljana, Slovenia

  • Slovenian Research Agency (research program P2-0103)

External Libraries

py3plex builds upon excellent open-source libraries (please cite them when their capabilities are central to your results):

  • NetworkX - Graph data structures and algorithms

  • NumPy - Numerical computing

  • SciPy - Scientific computing

  • Matplotlib - Visualization

  • scikit-learn - Machine learning utilities

Community Acknowledgments

We thank all contributors, users, and the broader network science community for their support, feedback, and contributions.

Special thanks to contributors who have submitted pull requests, reported issues, or provided feedback.

License Information

py3plex is released under the MIT License.

MIT License

Copyright (c) 2019-2025 Blaž Škrlj, Jan Kralj, Nada Lavrač

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Note: Some bundled algorithms may have different licenses:

  • Infomap community detection code: AGPLv3

  • Louvain community detection: BSD-3-Clause

See LICENSE in the repository for license compatibility details, especially if redistributing binaries that package third-party implementations.

Contact

For questions about citing py3plex or collaboration opportunities:

Usage in Publications

If you’ve used py3plex in your research and would like to be listed here, please:

  1. Open an issue or pull request

  2. Provide the citation to your paper (with DOI if available)

  3. Add a brief description of how py3plex was used (e.g., DSL queries, community detection, embeddings)

We maintain a list of publications using py3plex to showcase applications and build community. New additions are welcome.

See Also