https://github.com/brianruizy/covid19-dashboard
🦠 Django + Plotly Coronavirus dashboard. Powerful data driven Python web-app, with an awesome UI. Contributions welcomed! Featured on 🕶Awesome-list
https://github.com/brianruizy/covid19-dashboard
coronavirus coronavirus-real-time coronavirus-tracker covid-19 covid-dashboard covid-data dashboard data-visualization datascience django django-application django-web-app heroku pandemic plot plotly python
Last synced: 29 days ago
JSON representation
🦠 Django + Plotly Coronavirus dashboard. Powerful data driven Python web-app, with an awesome UI. Contributions welcomed! Featured on 🕶Awesome-list
- Host: GitHub
- URL: https://github.com/brianruizy/covid19-dashboard
- Owner: BrianRuizy
- License: mit
- Archived: true
- Created: 2020-02-27T22:34:20.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-04-21T20:52:30.000Z (over 2 years ago)
- Last Synced: 2024-09-28T16:23:39.572Z (about 1 year ago)
- Topics: coronavirus, coronavirus-real-time, coronavirus-tracker, covid-19, covid-dashboard, covid-data, dashboard, data-visualization, datascience, django, django-application, django-web-app, heroku, pandemic, plot, plotly, python
- Language: CSS
- Homepage: https://covid-dashboard.herokuapp.com
- Size: 17.5 MB
- Stars: 212
- Watchers: 12
- Forks: 178
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
# Covid 19 Interactive Dashboard
[](https://github.com/soroushchehresa/awesome-coronavirus#applications-and-bots)
[](https://gitter.im/ncov-dashboard/community)
[](https://travis-ci.com/github/BrianRuizy/covid19-dashboard)
[](https://github.com/BrianRuizy/covid19-dashboard/blob/master/LICENSE.md)
[](https://www.python.org/)
[](https://brianruizy.com/how-to-create-a-covid-dashboard-web-application-with-python)
Read [blog](https://brianruizy.com/how-to-create-a-covid-dashboard-web-application-with-python) post on my website, covering how we built this! And, don't forget to leave a [star ⭐!](https://github.com/BrianRuizy/covid19-dashboard/stargazers?after=Y3Vyc29yOnYyOpO5MjAyMC0wNS0xM1QwOTo1MzoyMC0wNTowMADODRbOpg%3D%3D)
[](https://brianruizy.com/how-to-create-a-covid-dashboard-web-application-with-python)
## About
> Coronavirus disease (COVID-19) is an infectious disease caused by a newly discovered coronavirus.
> At this time, there are no specific vaccines or treatments for COVID-19. The best way to prevent and slow down transmission is be **well informed** about the COVID-19 virus. [who.int](https://www.who.int/health-topics/coronavirus#tab=tab_1)
The goal of this project is not to build *just another dashboard*. But, to focus on collaborative plot ideas, and a mobile friendly UI/UX. Feel free to open an issue requesting a type of plot, table, or any feature for that matter. Join the repo's [Gitter chat](https://gitter.im/ncov-dashboard/community?utm_source=share-link&utm_medium=link&utm_campaign=share-link).
## Getting Started
### Prerequisites
* Python; [pyenv](https://github.com/pyenv/pyenv) recommended
* Pip
### Installing
Get the project up and running locally in just 5 easy steps.
1. Create a personal [Fork](https://github.com/login?return_to=%2FBrianRuizy%2Fcovid19-dashboard) of this repository.
2. **Clone** the fork with HTTPS, using your local terminal to a preferred location, and **cd** into the project.
```bash
git clone https://github.com/your_username/covid19-dashboard.git
Cloning into 'covid19-dashboard'...
remote: Enumerating objects: 113, done.
remote: Counting objects: 100% (113/113), done.
remote: Compressing objects: 100% (80/80), done.
Receiving objects: 100% (2845/2845), 12.52 MiB | 5.21 MiB/s, done.
cd covid19-dashboard/
```
3. Create your virtual environment, and activate it.
```bash
python -m venv env
source env/bin/activate # Linux/Mac
env/Scripts/activate # Windows
```
4. Install dependencies
```bash
pip install -r requirements.txt
```
5. Run local server, and **DONE**!
```bash
python manage.py runserver
May 06, 2020 - 11:22:23
Django version 3.0.6, using settings 'core.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
```
## Deployment
Heroku app is already configured to this repository for *automatic deploys* from any push to the **master** branch. Create a pull request containing your respective changes and wait for merge.
## Reading data locally
You can go through all the available datasets by going into the `/processdata` directory, launching a interactive python shell, importing `getdata` file, and calling any function. See below...
```bash
cd ~/repos/covid19-dashboard/processdata
```
```bash
$ python
Python 3.7.6 (default, Jan 8 2020, 20:23:39) [MSC v.1916 64 bit (AMD64)] :: Anaconda, Inc. on win32
...
>>> import getdata
>>> getdata.realtime_growth()
Confirmed Deaths Recovered
Date
1/22/20 555 17 28
1/23/20 654 18 30
... ... ... ...
8/2/20 18079723 689362 10690555
8/3/20 18282208 693694 10913000
[195 rows x 3 columns]
```
## Built With
* [Django](https://www.djangoproject.com/) Django is a high-level Web framework that encourages rapid development and clean, pragmatic design.
* [Plotly](https://plotly.com/) The leading front-end for ML & data science models in Python, R, and Julia.
* [Appseed](https://appseed.us/)
* [Bootstrap](https://getbootstrap.com/)
## Data Sources
* Johns Hopkins University: [CSSE](https://systems.jhu.edu/) 2019-ncov data repository, found [here](https://github.com/CSSEGISandData/COVID-19).
* Our World in Data: [OWID](https://ourworldindata.org/) GitHub Data repository, found [here](https://github.com/owid/covid-19-data/tree/master/public/data).
* New York Times' COVID GitHub data repository, found [here](https://github.com/nytimes/covid-19-data)
## License
[@MIT](https://github.com/BrianRuizy/covid19-dashboard/blob/master/LICENSE.md)