-
Notifications
You must be signed in to change notification settings - Fork 5
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
225c16c
commit 02c9fde
Showing
1 changed file
with
12 additions
and
12 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,4 @@ | ||
<img src="logo/EPIDEMIC.png" width="50%"> | ||
## Epidemiology Educational Code | ||
|
||
**EPIDEMIC: Epidemiology Educational Code** is an easy-to-run educational Matlab toolkit for epidemiological analysis, which offers functionalities for modeling an epidemic, monitoring its progress and forecasting the underling numbers of interest. This code is, first of all, an educational tool for researchers and students who are interested in computational epidemiology. The programs and tutorials are designed to offer good introductory material for beginners in the field. But they can also be used to analyze epidemic data, as well as in the construction of some simplistic epidemic models. The package is structured in 3 independent modules: | ||
- **Modeling:** which uses differential equation-based compartmental models to emulate the dynamic behavior of homogeneous populations during an epidemic scenario; | ||
|
@@ -7,7 +7,7 @@ | |
|
||
The current stable version of **EPIDEMIC** is available on GitHub: | ||
|
||
https://github.com/americocunhajr/EPIDEMIC | ||
<a href="https://github.com/americocunhajr/EPIDEMIC" target="_blank">https://github.com/americocunhajr/EPIDEMIC</a> | ||
|
||
In the figure below, it is possible to observe the EPIDEMIC organization structure. | ||
|
||
|
@@ -34,7 +34,7 @@ This EPIDEMIC package includes the following files: | |
**FORECASTS:** | ||
- epidemic_forecast.m | ||
|
||
## Tutorial | ||
### Tutorial | ||
|
||
A tutorial style user guide for **EPIDEMIC** is available in English and Portuguese: | ||
|
||
|
@@ -43,22 +43,22 @@ A tutorial style user guide for **EPIDEMIC** is available in English and Portugu | |
[EPIDEMIC_Tutorial_PT.pdf](https://github.com/americocunhajr/EPIDEMIC/blob/master/Docs/EPIDEMIC_Tutorial_PT.pdf) | ||
|
||
|
||
## Installation and use | ||
### Installation and use | ||
|
||
To run the EPIDEMIC code, follow these steps: | ||
|
||
1) Access the EPIDEMIC repository and download the folder with the code: [www.github.com/americocunhajr/EPIDEMIC](https://github.com/americocunhajr/EPIDEMIC); | ||
1) Access the EPIDEMIC repository and download the folder with the code: <a href="https://github.com/americocunhajr/EPIDEMIC" target="_blank">https://github.com/americocunhajr/EPIDEMIC</a>; | ||
|
||
2) The working directory of the compatible software (Octave or MATLAB) is placed in the place where the folder with the EPIDEMIC codes is located and it is executed via the terminal; | ||
|
||
3) If it is in the module Modeling, the executable file that generates the simulations is the files main. In the files rhs is possible to modify the differential equations, if that is the interest. In the module Trends, the executable file is epidemic_trends.m. And in the module Forecasts the executable file is epidemic_forecasts.m. In the tutorials you can get more information on how to use the codes. | ||
|
||
|
||
## Octave/Matlab compatibility | ||
### Octave/Matlab compatibility | ||
|
||
**EPIDEMIC** was developed to be 100% compatible with the Octave and Matlab platforms. EPIDEMIC codes have been tested on at least GNU Octave 5.2.0 and MATLAB R2016b versions. | ||
|
||
## Team: | ||
### Team: | ||
|
||
**Faculty/Researchers:** | ||
- Americo Cunha | ||
|
@@ -83,7 +83,7 @@ To run the EPIDEMIC code, follow these steps: | |
- Luthiana Soares | ||
|
||
|
||
## Citing EPIDEMIC | ||
### Citing EPIDEMIC | ||
|
||
We ask users to cite the following manual in any publications reporting work done with **EPIDEMIC**: | ||
- Pavlack et al., (2022). EPIDEMIC: Epidemiology Educational Code. Journal of Open Source Education, 5(50), 149, https://doi.org/10.21105/jose.00149 | ||
|
@@ -102,20 +102,20 @@ We ask users to cite the following manual in any publications reporting work don | |
} | ||
``` | ||
|
||
## License | ||
### License | ||
|
||
**EPIDEMIC** is released under the MIT license. See the LICENSE file for details. All new contributions must be made under the MIT license. | ||
|
||
<img src="logo/mit_license_red.png" width="10%"> | ||
|
||
## Funding | ||
### Funding | ||
|
||
<img src="logo/faperj.jpg" width="20%"> <img src="logo/cnpq.png" width="20%"> <img src="logo/capes.png" width="10%"> | ||
|
||
## Institutional support | ||
### Institutional support | ||
|
||
<img src="logo/uerj_logo_cor.jpg" width="13%"> <img src="logo/ufrj_logo_cor.png" width="10%"> <img src="logo/ufu_logo_cor.png" width="12%"> <img src="logo/ifms_logo_cor.png" width="15%"> <img src="logo/unesp_logo_cor.png" width="25%"> | ||
|
||
## Contribution to code and contact | ||
### Contribution to code and contact | ||
|
||
Any EPIDEMIC user can contribute the code or seek support via email [email protected] or open an [issue](https://github.com/americocunhajr/EPIDEMIC/issues). You can correct spelling or grammatical errors, suggest improvements and file bugs. If you find a bug, file the issue illustrating the bug with a minimal reproducible example. Experience reports on the use of EPIDEMIC are also welcome. If you want to suggest the insertion of a compartmental model in the Modeling module, it is necessary to send a preview of the code structure following the code pattern of the other compartmental models. |