COVID-19 - Quick Tutorial
This is just a Quick Tutorial on how to use my
COVID-19 data plotter.
The main purpose of this application was to present the change in COVID-19
over time.
To be blunt, I got tired of the news always presenting today's numbers,
but not really telling the story of where we've been.
The
Johns Hopkins World Map
is very good - always up to date, counts shown by circle diameter -
but there was no way to get additional info. No way to get ... what my app displays. :)
Basics
| Heatmap Animation
| Datasets
| Graphs
| Selecting Sites
| Dates Tab
| Command Line Options
| Notes
Basics
This application is designed to be used with a 2-button mouse
that also has a scroll wheel.
Many of the features are flaky using a touch screen
and some simply don't work.
Apparently, browser developers don't bother following standards.
- When the application begins, there are 4 overlapping windows.
- Clicking on one should bring it to the top
- Using the mouse, these can be moved by dragging the blue title bar.
(Over the title bar, press and hold the left mouse button, then move the mouse
while still holding the button down.)
- The Controls window has a bunch of tabs. You can tear these off into
separate windows by dragging them. When you close those windows, the tabs will reattach.
- The mouse wheel will zoom the map and graphs. Drag to reposition.
- The mouse wheel will change the value in most number fields.
Well, that's enough for here -
a lot more basics are discussed
on another page.
Heatmap Animation
As mentioned above,
when the application first opens there are 4 overlapping windows.
In the upper left is a map with a lot of colored dot on it.
- Each dot represents a reporting site - country, province, state, other.
- The colors represent the number reported - the key is on
the Color Keys tab in the Control panel.
When you move the mouse pointer over a site, some descriptive information is displayed below the map.
Below that is the timeline slider.
- The mouse wheel will move the slider back and forward - this does not wrap around
- Clicking on the slider will move the thumb to that location
- You can drag the slider (with the mouse, of course)
The slider also responds to the Current index field.
While the background is white, you can place the mouse cursor over this field and
use the mouse wheel to change the value. (No need to click in the field - just place the cursor over it.)
These values are just integers - the number of days since 20 Jan 2020.
These are the same numbers used on the plot x-axes. You can always use the
Current index number field to translate the indices to a calendar data ..
which, of course, is right above the timeline slider.
At this point, I suggest clicking the Play button ... and watch the animation.
The animation speed can be controlled by modifying (again, using the mouse wheel)
the Speed field.
These animations were the main purpose for creating this application which is why they are covered first.
There are 2 controls
on the Animations tab (in the Control panel)
that I find useful
- Hide sites with a count of zero
- At the beginning of the timeline, most sites have no data.
Hiding those makes the others easier to see.
- Hide sites with values less than or equal to 10
- I find this useful when trying to see where the main issues are.
the selection value is variable (use the mouse wheel) and the update is live.
The paired number fields can be used to limit the animation range
- mainly so it doesn't loop all the way back the beginning of the data.
Personally, I find using the mouse wheel on the slider to be more useful.
Datasets
The map can present any of 9 datasets - selectable via
the Map Data tab in the Control panel.
Five of those are provided from Johns Hopkins -
the other 4 are generated from those.
Click a few radio buttons to see what happens.
The datasets are provided as Cumulative data - each data point is the total up to that day.
On the Color Keys tab (in the Control panel),
there are 3 options
Total Count
| This is the data provided by Johns Hopkins - it (should) always increase
Data error sometimes cause it to decrease - but they fix those when identified
|
Daily Amount
| This is the number reported for that day
This will sometimes go negative, but only when there is a data error
|
Selections
| This indicates which sites are selected (green) or not selected (red)
|
Graphs
The application provides 2 graphs
Aggregate
| This displays the sum of all the selected sites
Upper right window
|
---|
Individual
| When individual sites are clicked, their data is displayed here
Lower left window
|
---|
By default, the application opens with
- The Global & US states / Confirmed dataset selected
- All sites selected
- An Aggregate plot of 319 Countries or Regions (the count may vary as more countries are added)
- The Individual plot is blank
Both graphs can be zoomed using the mouse wheel
- With the cursor in the center of the graph, both axes will change
- Place the mouse cursor over a specific axis to only change it
A button is provided to Clear the zoom.
Both graphs can display either cumulative or daily values - use the buttons.
The graphs are highly editable - just right click.
- In the center (the white area), the menu allows you to save a copy
- Over either axis, a dialog box will open and allow access to many options
- Over a series in the legend below the graph open the same dialog box, but with the series selected
In the legend area
- The checkbox will hide or display the series
- Clicking the color box will allow that to be changed
- As mentioned above, right c;licking the text opens the dialog box
Over on the related Control panel tabs, checkboxs allow you to control whether
the final count and data type are included in the legends -
enabled by default.
Aggregate Plot
The Aggregate Plot has 2 buttons to add a series
- New Plot erases all the current series and creates a new plot using the currently selected sites
- Add Series appends a new series using the currently selected sites
This plot optionally contains a sub-plot (displayed by default)
that shows the number of sites reporting more than some (configurable) number people (counts).
The default is 10 (no particular reason for this value) that you can change.
Most of the options in this application will produce an immediate effect - this one does not.
It only applies to plots made after the value is changed.
The checkbox will hide the sub-plot.
Individual Plot
This is a much simpler plot since there is no sub-plot.
Series are added by placing the map in single select mode and clicking on individual markers.
A button is provided to clear the plot.
On the Individual Plot tab (in the Control panel),
a button will add up to 20 selected sites to the individual plot.
Using this, you can first select several sites using the Region mode
(which does not add sites to the Individual Plot)
and then add them.
The limit of twenty is just a judgment call
- With 10 or less, the plot is fairly easy to use
- Above 20 (or so), there is just too much confusion
However, you can always make a new selection and add another group - there is no software limit,
just that too much clutter is mostly worthless (but not always).
Selecting Sites
As already mentioned, the application starts with all sites selected.
This makes it easy play an animation and see something right away.
However, part of the power of this application is the ability to compare
one selection of sites to another.
- What happens if New York city is removed from the rest of the US?
- How does Europe compare to the US?
The application provides a number of ways to create a custom selection set.
The first action is always to clear the current selection -
the button is under the map.
There is also the companion Select All button.
Once cleared, all the site markers turn red.
By default, you can select them one-at-a-time by clicking on them - turning them green.
This will also display the site's data In the Individual Plots graph.
Under the map are 4 radio buttons - Add/Remove and Single or Region.
- While Single is selected, clicked sites are added the the Individual Plot
- When Region is selected, clicked sites will NOT be added -
however, all the sites in a small region around the mouse pointer will be selected.
The size of this region is constant and not affected by the map zoom level.
To remove sites from a current selection, either
- Hold the shift key when clicking, or
- Select the Remove radio button before clicking
That works for either Single or Region.
On the Misc tab (in the Control panel),
there is a search control.
This is a partial search - virginia (not case sensitive) matches both
Virginia and West Virginia (and more, depending on which dataset is selected).
The Add/Remove radio buttons determine what a search does.
To perform multiple searches, either
- Repeat the operation - the results are cumulative, or
- Enter several words separated by semi-colons
Additional site selection options will be added to a future release.
Dates Tab
This tab is for reference only - it has no functional components.
Command Line Options
It has been stated many times the "the default is .." -
but many of those can be overridden by adding parameters to the url
(otherwise, known as the command line).
I have those documented some where, but it doesn't matter.
On
the Misc tab (in the Control panel),
there are 3 buttons - each of which generates a command line with the options
already set.
Button
| Action
|
---|
Search by Name
| This adds whatever is typed in the provided space to the command line.
It also perform a partial match search, as described above.
|
---|
First Create Link button
| This will include up to 10 selected sites.
The limit is just to keep from creating extremely long url's.
I have no idea what the internet limit is, and it might even be browser dependent,
so this is just a guess. If you want more - type them yourself.
|
---|
Other Create Link button
| Create a link without any searches.
This is mainly just to select the dataset and page layout while allowing all the sites to still be selected.
|
---|
Included options
- Dataset - one of 9
- Search terms - depending on which button is pressed
- Lat/Long/Zoom - but only if the map is actually zoomed
- Application layout - copied from the current url
- Aggregate plot type - Cumulative (default) or Daily
- Aggregate plot lower sub-graph - display (default) or hide
The intent is for you to copy and past the provided url so that another person can
see almost exactly what you are seeing.
Remember, a lot of the application defaults are not included in this url, only a few
very high level options.
Notes
- The application is written in javascript - period.
No frameworks.
- The data comes from Johns Hopkins
(via github)
and is the same data used in their (excellent, but static)
World Map.
- I have received no money from anyone to create this. It is my own work.
Author:
Robert Clemenzi