next.pathogen.watch docs
  • Welcome to Pathogenwatch
  • News & Release Notes
    • Announcements
    • Release Notes 2025
    • Release Notes 2024
    • Release Notes 2023
    • Release Notes 2022
    • Release Notes 2019-2021
  • Getting Started
    • Sign in
    • A Brief Tour of Pathogenwatch
    • Interactive Collection View tutorial
    • Useful Links
  • How to use Pathogenwatch
    • Using the documentation
    • Using The Interactive Collection View
      • The Interactive Collection View
      • The Map Panel
      • The Tree Panel
        • Tree Panel
        • Generating a new tree
      • Data Tables
      • The Timeline Panel
      • Context search panel
      • Legend, Labels, and Colours
      • Searching genomes in a collection
      • Creating sub-collections
    • Genome Uploads & Folders
    • Browsing & Searching Genomes
    • Browsing Collections
    • Creating & Sharing Collections
    • Genome Reports
    • Deleting items
    • SARS-CoV-2 Tutorial
    • Tips and Tricks
  • Technical Descriptions of Analysis Tools
    • Genome Assembly
      • Short Read Assembly
      • Assembling genomes with EToKi
    • Plasmid Annotation
      • Inctyper
    • Assigning species with Speciator
    • Trees, Clustering, and Context Search
      • Core Genome Tree
        • About SNP-based trees
        • Core Assignment
        • Core Filter
        • Reference Assignment
        • Tree Construction
      • cgMLST Clustering & Context Searching
      • SARS-CoV-2 Genome Tree
      • cgMLST Tree
    • Lineage Assignment & Genotyping Methods
      • Genotyphi
      • Kleborate
      • cgMLST
      • Klebsiella LIN Codes
      • MLST
      • NG-MAST
      • Pangolin
      • PopPUNK
      • Vista
      • Finding HierCC codes with hclink
      • SARS-CoV-2 Notable Mutations
    • Serotyping
      • Kaptive
      • SeroBA
      • SISTR
      • ECTyper
    • Antimicrobial Resistance Prediction
      • Pathogenwatch AMR
      • Kleborate AMR
      • SPN-PBP-AMR
      • Resfinder
    • Virulence
      • STECFinder
      • VirulenceFinder
      • BIGSdb schemes
  • WHO bacterial priority pathogens
  • Initiatives powered by Pathogenwatch
    • PATH-SAFE
      • PATH-SAFE Sign in
      • What is the PATH-SAFE Programme?
      • PATH-SAFE powered by Pathogenwatch
      • Two-tool Serotyping with SISTR & SeqSero2
      • S. enterica SNP tree
      • PATH-SAFE analyses
  • How to cite
  • Acknowledgements
  • Privacy and Terms Of Service
  • FAQ
  • Report an Issue
Powered by GitBook
On this page
  • Open the Collection
  • The Interactive Collection View
  • Tree, Map, Tables & Timeline
  • Explore the Collection
  1. Getting Started

Interactive Collection View tutorial

A short walkthrough of several features of the Interactive Collection View.

PreviousA Brief Tour of PathogenwatchNextUseful Links

Last updated 4 months ago

Once you are signed in, you can follow this tutorial using a collection of your own.

Open the Collection

Navigate to the Collections page using either menu (Hamburger or banner). Select a collection.

The Interactive Collection View

Collections are the easiest way of sharing data with colleagues and the general public. Some Collections are pre-built, and accessible from the Collections page.

Tree, Map, Tables & Timeline

    • When you create a Collection, the tree is not created automatically. If it is possible to create a tree, a "generate tree" button will be shown.

The Interactive Collection View's URL is permanent, even if the owner changes the title text. You can bookmark it and return later. If you are signed in and create a Collection, it will be saved to your account.

Explore the Collection

  1. Scroll through the Metadata Table at the bottom to get an idea of the genome data.

Select some data rows, and notice that the Map Panel and Tree panel highlight the location for that genome. Use the Table menu to “Hide unselected entries.” This applies in each table separately.

Change column width by dragging the sides of a column header or by using the column’s filter icon and the “expand column” icon.

  1. Hover on a column header: A filter icon appears, and can be used to open the column's filtering menu.

  2. In the column's filtering menu, Click "Sort" options to order the rows based on the values in the column. Note that these may be alpha-sorted, not numerically.

  3. Open "Filter by values" and select some options, then "APPLY FILTER" - all panels are filtered. Clear the filter.

Filtering by condition allows you to set number- or text-based specifications (depending on the column type), including the use of regular expressions for text columns.

Genomes (rows) with values that are not selected or do not meet conditions will be filtered out from all panels, until/unless the filter is cleared.

  1. Click on the the highlighted marker, and notice that a number of rows get selected (all the genomes from that location, not just the one you originally selected in the table), and those genomes are highlighted in the tree too.

  1. Clear all filters by clicking the filter icon at the right of the "Search in all columns" search & filter bar (top center). "reset all filters."

  1. In the Metadata Table, click on the filter icon for a column to see how many values it contains: This will affect how many colour palettes are available for that column.

  1. Select "No. contigs" as the Colour Column, and select "Gradient" in the Colour Palette option. Click on the colour band.

  1. Change Colour Column to "Name"

  2. Open the Tree Panel Menu and click "Metadata Blocks"

  3. Add "No. Contigs" and the other columns you set palettes for. Note that the resulting Metadata Blocks are coloured with the palettes you selected.

  1. Open the Legend using the right side panel.

Opening (or creating) a Collection brings up the , displaying all genomes in the Collection in multiple panels.

: a core distance-based neighbour-joining tree, viewed using PhyloCanvas (top left)

: shows all genomes in the collection that have a location associated with them (top right).

, & (bottom)

Adjust row height using “Density"

Choose which data columns to show/hide on the active table using the filter icon "Columns" lozenge and tickboxes (or the "Search" and "Select all" options to quickly select subsets of columns)

Show/hide an individual column by using the show/hide icon that appeared.

Now click on the Settings icon in the , and notice that zoom icons appeared in the bottom right corner. Zoom in (using your mouse wheel or the zoom icons) until the map only shows two or three markers, including the highlighted one.

Select the "" icon in the Map menu and notice that all genomes not currently shown on the map are hidden from all panels. The highlighted genomes remain highlighted until you click on a blank area of the Map or Tree. Select the Viewport icon again to clear that filter.

Select the , which is layered behind the . Click on a bar and it highlights in other panels. Adjust the "Unit" lozenge and "Type." Filter the date range by dragging the "Timeline Overview" (bottom timeline) rightmost bar. This also affects other Panels.

Open the settings menu and select different tree styles.

Click on the eye icon in the upper right corner of the dashboard. Click on "." Start typing your column name until it shows, then select it. Click on "Colour Palette" and set "Number of Colours" to be greater than the values in your column. Select a pallette. Notice that the tree colours change accordingly.

Select a new column as the Colour Column, and toggle "Custom Palette." Click on the colour box and choose specific colours. CLICK "CONFIRM" in the bottom right before closing the palette windows! (you may need to click in the white space first, see #4)

Choose the "Genes" or "Antibiotics" table. Click on a column header, and notice that the tree leaves, map markers, and legend change with this quick column-header method of setting the Colour Column.

Interactive Collection View
Tree
Map
Metadata table, Analysis Results
Timeline
Timeline Panel
Data Tables
Map Panel
Tree Panel
Viewport
Colour Column
side hamburger menu
top banner menu
Example collection