sourmash
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 3.
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 Rust environment (for the
extension code). We suggest using rustup to install the Rust environment:
curl https://sh.rustup.rs -sSf | sh
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 Python library and command-line interface code.
The src/core/ directory contains the Rust library implementing core
functionality.
Tests require py.test and can be run with make test.
Please see the developer notes for more information.
CTB Jan 2020
Release files for sourmash 3.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sourmash-3.2.3.tar.gz | 7.3 MB | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sourmash-3.2.3-py2.py3-none-manylinux2010_x86_64.whl | Python 2, Python 3 | none | Linux glibc 2.12+ x86-64 | Details |
| sourmash-3.2.3-py2.py3-none-manylinux1_x86_64.whl | Python 2, Python 3 | none | Linux glibc 2.5+ x86-64 | Details |
| sourmash-3.2.3-py2.py3-none-macosx_10_11_intel.whl | Python 3, Python 2 | none | macOS 10.11+ Intel (x86-64, i386) | Details |
Total release size: 9.9 MB
Release files / sourmash-3.2.3.tar.gz
| Download URL | sourmash-3.2.3.tar.gz |
|---|---|
| Size | 7.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bcb4c44bca22f3510fc2947b16501ffda9029dc95a9860ae51f2be771150e469
|
|
BLAKE2b-256 checksum How to use checksums |
14c1cef2b0299f78e461622fcb9de4580eb40e7ea5e78932d4282c9c9c552314
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.6
|
Release files / sourmash-3.2.3-py2.py3-none-manylinux2010_x86_64.whl
| Download URL | sourmash-3.2.3-py2.py3-none-manylinux2010_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Linux glibc 2.12+ x86-64 Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
93429bf55cdc5b3e66af03a9f769da9f5e3eb78ffe6a0bc635f5fb87726a8695
|
|
BLAKE2b-256 checksum How to use checksums |
4d64044e4584ca78ee9b2b958913828101eff45962b59d2bbcf5e2083014aa5e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.1.0.post20200119 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.6
|
Release files / sourmash-3.2.3-py2.py3-none-manylinux1_x86_64.whl
| Download URL | sourmash-3.2.3-py2.py3-none-manylinux1_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Linux glibc 2.5+ x86-64 Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
04f0163973bd73a9aa7f02d4e1dcf6d600d9f0144647ce931dd36fa2e5f3372d
|
|
BLAKE2b-256 checksum How to use checksums |
a57854151fa901c6423f724b639979fc24cf40fe68a968039e2bc52a841408c0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.1.0.post20200119 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.6
|
Release files / sourmash-3.2.3-py2.py3-none-macosx_10_11_intel.whl
| Download URL | sourmash-3.2.3-py2.py3-none-macosx_10_11_intel.whl |
|---|---|
| Size | 473.8 kB |
| Tags | Python 2 Python 3 macOS 10.11+ Intel (x86-64, i386) |
|
SHA-256 checksum How to use checksums |
5cbffb83bb8241b2ce9fedf3a1226095548b0a8842ffedf74adbc75ec8040347
|
|
BLAKE2b-256 checksum How to use checksums |
75b176fd7773d55b0e6964946eb435507036e2889291b9cce646bfd5ea4f409d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.1.0.post20200119 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.6
|
