Skip to content
online notebooks for a review of genome sketching
Jupyter Notebook Python
Branch: master
Clone or download
Latest commit 080e0e6 Sep 23, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
binder adding more tests Apr 12, 2019
data adding sample Apr 9, 2019
notebooks updating notebooks Aug 27, 2019
paper updating figures Aug 27, 2019
.travis.yml adding travis Apr 12, 2019
LICENSE first commit Apr 8, 2019 Update Sep 14, 2019 adding ganon to refs Sep 23, 2019

Genome Sketching

a review of sketching algorithms for genomic data

travis DOI binder


This repository accompanies my review of sketching algorithms for genomic data:

When The Levee Breaks: a practical guide to sketching algorithms for processing the flood of genomic data

The notebooks correspond to the sections in the paper:

I've also included a notebook to cover some basic concepts (e.g. k-mer decomposition). This notebook is called Background and we save ourselves some time later by importing the functions from this notebook into the other notebooks (e.g. for reading sequence data files).

If you've not used a Jupyter notebook before, just hit "shift + enter" to run a cell. Here is a good guide to get you started with Jupyter.

Running the workbooks

To run the workbooks interactively from your browser, use Binder:


Running the workbooks locally

If you want to run the workbooks locally, you'll need conda and jupyter.

Once you have these, follow these steps:

  1. clone the repo
git clone

cd genome-sketching
  1. create the environment
conda env create --file=binder/environment.yml

source activate genome-sketching
  1. run the notebook server
jupyter notebook --notebook-dir=./notebooks

See also

As well as the notebooks, this repository also contains a curated list of bioinformatics tools that use sketching. Please let me know if tools need adding, or file a pull request!


I'd like to thank Titus Brown and Luiz Irber, who not only got me onto Binder, but also inspired me to review the current sketching methods for genomics (thanks to their excellent sourmash documentation and examples of MinHash for genomics).

Thanks to Francesco Mosconi for showing how to use Travis CI for build testing the notebooks.

You can’t perform that action at this time.