Cluster Detection

Polecat

Phylogenetic Cluster Analysis Tool

A powerful tool from the ARTIC Network for identifying and flagging meaningful clusters in phylogenetic data. Designed for real-time genomics workflows with configurable statistical thresholds.

ARTIC
Network
Python
64.6%
GPL-3.0
License
Features

Cluster Detection Capabilities

Polecat automatically identifies meaningful clusters in phylogenetic trees using configurable statistical parameters.

Phylogenetic Analysis

Works with background phylogenies from COG-UK infrastructure or custom trees.

Cluster Detection

Automatically identifies and flags clusters based on adjustable parameters.

Configurable Statistics

Fine-tune detection thresholds for different surveillance scenarios.

Real-time Workflows

Designed for integration into live genomic surveillance pipelines.

Customizable Reports

Generate summary reports with cluster information and statistics.

CLIMB Integration

Works seamlessly with COG-UK CLIMB infrastructure.

Workflow

How Polecat Works

Polecat accepts a background phylogeny and uses statistical methods to automatically detect and report meaningful clusters.

1

Input Phylogeny

Provide a background phylogenetic tree (e.g., from COG-UK).

2

Configure Parameters

Set statistical thresholds for cluster detection.

3

Cluster Detection

Algorithm identifies clusters meeting your criteria.

4

Generate Reports

Output summary reports with cluster statistics.

Terminal
# Clone the repository
$ git clone https://github.com/artic-network/polecat.git
$ cd polecat
# Install dependencies
$ conda env create -f environment.yml
$ conda activate polecat
# Run polecat
$ polecat \
--tree phylogeny.nwk \
--metadata metadata.csv \
--output-dir results/
# Output
results/
├── cluster_report.html
├── cluster_summary.csv
└── figures/
Collaboration

Part of the ARTIC Network

Polecat is developed by the Rambaut Group at Edinburgh University as part of the ARTIC Network's suite of tools for real-time genomic surveillance.

Rambaut Group

Institute of Evolutionary Biology, University of Edinburgh

ARTIC Network

Real-time molecular epidemiology for outbreak response

COG-UK

COVID-19 Genomics UK Consortium integration

Start detecting clusters

Install Polecat and integrate cluster detection into your genomic surveillance workflow.