Summary
On Jan 22, 2020, a day after the USA reported its first COVID-19 case, the Johns Hopkins University Center for Systems Science and Engineering (JHU CSSE) launched the first global real-time coronavirus surveillance system: the JHU CSSE COVID-19 Dashboard. As of June 1, 2022, the dashboard has served the global audience for more than 30 consecutive months, totalling over 226 billion feature layer requests and 3·6 billion page views. The highest daily record was set on March 29, 2020, with more than 69 billion requests and over 4·6 billion views. This Personal View reveals the fundamental technical details of the entire data system underlying the dashboard, including data collection, data fusion logic, data curation and sharing, anomaly detection, data corrections, and the human resources required to support such an effort. The Personal View also covers the challenges, ranging from data visualisation to reporting standardisation. The details presented here help develop a framework for future, large-scale public health-related data collection and reporting.
Introduction
,
,
The outbreak quickly spread throughout the country and the first international case was confirmed on January 13, in Thailand.
,
On Jan 30, 2020, the first case of person-to-person transmission in the USA was confirmed.
That same day, WHO declared 2019-nCoV a Public Health Emergency of International Concern.
As of June 1, 2022, over 2 years later, SARS-CoV-2 has infected over 530 million people across every continent and contributed to the deaths of at least 6·2 million people, both of which are underestimations.
,
The dashboard has since become the de facto database for global spread of the virus, providing a hub for the public, scientists, and policy makers alike to understand the spread of SARS-CoV-2. The dashboard has received over 226 billion requests for data hosted in feature layers and 3·6 billion page views as of June 1, 2022. The cumulative and daily feature requests and page views on the dashboard between inception and June 1, 2022, is illustrated in figure 1.

Figure 1Johns Hopkins University Center for Systems Science and Engineering Dashboard usage and milestones, including the number of requests and views
Views refer to the number of times the dashboard, either desktop or mobile versions, is loaded on the visitor’s end. Global COVID-19 cases and deaths in dashed lines are reference plots. (A, B) Total usage from Jan 21, 2020, to June 1, 2022. (C, D) Daily usage before June 15, 2020. Daily cases and daily deaths are smoothed by 7-day moving average.

Figure 2Graphical summary of the Johns Hopkins University Center for Systems Science and Engineering Dashboard data pipeline
The pipeline can be separated into four main steps. (A) Data sourcing describes the identification and validation of trusted, open-source data sources. (B) Autonomous collection uses web scraping algorithms to collect raw data from open-source data sources. (C) Comprehensive data curation passes the data through several quality control mechanisms including an in-house designed anomaly detection service. Data fusion services curate the cleaned data into a single production database. (D) Data sharing is the publication of production data into our online data products.
Dashboard overview

Figure 3Evolution of the dashboard visualisation
(A) Initially, our efforts were focused on the spread of cases in China. (B) As the virus spread globally, the default view was expanded to include the entire world. (C) In the most current version, vaccination data has been added and the time series has been adjusted from daily to weekly bars.
Approximately 8–10 full-time equivalents are required to maintain the current products, composed primarily of data scientists and software engineers. This team also includes some public health, geographical information system, and infectious disease modelling experts all under the guidance of one project manager and one technical lead. The entire data system was developed from scratch and runs entirely on-premises. Although the underlying software to collect and process the data was custom designed and built, we rely on partner industry tools for system management. Specifically, all of our data products are hosted on GitHub.com, and custom Slack commands and Amazon Web Service cloud servers allow our team to interact with and approve data within the anomaly detection system.
Data sourcing
In addition to the growing set of jurisdiction-specific public sources, our sources still include other aggregation efforts. For non-US locations publishing non-machine-readable formats, the WHO COVID-19 Dashboard and Worldometers are used. Data published by the US Centers for Disease Control and Prevention (CDC) or the US Department of Health and Human Services are used for specific metrics that are no longer published by the primary source or when primary sources reduce reporting to less than or equal to once per week. Thus, as the quality and availability of data sources has evolved throughout the pandemic, the mapping of sources to point to locations represented on the map has also changed.
Data sourcing is more encompassing than simply identifying whether particular metrics are reported on an authoritative source; it includes the need to understand the definitions used for specific metrics, the frequency of reporting, and the suitability of the source for manual or automated data collection. Further challenges result from divergence between national reporting and authoritative aggregation sources (eg, WHO reporting for Mauritius includes probable cases, whereas Mauritian Health Ministry reporting does not).
Autonomous data collection
Comprehensive data curation
Following collection, data are curated and processed to minimise the likelihood that anomalous source data populates our data products. Data collection agents asynchronously extract targeted data from the sources into a raw data store. Here, data irregularities in the raw data, such as language translation, spelling errors, missing values, and improper entries are transformed, and formatted into a curated dataset by an automated system. Curated data are loaded into a production data store used for developing data products and analysis.
The system consists of data fusion services that use the production data store and a configurable set of rules to generate data products. Before data products are reported, they go through an anomaly detection service to detect potentially anomalous data. The data fusion and anomaly detection systems are two substantial and necessary innovations in the design of this system.
Fusion logic
The dashboard architecture consists of hundreds of data sources and allows for data redundancy, where a single data point can have data provided from multiple sources. Data fusion services use a configurable set of rules (ie, logic) established by stakeholders and subject-matter experts to establish which data to source for customised data products. These configurable sets of rules specify the location, data type to be fused, and sources to be fused through extract-transform-load processes. For example, the fusion logic will compare total cases (data type) published for Baltimore, MD, USA (location) by county and state public health departments (sources) and propagate the most up-to-date cases to the data products. This method is particularly helpful when sources are on varying update times or frequencies.
The fusion system ensures that in the case of asynchronous update schedules for two sources serving one location, the dashboard will always reflect the data of the timeliest source. Commonly, our data reflects the maximum value between sources. The anomaly detection services mitigate the risk of overreporting when defaulting to a maximum value.
Anomaly detection
The anomaly detection service is crucial to the data curation process. In our case, anomalies describe successfully scraped data that greatly deviate from expectations. These inaccuracies can arise either through internal scraper issues (scraped data differs from source), a source publication error, or substantial changes to the source reporting posture. Our automated system uses a combination of historical data and dynamic thresholds to flag potential anomalies. Production data are compared with the most recent published data to identify the relative and absolute difference. If these differences exceed configured thresholds, which vary by location and over time, the anomaly detection service notifies the team of developers of a potential error in the data. The alert and notification initiate a quality control process, and mandatory manual reviews are performed to establish data accuracy. During review, the detection service prevents the anomalous data point from propagating to the live data products and the data from the most previous update cycle is held constant. If the anomaly is determined to be accurate, the reported data are manually confirmed and successfully propagated to the data product and stored. Through this quality control mechanism, source data entry errors rarely propagate to the dashboard.
Data sharing
As such, the dashboard allows access to all data underlying the widgets and visualisation.
Early in the pandemic, our data sharing relied on the web-based spreadsheet program Google Sheets. This program offered both a running tally of the current outbreak and a historical record of all changes made to the document that allowed users to write comments, offering an informal forum for reporting data issues. The Sheet consisted of multiple time series tables with rows for different countries and regions and a daily case report that was used to update the time series files. Unfortunately, Google Sheets had issues described below that challenged our commitment to open data, motivating a shift in hosting. Google Sheets has limits on the number of users that can simultaneously view a document, which was quickly surpassed. Second, Google Sheets did not allow for easy download or sharing of data. After considering alternatives, the database was moved to GitHub, which offered the scalability for open data access, easily downloadable content, and autonomy that maintained the goals of the dashboard effort. To ease the transition for our active user base, the data structure from Google Sheets was preserved and remains our active structure. GitHub also provides other elements that support data transparency: README files listing sources and data modifications, access to historical versions of files, and a forum for raising data issues and posting announcements.
Challenges
Ambiguous and inconsistent parameter definitions
To accurately assess the epidemic situation across geographical space, locations need to follow the same, or similar, set of standards for collecting, defining, and reporting data. The dashboard initially reported three variables—cases, deaths, and recoveries—which have each had variance in their interpretations and definitions between locations. The addition of vaccination data has similarly had standardisation challenges.
Cases
,
However, the criteria used to define probable cases is inconsistent globally.
,
To the best of our ability, case data are restricted to include only confirmed and probable cases as defined by the US CDC based on the case definitions published by individual sources.
Deaths
As with case data, our reported death data includes confirmed and probable deaths. However, the date assigned to a COVID-19 death can vary substantially by location and time. Deaths can either be tagged as the date that the death occurred, when the death certificate was issued, or when the death was reported publicly. Additionally, although death data have generally been viewed as closer to the ground truth of viral harm, disparate definitions for probable and non-laboratory confirmed deaths exist across locations without clear transparency. Similar to cases, the US CDC definitions for deaths are applied to global sources as closely as possible.
Recoveries
This requirement was impractical, spurning regions to develop independently derived algorithmic methods based on patients accessing care, or time since diagnosis or symptom onset, or both.
These non-standard definitions led to substantial diversity in recovery data between locations, and challenged their use for data-driven policy. For this reason, the dashboard stopped reporting recovered data (or active cases) on Aug 2, 2021.
Vaccination
For example, doses administered beyond a full series (eg, three doses of the mRNA-1273 [Moderna] vaccine) have been described as both additional and booster doses. As booster doses have become standard, the original designations of partially vaccinated and fully vaccinated are no longer suitable. Finally, how to properly report administration of heterologous vaccines is unclear. For these reasons and others, the dashboard solely reports total doses administered for all locations.
For all the above parameters, a globally agreed on, standardised set of definitions would have greatly increased the quality of the data, and enabled a more accurate understanding of SARS-CoV-2 spread between locations and over time.
Inaccessible reporting methods
One of the primary challenges in compiling this dataset has been the absence of standardisation and support for machine-readable data. These issues ranged from public health entities using inaccessible formats, such as infographics and business intelligence reporting frontends, to sources sharing information only through narratives, social media posts, or press conferences.
Semi-structured or unstructured reporting, either on social media, press releases, or press conferences, is a common problematic method due to its unsuitability for web scraping. For example, the most consistent source of pandemic data in Kosovo is the Kosovo National Institute of Public Health Facebook. Unfortunately, these posts are provided in a semi-structured story-based form, with data tables and graphs embedded as images. Narrative reporting requires the development of bespoke natural language processing algorithms, which is not scalable and further complicated by reports in multiple languages.
Addressing these challenges has been a process that is highly reliant on both the source and the nature of how the data are presented. At times, machine learning pipelines have been developed to parse data into a readable format, and this approach has been successfully deployed for locations publishing structured PDF files. In other instances, aggregators that turn unreadable data into machine-readable formats have been identified and validated for inclusion in our data pipeline. Finally, if no machine-readable sources are identified, the team defaults to manual updates, which are time-consuming and unsustainable. An automated screenshot tool has been developed to limit the risk of human data entry errors for manually tracked locations and to provide data validation. This tool, currently deployed for US and manually collected sources only, takes a screenshot of the source dashboard with every scraper run or manual collection and stores it in an internally accessible database.
Unstable reporting practices (metrics and frequency)
Few institutions, particularly at local or regional levels, had the infrastructure to publicly report epidemiological data in a structured format before the COVID-19 pandemic. As institutions developed systems on the fly, these evolved as new guidance was given by national agencies or staffing and new technology was made available (or removed). When making these changes, many institutions created inconsistencies in their own reporting structure or methodology. As US national guidelines shifted, states progressively altered their approach to reporting probable cases. As these changes have generally become more inclusive, they have been coincident with large spikes in case or death data that misrepresent the epidemiological situation.
Conclusion
The JHU CSSE COVID-19 Dashboard provides an accessible means of viewing the global dynamics of COVID-19; feeds the visualisations and projects of hundreds of governments, private, and academic efforts; and serves as a historical record of the pandemic. Crucially, the dashboard relied entirely on publicly available data; thus, the quality of the data product generated is dependent on the accessibility, quality, and timeliness of the data available. The dashboard had diverse challenges associated with the varied approaches of different sources and required the development of several quality-control systems. By sharing information about these systems and challenges, developers might strengthen their own data quality and data providers can understand how their decision making affects data aggregation projects and general data accessibility needs. Furthermore, this project relied heavily on expertise from computer scientists and systems engineers, and these skillsets should be heavily invested in by public health institutions. Finally, the financial support for the dashboard was primarily institutional and philanthropic, highlighting the crucial role played by academic and philanthropic organisations in informing and advancing worldwide public health practice.
Contributors
ED and LMG were responsible for conceptualisation of the dashboard. JR, ED, TDG, AK, RL, TKN, BG, EB, SP, DZ, RCM, MRB, HD, FG, FA, JW, SC and LMG contributed to the methodology. ED, TDG, AK, TKN, BG, EB, SP, DZ, HD, FG, and FA developed the software. RCM, MRB, JW, and SC were responsible for resources. JR, ED, TKN, BG, EB, SP, DZ, HD, FG, and FA performed data curation. The original draft was written by JR and ED, all authors were involved with reviewing and editing. JR, ED, TDG, AK, and LMG were responsible for visualisation. TDG, AK, and LMG supervised the study.
Declaration of interests
We declare no competing interests.
Acknowledgments
The authors greatly appreciate the financial support of Bloomberg Philanthropies, the Stavros Niarchos Foundation, and the National Science Foundation award 2028604. The funders had no role in the study described or implementation of the JHU CSSE COVID-19 Dashboard. The authors acknowledge and thank Sean Breyer, Paul Dodd from Esri Inc., Redlands CA,USA, and the broader Environmental Systems Research Institute team for their assistance in launching and managing the dashboard.
Supplementary Material
References
- 1.
A pneumonia outbreak associated with a new coronavirus of probable bat origin.
Nature. 2020; 579: 270-273
- 2.
A new coronavirus associated with human respiratory disease in China.
Nature. 2020; 579: 265-269
- 3.
A novel coronavirus from patients with pneumonia in China, 2019.
N Engl J Med. 2020; 382: 727-733
- 4.
An investigation of transmission control measures during the first 50 days of the COVID-19 epidemic in China.
Science. 2020; 368: 638-642
- 5.
WHO statement on novel coronavirus in Thailand.
- 6.
First known person-to-person transmission of severe acute respiratory syndrome coronavirus 2 (SARS-CoV-2) in the USA.
Lancet. 2020; 395: 1137-1144
- 7.
Statement on the second meeting of the international health regulations (2005) emergency committee regarding the outbreak of novel coronavirus (2019-nCoV).
- 8.
Estimating SARS-CoV-2 infections from deaths, confirmed cases, tests, and random surveys.
Proc Natl Acad Sci USA. 2021; 118e2103272118
- 9.
The true death toll of COVID-19: estimating global excess mortality.
- 10.
An interactive web-based dashboard to track COVID-19 in real time.
Lancet Infect Dis. 2020; 20: 533-534
- 11.
Item details.
- 12.
A need for open public data standards and sharing in light of COVID-19.
Lancet Infect Dis. 2021; 21: e80
- 13.
Coronavirus disease 2019 (COVID-19) 2020 interim case definition, approved August 5, 2020.
- 14.
Coronavirus disease 2019 (COVID-19) 2021 case definition.
- 15.
Assessment of COVID-19 surveillance case definitions and data reporting in the European Union.
- 16.
WHO COVID-19 case definition.
- 17.
Laboratory testing of human suspected cases of novel coronavirus (nCoV) infection: interim guidance 10 January 2020.
- 18.
A global database of COVID-19 vaccinations.
Nat Hum Behav. 2021; 5: 947-953
Article Info
Publication History
Published: August 31, 2022
Identification
Copyright
© 2022 Elsevier Ltd. All rights reserved.
ScienceDirect
Linked Articles
- Tackling the politicisation of COVID-19 data reporting through open access data sharing
-
Public health policies are only as good as the quality of the data on which they are based. Policy decisions that are so crucial to containing an emerging pathogen are challenged by the sparsity of data on which to optimise them. The earlier, and more completely, the data can be compiled, the better the robustness of risk estimates, forecasting, and modelling. Within 3 weeks of the announcement by WHO of an anomalous cluster of severe coronavirus cases in Wuhan, China, the Johns Hopkins University (JHU) Center for Systems Science and Engineering (CSSE) launched the COVID-19 Dashboard.
Full-Text
PDF
-
