tools for comparing DNA sequences with MinHash sketches
Project description
sourmash
Quickly search, compare, and analyze genomic and metagenomic data sets.
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 was initially developed by the Lab for Data-Intensive Biology at the UC Davis School of Veterinary Medicine, and now includes contributions from the global research and developer community.
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 Python 3.7 and later. The base requirements are screed, cffi, numpy, matplotlib, and scipy. Conda (see below) will install everything necessary, and is our recommended installation method.
Installation with conda
Bioconda is a channel for the conda package manager with a focus on bioinformatics software. After installing conda, 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 released version.
Support
Please ask questions and files issues on Github.
Development
Development happens on github at dib-lab/sourmash.
sourmash is developed in Python and Rust, and you will need a Rust environment to build it; see the developer notes for our suggested development setup.
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 on getting set up with a development environment.
CTB July 2020
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
File details
Details for the file sourmash-3.5.0.tar.gz.
File metadata
- Download URL: sourmash-3.5.0.tar.gz
- Upload date:
- Size: 7.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.3.1.post20200810 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 70745435055942a3772f27e28a6b4c27fa2bfd308978ee983f2cda56c3ebf546 |
|
| MD5 | 8383291fd3057a30b26acaa32dd1e0ff |
|
| BLAKE2b-256 | d0fe7e0398f553d57c11922bd268e218874171b8167ff99f449305398ef58385 |
Provenance
File details
Details for the file sourmash-3.5.0-py2.py3-none-manylinux2014_ppc64le.whl.
File metadata
- Download URL: sourmash-3.5.0-py2.py3-none-manylinux2014_ppc64le.whl
- Upload date:
- Size: 1.3 MB
- Tags: Python 2, Python 3
- Uploaded using 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
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | ad7b739f0e5ad4dccb5118aafd5168b50f6e3987988ae18b97b085b647ce5bfe |
|
| MD5 | 89f7107e65899e6be2c9e2945554667e |
|
| BLAKE2b-256 | 9cbe4bf8e6d20a0d08af2538df1ace43d8b6fbe9b4d5f40837c8381adbd8c9bf |
Provenance
File details
Details for the file sourmash-3.5.0-py2.py3-none-manylinux2014_aarch64.whl.
File metadata
- Download URL: sourmash-3.5.0-py2.py3-none-manylinux2014_aarch64.whl
- Upload date:
- Size: 1.1 MB
- Tags: Python 2, Python 3
- Uploaded using 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
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 63a6c62883b8e5b24f47164539868c210f6df7f2e6e8e174bd47af8f6113216a |
|
| MD5 | 0f8840177bfa86d36bd0b02dfc83cb33 |
|
| BLAKE2b-256 | 1be4ae77a801ff4262097a2353e5971b992030e8354c615a1eb61cee0b84f1fc |
Provenance
File details
Details for the file sourmash-3.5.0-py2.py3-none-manylinux2010_x86_64.whl.
File metadata
- Download URL: sourmash-3.5.0-py2.py3-none-manylinux2010_x86_64.whl
- Upload date:
- Size: 1.1 MB
- Tags: Python 2, Python 3, manylinux: glibc 2.12+ x86-64
- Uploaded using 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
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 8207fcdd51fab1003e2aa7efb92b2a4d75ba185de06c7d6db3b8718650927e98 |
|
| MD5 | ec7672c89731a41177257a9657e1a131 |
|
| BLAKE2b-256 | 3a2919afebff1a8defed2fc40089cc4c8a66561bf3f1bf494d4d7cc875569a21 |
Provenance
File details
Details for the file sourmash-3.5.0-py2.py3-none-manylinux1_x86_64.whl.
File metadata
- Download URL: sourmash-3.5.0-py2.py3-none-manylinux1_x86_64.whl
- Upload date:
- Size: 1.1 MB
- Tags: Python 2, Python 3
- Uploaded using 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
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2010b0ef875b6cfcd1959747861dff93c3c189a255b7b376369998d6fd851bf9 |
|
| MD5 | bf593c36e86dc7fa3f753b290c68269a |
|
| BLAKE2b-256 | 3e3a87be1e7093d6b855de11e1c18b8a6a8f09478d8ffe253c47e0d6dc64b3e7 |
Provenance
File details
Details for the file sourmash-3.5.0-py2.py3-none-macosx_10_11_x86_64.whl.
File metadata
- Download URL: sourmash-3.5.0-py2.py3-none-macosx_10_11_x86_64.whl
- Upload date:
- Size: 486.5 kB
- Tags: Python 2, Python 3, macOS 10.11+ x86-64
- Uploaded using 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
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | dfcb0a54774bc0136c8c96ac0bc3f7d08f37586a41301b06c9cc56221b0fc1fb |
|
| MD5 | 18dab25b813b26755b686dface6d3ba6 |
|
| BLAKE2b-256 | 4f4c80b3aabf776ea88d00c76555404e89f9ece0f4b12ebfe65489211551b24b |
