New methodology to identify waves, peaks, and valleys from epidemic curve
Project description
EpidemicKabu a new method to identify epidemic waves and their peaks and valleys
Kabu is a new methodology to identify waves, peaks, and valleys from epidemic curve. The algorithm in explain in doi:.. as well as some examples.
Description of files in this repository:
-
epidemickabu/
contains the modules of the package:-
kabu.py
is the main module. It makes the necessary calculations for the subsequent identification of waves, and peaks and valleys. The main input is a dataset with two variables (i.e., cases, and dates) and the kernels to smooth both the epidemic curve and its first derivative with a Gaussian filter. -
kabuWaves.py
is a module to estimate the waves. You could set an optional threshold to filter the days delimiting the waves. There are some examples in examples/ that give you and idea of the magnitude of this value. You can also filter the waves changing the kernel's value. -
kabuPeaksValleys.py
is a module to estimate the Peaks and Valleys of each identified wave.
-
-
examples/
contains the files to replicate examples of how to use the library. The examples are made with COVID-19 data for 15 countries:data/
is the input data used in all the research.dataframes/
is created to save the output dataframes.plots/
is created to save the output plots.exampleUseLibrary.ipynb
shows basic examples to use the library.exploringLibrary/.ipynb
explores attributes and methods from the classes in the library.- The other files show the steps for some analysis made with the results obtained with the library for COVID-19 data.
-
test/
contains the files to test the code. -
additional/
contains some notebooks showing the step by step of the algorithm.
Installation
NOTE: This project was made in Python 3.10.6
- Install the library using
pip
pip install epidemickabu
- Import the library
import epidemickabu as ek
Contributing
This project is in progress and it requires some improvments. Therefore, if you have any suggestion that would make this better, please fork the repository and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/improvments
) - Commit your Changes (
git commit -m 'Adding some improvment
) - Push to the Branch (
git push origin feature/improvments
) - Open a Pull Request
Contact
Acknowledgments
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for EpidemicKabu-0.1.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d3c4d761be9f00a5c914955e09d7bb3e2fadb41d24cfc7daa75edc94054906ab |
|
MD5 | 2f308cbd82ecbdd2f8cdb734bdc3f989 |
|
BLAKE2b-256 | 3b2ef86bf732f30edbd7ff6db9b7ac3243475b4d8ad47c4f39a011526f86f391 |