Coronavirus COVID-19 (2019-nCoV) Data Repository for South Africa

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

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

Licenses

Code | Data

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 indivividual cases up to 25 March, use the confirmed_cases.

dataset	url	raw_url[file]
provincial_cumulative_timeline	provincial_cumulative_timeline	provincial_cumulative_timeline.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.

Dashboard

• Google Data Studio Dashboard URL link

Data Sources:

• 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

Contributing

Options

• I want to help, but dont 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.

Submitting Changes [Pull Request]

• See https://opensource.com/article/19/7/create-pull-request-github

Resources [Get some ideas]

• 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

Contributors

Made with [contributors-img](https://contributors-img.web.app). * See https://github.com/dsfsi/covid19za/graphs/contributors

Contact

• Vukosi Marivate - vukosi.marivate@cs.up.ac.za, @vukosi

Citing the dataset

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

Arxiv Preprint

@misc{marivate2020framework, title={A Framework For Sharing Publicly Available Data To Inform The COVID-19 Outbreak in Africa: A South African Case Study}, author={Vukosi Marivate and Herkulaas MvE Combrink}, year={2020}, eprint={2004.04813}, archivePrefix={arXiv}, primaryClass={cs.CY}, url = {https://arxiv.org/abs/2004.04813} }

and Dataset

@dataset{marivate_vukosi_2020_3732419, author = {Marivate, Vukosi and de Waal, Alta and Combrink, Herkulaas and Lebogo, Ofentswe and Moodley, Shivan and Mtsweni, Nompumelelo and Rikhotso, Vuthlari and Welsh, Jay and Mkhondwane, S'busiso}, title = {{Coronavirus disease (COVID-19) case data - South Africa}}, month = mar, year = 2020, publisher = {Zenodo}, doi = {10.5281/zenodo.3732419}, url = {https://doi.org/10.5281/zenodo.3732419} }

Showcase

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