Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

tools for comparing DNA sequences with MinHash sketches

Project description

sourmash

Documentation Build Status codecov DOI

Compute MinHash signatures for nucleotide (DNA/RNA) and protein sequences.

Usage:

sourmash compute *.fq.gz
sourmash compare *.sig -o distances
sourmash plot distances

Sourmash 1.0 is published on JOSS; please cite that paper if you use sourmash (doi: 10.21105/joss.00027):.


The name is a riff off of Mash, combined with @ctb's love of whiskey. (Sour mash is used in making whiskey.)

Primary authors: C. Titus Brown (@ctb) and Luiz C. Irber, Jr (@luizirber).

sourmash is a product of the Lab for Data-Intensive Biology at the UC Davis School of Veterinary Medicine.

Installation

We recommend using bioconda to install sourmash:

conda install -c conda-forge -c bioconda sourmash

This will install the latest stable version of sourmash 2.

You can also use pip to install sourmash:

pip install sourmash

A quickstart tutorial is available.

Requirements

sourmash runs under both Python 2.7.x and Python 3.5+. The base requirements are screed and ijson, together with a C++ development environment and the CPython development headers and libraries (for the C++ extension).

The comparison code (sourmash compare) uses numpy, and the plotting code uses matplotlib and scipy, but most of the code is usable without these.

For search and gather you also need khmer version 2.1+.

Installation with conda

Bioconda is a channel for the conda package manager with a focus on bioinformatics software. After installing conda you will need to add the bioconda channel as well as the other channels bioconda depends on. Once you have setup bioconda, you can install sourmash by running:

$ conda create -n sourmash_env -c conda-forge -c bioconda sourmash python=3.7
$ source activate sourmash_env
$ sourmash compute -h

which will install the latest alpha release.

Support

Please ask questions and files issues on Github.

Development

Development happens on github at dib-lab/sourmash.

After installation, sourmash is the main command-line entry point; run it with python -m sourmash, or do pip install -e /path/to/repo to do a developer install in a virtual environment.

The sourmash/ directory contains the library code.

Tests require py.test and can be run with make test.

Please see the developer notes for more information.


CTB Dec 2018

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 sourmash, version 2.2.0
Filename, size File type Python version Upload date Hashes
Filename, size sourmash-2.2.0-cp27-cp27m-macosx_10_6_intel.whl (182.3 kB) File type Wheel Python version cp27 Upload date Hashes View hashes
Filename, size sourmash-2.2.0-cp27-cp27m-manylinux1_x86_64.whl (492.8 kB) File type Wheel Python version cp27 Upload date Hashes View hashes
Filename, size sourmash-2.2.0-cp27-cp27mu-manylinux1_x86_64.whl (492.7 kB) File type Wheel Python version cp27 Upload date Hashes View hashes
Filename, size sourmash-2.2.0-cp34-cp34m-macosx_10_6_intel.whl (179.6 kB) File type Wheel Python version cp34 Upload date Hashes View hashes
Filename, size sourmash-2.2.0-cp34-cp34m-manylinux1_x86_64.whl (521.4 kB) File type Wheel Python version cp34 Upload date Hashes View hashes
Filename, size sourmash-2.2.0-cp35-cp35m-macosx_10_6_intel.whl (181.3 kB) File type Wheel Python version cp35 Upload date Hashes View hashes
Filename, size sourmash-2.2.0-cp35-cp35m-manylinux1_x86_64.whl (521.7 kB) File type Wheel Python version cp35 Upload date Hashes View hashes
Filename, size sourmash-2.2.0-cp36-cp36m-macosx_10_6_intel.whl (184.8 kB) File type Wheel Python version cp36 Upload date Hashes View hashes
Filename, size sourmash-2.2.0-cp36-cp36m-manylinux1_x86_64.whl (530.1 kB) File type Wheel Python version cp36 Upload date Hashes View hashes
Filename, size sourmash-2.2.0-cp37-cp37m-macosx_10_6_intel.whl (180.9 kB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size sourmash-2.2.0-cp37-cp37m-manylinux1_x86_64.whl (528.9 kB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size sourmash-2.2.0.tar.gz (7.3 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page