Jupyter notebooks for Covid-19 data analysis & visualization
The one-time setup and launch of the BCD application will take about 5 minutes. After that, you’ll be able to launch it in less than a minute each time.
Please note that any text you need to copy/paste be offset by quotes (“”). Do not include the quotes when you copy/paste from the instructions below.
- Follow the instructions to download Docker here: https://docs.docker.com/get-docker/
- Click this link to download a folder that contains the source code for BCD: https://github.com/bloomberg/quant-research/archive/master.zip
- Double-click the folder, which is called quant-research master, after you download it. You should now see a folder called covid. Take note of where this folder is saved on your computer because you will need to access it later.
- Find your computer’s terminal and click to open it. On a Mac, this is typically in Applications > Utilities > Terminal
- Once the terminal window opens, type “cd “ (please note that you have to copy the letters cd and the space after the d), then find the folder called covid that you just downloaded – do not hit enter just yet!
- Drag the covid folder into the terminal window just after the space in “cd “ and now you can hit enter.
- You’ll see the terminal auto-run some commands. When it finishes, copy this text and paste it into the terminal window, then hit enter: “docker build -t bloomberg-covid-dashboard .” (please note the . is inside the quotes and has a space in front of it – you need to copy/paste both)
- You’ll once again see the terminal auto-run some commands while it is building the application. It will take a little over a minute to complete.
- Copy this text and paste it into the terminal window, then hit enter: “docker run -p 8866:8866 bloomberg-covid-dashboard”
- Click this link to launch BCD: http://localhost:8866
- You’ll see a black screen and in about 30 seconds, the BCD application will open – you are finished!
- Find your computer’s terminal and click to open it. On a Mac, this is typically in Applications > Utilities > Terminal
- Copy this text and paste it into the terminal window, then hit enter: “docker run -p 8866:8866 bloomberg-covid-dashboard”
- Click this link to launch BCD: http://localhost:8866
The one-time setup and launch of the BCD application will take about 15 minutes. After that, you’ll be able to launch it in less than a minute each time.
Please note that any text you need to copy/paste be offset by quotes (“”). Do not include the quotes when you copy/paste from the instructions below.
- Follow the instructions to download Docker here (and note that you may be asked to install WSL components for Windows and restart Windows): https://docs.docker.com/get-docker/
- In addition, if you are running Windows 10 Home or you are not an admin on Windows 10 Professional, you will need to follow additional steps which you can find detailed here under the section called “Install Docker Desktop on Windows”; you will need to reboot your computer to complete the setup. If you are not sure which version you have or if you are an admin, follow the additional steps.
- Click this link to download a folder that contains the source code for BCD: https://github.com/bloomberg/quant-research/archive/master.zip
- Unzip/open the folder, which is called quant-research master, after you download it. To do this, either right click on the folder name and click extract and click into the unzipped quant-research master folder. You should now see a folder called covid. Take note of where this folder is saved on your computer because you will need to access it later.
- Find your computer’s terminal and click to open it. On a Windows machine, you can typically type “PowerShell” in the Windows search bar.
- Once the terminal window opens, if you see a directory for anything other than C:, type “C:” and then enter
- Type “cd “ (please note that you have to copy the letters cd and the space after the d), then find the folder called covid that you just downloaded. Do not hit enter after you type “cd “
- Click into the covid folder and copy the path to that folder
- Paste the folder path after the space in “cd “ and hit enter
- You’ll see the terminal auto-run some commands. When it finishes, copy this text and paste it into the terminal window, then hit enter: “docker build -t bloomberg-covid-dashboard .” (please note the . is inside the quotes and has a space in front of it – you need to copy/paste both)
- You’ll once again see the terminal auto-run some commands while it is building the application. It will take a little over a minute to complete.
- Copy this text and paste it into the terminal window, then hit enter: “docker run -p 8866:8866 bloomberg-covid-dashboard”
- Click this link to launch BCD and you are finished: http://localhost:8866
- You’ll see a black screen and in about 30 seconds, the BCD application will open!
- Find your computer’s terminal and click to open it. On a Windows machine, you can typically type “PowerShell” in the Windows search bar.
- Once the terminal window opens, if you see a directory for anything other than C:, type “C:” and then enter
- Copy this text and paste it into the terminal window, then hit enter: “docker run -p 8866:8866 bloomberg-covid-dashboard”
- Click this link to launch BCD: http://localhost:8866
Data repository for Novel Coronavirus (COVID-19) Cases is provided by Johns Hopkins University Center for Systems Science and Engineering (JHU CSSE), which curates the datasets from various sources including WHO, CDC and others.
https://github.com/CSSEGISandData/COVID-19
The Dashboard allows the users to select a country from an interactive world map and view various statistics. The first outer tab (Infection Maps) is divided into two panels. The left one presents the world and US states maps. The right panel presents a graph of Cases, Deaths, Recovered and Active Cases of the selected country/state and two tables of top 20 countries and states in the chosen category (top left toggle buttons).
There are four groups of toggle buttons in the top left panel:
- Data : Choose which data to use to color the map (Cases, Deaths, Recovered or Active Cases)
- Normalization : Use raw values or divide by population
- Scale : Log or Linear
- Type : Total (or cumulative numbers), Diff (or daily differences), % change. Changing your selection will update map's colors, right graph and the tables.
Map interactions :
- Hover on a country or state to view its statistics.
- Click on a country or state to plot its data in the right figure.
Date selector and animation:
- Select the date of the data to represent.
- Play button to animate maps and tables.
The second outer tab presents an interactive rebased graph. Rebased graph example : Log Cases/1MPop in France, Spain and New York since number of deaths = 1000 You can select :
- Output Data :
- Data to plot (Cases, Deaths, Active or Recovered). Cases in our example.
- Normalization to apply (by population or none). Per 1M Pop in our example
- Type of time series (Total (cumulative number), Diff (daily differences) or % change). Total in our example.
- Scale of the rebased graph (Linear or Log). Log in our example.
- Countries or states. France Spain and New York in our example.
- Threshold Data :
- Value of the threshold (if equal 0 it will plot data vs calendar days). 1000 in our example.
- Data to apply threshold on (Cases, Deaths or Recovered). Deaths in our example.
- Normalization to apply (by population or raw values). Values in our example.
The third tab shows an interactive Heatmap. Like for the previous tab, you can select the countries/states and the data you want to plot.
The last tab allows you to create your own graph. You can select the data you want to represent on X and Y axes (by clicking on the toggle buttons) and you can select any country or US states. Also you have the possibility to represent the whole time series (Line plot) that you can animate or only the last data point (Scatter plot).
This software is licensed under the Apache 2.0 license. See the LICENSE file for details.