Project Plovdiv is a network epidemiology simulator and can be used to teach basic graph theory. It is primarily aimed at students and demonstrates some of the basic concepts of graph theory and epidemiology. Nodes in the graph (individuals) can be infected or vaccinated, and several different types of epidemics can be visualised. We provide a flexible and visually appealing front end to facilitate the teaching process.

Plovdiv is not intended for detailed modelling or efficiency but rather as a supplementary course resource. Our main goals throughout the development process were simplicity and ease of use as well as mathematical correctness.

Screenshot 1


Plovdiv is based on two separate pieces of software, dating back to 2009. The first one was developed under the York Transit Bursary Scheme under the supervision of Dr Daniel Franks, and the second at the University of Sussex under Dr Istvan Kiss. The large majority of work was done in 2014 by Miroslav Batchkarov and Vladislav Donchev.


Plovdiv is distributed under a three-clause BSD license. This allows unlimited redistribution for any purpose as long as its copyright notices and the license's disclaimers of warranty are maintained. The license also contains a clause restricting use of the names of contributors for endorsement of a derived work without explicit prior permission.

User manual

A brief user manual is available in the docs directory on github. Please submit bug reports and feature requests to the our Github issue tracker. We welcome contributions from the community.