https://github.com/marcpinet/epidemic-modeling
🦠 Python script that simulates a pandemic using moving dots with tweakable parameters and then generates a graph according to obtained values. Made as part of a school project.
https://github.com/marcpinet/epidemic-modeling
animation epidemic-model epidemic-simulations matplotlib-pyplot modeling pyqt5 python
Last synced: 23 days ago
JSON representation
🦠 Python script that simulates a pandemic using moving dots with tweakable parameters and then generates a graph according to obtained values. Made as part of a school project.
- Host: GitHub
- URL: https://github.com/marcpinet/epidemic-modeling
- Owner: marcpinet
- License: mit
- Created: 2021-10-23T12:23:34.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-02-01T19:52:19.000Z (9 months ago)
- Last Synced: 2025-05-07T06:04:39.547Z (6 months ago)
- Topics: animation, epidemic-model, epidemic-simulations, matplotlib-pyplot, modeling, pyqt5, python
- Language: Python
- Homepage: https://marcpinet.me
- Size: 135 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Epidemic Modeling
🧬 Tweak transmission rate, recovery rate, death rate, number of people, and many more! 🧬
⚙️ Graphical User Interface with sliders and buttons. ⚙️
👁️ Visual and graphical interpretation of results from the simulation 👁️
🔬 Randomized simulation 🔬
🧫 Inspired by [SEIDR Model](https://en.wikipedia.org/wiki/Compartmental_models_in_epidemiology) 🧫
## Features
* Every parameters of the simulation is editable through an interactive GUI 🖥
* Humans are travelling randomly but logically and are represented by dots 👦
* Humans can wear a mask and mask are 80% effective 🧢
* Humans wearing a mask are represented by a "+" and do not easily infect as well as being harder to infect ⛑️
* The simulation is almost fully randomized but keeps logic with given values 🎲
* You can adjust the speed of the simulation with the slider 🏃
* You can tweak some specific parameters of the simulation 🧰
* At the end of the simulation, you can see the evolution of the population through time 📊
* ... and many more! 🎯
## Demo
### One wave of the epidemic was simulated
https://user-images.githubusercontent.com/52708150/146844598-e74a4185-b21d-40bf-9046-5e6e4423ef77.mp4
### Three waves of the epidemic were simulated
https://user-images.githubusercontent.com/52708150/146844606-71d78f0f-11e3-47e2-8330-953a9d3600f4.mp4
### Masked dots example
https://user-images.githubusercontent.com/52708150/146844600-05ff0eda-c5c0-4466-9e31-b50abf161229.mp4
### Support 👨💻
Any problems with running the script and any questions please create a new issue [here](https://github.com/marcpinet/epidemic-modeling/issues/new?assignees=&labels=&template=bug_report.md&title=).
You can also contribute to this project by requesting new features [here](https://github.com/marcpinet/epidemic-modeling/new?assignees=&labels=&template=feature_request.md&title=).
I never ask for money for my open source projects. However, you can still tip me if you want.
I am a [Brave Verified Creator](https://i.imgur.com/fOUfdM5.png)!
### Prerequisites
* Python 3.7.0+
Get a copy of the Project. Assuming you have git installed, open your Terminal and enter:
```bash
git clone 'https://github.com/marcpinet/epidemic-modeling.git'
```
To install all needed requirements run the following command in the project directory:
```bash
pip install -r requirements.txt
```
## Running 🏃
After that you can proceed to start the program by running `main.py`.
## Authors
* **Marc Pinet** - *Initial work* - [marcpinet](https://github.com/marcpinet)
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
## Acknowledgments
* Hat tip to anyone whose code was used.
## Contributions
Special thanks to [loicpantano](https://github.com/loicpantano) for some ideas and [marcusaasjensen](https://github.com/marcusaasjensen) for its participation in the project (he made a its own simulation in C# of an airport with graphs, see [marcus' simulation](https://github.com/marcusaasjensenunice/covid-simulation)).
We were in the same team for this project and we worked together on different programs.