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
  • Anatomy of the Timeline Panel
  • Setting the date range filter
  • Playback to see changes over time
  • Units
  • Type: Bar or Normalised Bar
  1. How to use Pathogenwatch
  2. Using The Interactive Collection View

The Timeline Panel

PreviousData TablesNextContext search panel

Last updated 4 months ago

The is layered behind the Data Tables.

The Timeline shows aggregated data as a histogram over time, using the genomes' sample date (collection date or receipt date). This is NOT the upload date the genome was submitted to the PATH-SAFE platform, so it's different from the upload date used in Search filtering.

Note that the available options for granularity (e.g. down to the day) may not be relevant to all data. Genomes will sometimes only have "year" or "year/month" data (e.g. in PATH-SAFE collections).

Genomes with only a "year" will be shown in January of that year. Genomes with a "month" will be shown on the first day of that month.

Note for PATH-SAFE users: are generally configured to pull recently-added genomes, but those new genomes could be represented in the past on the Timeline, especially if they only have "year" data associated with them.

Anatomy of the Timeline Panel

A Filtered Timeline sits above a Timeline Overview.

The Filtered Timeline (top) shows the genomes per unit of time, coloured by the current The Filtered Timeline only shows the data within the selected timeframe.

on the Timeline acts as a filter across all panels.

The Timeline Overview (bottom) always shows the entire date range of the data in the Collection, regardless of what filters are applied.

Selecting bars on the Timeline will highlight that time genomes on other panels.

Setting the date range filter

Playback to see changes over time

Units

Units adjust the width of the bars in both the Filtered and Overview Timelines, as well as the way Playback happens.

Type: Bar or Normalised Bar

  • Bar Chart: shows the number of samples per date unit, stacking each colouring category.

  • Normalised Bar Chart: shows the proportion of samples per colouring category, regardless of the total number of samples, per date unit.

The date range can be set by typing the start and end dates, by using the calendar-based Date-Picker, or by dragging the filters in the Timeline Overview. You may want to change the displayed time to ensure the granularity matches your filtering parameters.

Once the date range has been set, the range window can be dragged back-and-forth to see the same size window over different timeframes.

The timeline can be played to show changes over time. “Speed” affects the speed at which the bars are added to the histogram in Playback mode. This allows you to watch all the panels change over time.

Tip - If the endpoints on the Timeline Overview have been set, then the playback will continue from that endpoint onward. To begin midway through the timeline, select only the first unit of the region you wish to play. To begin at the beginning of the timeline, either select the first bar or the entire timeline.

Adjust the “Unit” lozenge to change the width of the histogram bars (e.g. from “Year” to “Month”)

Adjust the “Type” lozenge if you prefer to view the relative proportion of colours using a Normalised Bar Chart.

Units
Unit
Timeline
Saved Searches
Colour Column.
Changing the date range
unit’s