How do I use the interactive map on a pathogen dashboard?

Understanding the Map Views

The map has two primary visualization modes that you can switch between to explore the data differently.

1. Regional Bubbles (Default View)

This is the default view when you land on a pathogen dashboard. Each bubble on the map represents a geographic region (like a province or state). The size of the bubble corresponds to the total number of isolates reported in that region for the selected time period. At wider zoom levels, nearby bubbles will automatically cluster together into larger bubbles to give you a high-level overview of isolate density.

2. Lineage Donuts

This view allows you to see the proportional breakdown of different genetic lineages within a region. Each cluster on the map is represented by a donut chart. The size of each colored segment in the donut reflects the proportion of a specific lineage within that cluster, making it easy to spot geographic hotspots for certain lineages.

How to Switch Views

To switch from Regional Bubbles to Lineage Donuts:

1. Navigate to the "Lineages" card in the side panel.
2. Toggle the "Show on map" switch to the "on" position.
3. The map will automatically update to display the lineage donut clusters. Toggling the switch off will return you to the default Regional Bubbles view.

Filtering the Map Data

The map is fully interactive and responds to the global controls in the header and the filters you apply in the side panel. Filters work together to narrow down the results shown on the map.

• Temporal (Time) Filtering: The date controls in the header are the primary way to filter by time. You can switch between viewing the last 12 months of data or focusing on a specific month. The data displayed on the map will automatically update to reflect your selected time period.
• Geographic Filtering: In the "Locations" card, clicking on a country or province will filter all dashboard data and automatically zoom the map to that specific area. You can use the breadcrumbs at the top of the page to zoom back out.
• Lineage Filtering: When the "Show on map" switch is enabled, you can use the checkboxes next to each lineage in the "Lineages" card. Unchecking a lineage will remove it from the map's visualization, allowing you to focus on the geographic spread of specific lineages of interest.

For example, by selecting "Kenya" in the Locations card and setting the timeframe to "July 2024", the map will only show isolates collected in Kenya during July 2024.

Navigating the Map

• Zoom & Pan: Use your mouse or the on-screen controls to zoom in and out or pan across the map.
• Pop-ups: Hovering over a donut will display a pop-up with detailed information on the isolate count by lineage.