Skip to main content

An inference tool for tumour subclonal composition

Project description


FastClone is a fast algorithm to infer tumour heterogeneity. Given somatic mutation frequencies and copy number data, FastClone infers subclonal composition and phylogeny. The algorithm won the first place in DREAM Somatic Mutation Calling -- Heterogeneity Challenge.


FastClone needs Python 3.5 or later version. It needs logbook, python-fire, scikit-learn, and pandas. To install the package using Pip,

git clone
pip install FastClone_GuanLab/

(Please make sure you have the slash at the end, which forces pip to install from local directory, otherwise it will run into error)

You also can directly pip install FastClone with the command below.

pip install fastclone-guanlab


FastClone accepts either MuTect VCF + Battenberg format (specified in the DREAM SMC-Het Challenge) or PyClone format.

The general format of the command line:


(If purity is unavailable, input "None" at the position of [TUMOUR__PURITY], and FastClone will infer purity automatically)

A pseudo example to load samples and infer (t1.tsv is included in this repository):

fastclone load-pyclone prop t1.tsv 0.8 solve ./fastclone_result

(Please make sure t1.tsv is under your current directory. Note this pseudo example only has one clone with a purity ~0.15)

Run fastclone for more help information.

If MuTect VCF and PyClone samples are provided, note that MuTect mutations are labelled as 'Chromosome:Coordinate:AltBase', such as 'Y:15989697:G'. Make sure PyClone ID uses the same ID.

Separately, will infer purity (whether a starter value is given or not), and subclone identification and assignment; will infer phylogeny.


1.subclones.csv gives proportion of each clone in a tumor sample.

2.scores.csv gives SNPs assignment. Each column corresponding to a clone, and the entries in each column indicates how likely the SNP is assigned to the clone.

3.phylogeny.png shows the tree structure of clones.

(We named clones with numeric values, which start from 0, and the names are consistent within all output files)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for fastclone-guanlab, version 1.0.5
Filename, size File type Python version Upload date Hashes
Filename, size fastclone_guanlab-1.0.5-py3-none-any.whl (22.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size fastclone-guanlab-1.0.5.tar.gz (9.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page