COVID 19 Data for South Africa created, maintained and hosted by Data Science for Social Impact research group, led by Dr. Vukosi Marivate, at the University of Pretoria.
Disclaimer: We have worked to keep the data as accurate as possible. We collate the COVID 19 reporting data from NICD and DoH. We only update that data once there is an official report or statement. For the other data, we work to keep the data as accurate as possible. If you find errors. Make a pull request.
If you use this repo for any research/development/innovation, please contact us (see contacts below)
See our blog posts:
- Why we built this and how we are working,
- How this is a call to action across the African continent
- A few weeks in, Data Science thoughts on COVID-19 in South Africa
If you are interested in the Africa-wide effort: Go to https://github.com/dsfsi/covid19africa
For information on daily updates on the repo, go to https://twitter.com/vukosi/status/1239184086633242630?s=20
Code 
Data Available [/data]
NOTE: Since around 24 March, we have not gotten individual case data from DoH or NICD. For now if you need provincial counts use the provincial_cumulative_timeline. For individual cases up to 25 March, use the confirmed_cases.
| dataset | url | raw_url[file] |
|---|---|---|
| provincial_cumulative_timeline_confirmed | provincial_cumulative_timeline_confirmed | provincial_cumulative_timeline_confirmed.csv |
| provincial_cumulative_timeline_testing | provincial_cumulative_timeline_testing | provincial_cumulative_timeline_testing.csv |
| provincial_cumulative_timeline_deaths | provincial_cumulative_timeline_deaths | provincial_cumulative_timeline_deaths.csv |
| confirmed_cases* [updated to 25 March] | covid19za_timeline_confirmed | covid19za_timeline_confirmed.csv |
| deaths | covid19za_timeline_deaths | covid19za_timeline_deaths.csv |
| district_data | district_data | |
| transmission_type | covid19za_timeline_transmission_type | covid19za_timeline_transmission_type.csv |
| testing | covid19za_timeline_testing | covid19za_timeline_testing.csv |
| DoH PDFs and Extracted CSVs | doh_pdf | |
| DoH Whatsapp case update archive | doh_whatsapp | |
| public_hospitals [validation in progress] | health_system_za_public_hospitals | health_system_za_public_hospitals.csv |
* NICD no longer gives individual case data. Please use provincial_cumulative_timeline from 26 March onwards.
- Google Data Studio Dashboard URL link
- NICD - South Africa URL
- Department of Health - South Africa Main Site, Twitter
- South African Government Media Statements URL
- National Department of Health Data Dictionary URL
- MedPages URL
- Statistics South Africa URL
- I want to help, but don't have an idea: You can take a look at the issues to see which one you might be interested in tackling.
- I have an idea or new feature: Create a new issue first, assign it to yourself and then fork the repo.
- Data Science Africa COVID-19 Response
- IndabaX South Africa: Vukosi Marivate - Using data science to inform the COVID-19 outbreak in Africa
- Stanford <> CS472 Data science and AI for COVID-19
Made with contributors-img.
- Vukosi Marivate - vukosi.marivate@cs.up.ac.za, @vukosi
On a visualisation/notebook/webapp:
Data Science for Social Impact Research Group @ University of Pretoria, Coronavirus COVID-19 (2019-nCoV) Data Repository for South Africa. Available on: https://github.com/dsfsi/covid19za.
In a publication
Data Science Journal
@article{marivate2020use, Author = {Vukosi Marivate and Herkulaas MvE Combrink}, Journal = {Data Science Journal}, Number = {1}, Pages = {1-7}, Title = {Use of Available Data To Inform The COVID-19 Outbreak in South Africa: A Case Study.}, Volume = {19}, Year = {2020}, url = {https://doi.org/10.5334/dsj-2020-019} }
and Dataset
@dataset{marivate_vukosi_2020_3819126, author = {Marivate, Vukosi and Arbi, Riaz and Combrink, Herkulaas and de Waal, Alta and Dryza, Henkho and Egersdorfer, Derrick and Garnett, Shaun and Gordon, Brent and Greyling, Lizel and Lebogo, Ofentswe and Mackie, Dave and Merry, Bruce and Mkhondwane, S'busiso and Mokoatle, Mpho and Moodley, Shivan and Mtsweni, Jabu and Mtsweni, Nompumelelo and Myburgh, Paul and Richter, Jannik and Rikhotso, Vuthlari and Rosen, Simon and Sefara, Joseph and van der Walt, Anelda and van Heerden, Schalk and Welsh, Jay}, title = {{Coronavirus disease (COVID-19) case data - South Africa}}, month = mar, year = 2020, publisher = {Zenodo}, doi = {10.5281/zenodo.3819126}, url = {https://doi.org/10.5281/zenodo.3819126} }
Some of COVID-19 Data for South Africa (data in this repo) is currently being used by other independent projects shown in the table below :
| Project Name | Project Description | Project Demo | Project owner | Country |
|---|---|---|---|---|
| 1. Covid-19 SA Data | Data visualisations corresponding to the current Covid-19 outbreak in South Africa | View data visualizations here | Simon Rosen | South Africa |
| 2. Covid-19 testing areas | A Covid-19 Testing Facilities Map | View testing areas here | Yannick Zehnder | Switzerland |
| 3. Covid-19 Map | A Coronavirus Map | [Website] [GitHub Repo] | Jay Welsh | South Africa |
| 4. Covid-19 Telegram Bot | Corona virus statistics via Telegram | Link | CodeChap | South Africa |
| 5. Covid-19 Xitsonga Dashboard | Xitsonga Dashboard | Link | xitsonga.org | South Africa |