sourmash tutorials and notebooks

The first three tutorials!

These tutorials are command line tutorials that should work on Mac OS X and Linux. They require about 5 GB of disk space and 5 GB of RAM.

• The first sourmash tutorial - making signatures, comparing, and searching

• Using sourmash LCA to do taxonomic classification

• Analyzing the genomic and taxonomic composition of an environmental genome using GTDB and sample-specific MAGs with sourmash

Background and details

These next four tutorials are all notebooks that you can view, run yourself, or run interactively online via the binder service.

• An introduction to k-mers for genome comparison and analysis

• Some sourmash command line examples!

• Working with private collections of signatures.

• Using sourmash taxonomy with the LIN taxonomic framework.

More information

For more information on analyzing sequencing data with sourmash, check out our longer tutorial.

If you are a Python programmer, you might also be interested in our API examples as well as a short guide to Using the LCA_Database API.

If you prefer R, we have a short guide to using sourmash output with R.

Customizing matrix and dendrogram plots in Python

If you’re interested in customizing the output of sourmash plot, which produces comparison matrices and dendrograms, please see Building plots from sourmash compare output.

Contents:

• The first sourmash tutorial - making signatures, comparing, and searching
  • Install miniconda
  • Enable bioconda
  • Install sourmash
  • Generate a signature for Illumina reads
  • Compare reads to assemblies
  • Make and search a database quickly.
  • Compare many signatures and build a tree.
  • What’s in my metagenome?
• Using sourmash LCA to do taxonomic classification
  • Install miniconda
  • Enable bioconda
  • Install sourmash
  • Download some files
  • Some discussion
• An introduction to k-mers for genome comparison and analysis
  • Running this notebook.
  • What is this?
• Some sourmash command line examples!
  • Running this notebook.
  • What is this?
• sourmash: working with private collections of signatures
  • Running this notebook.
  • What is this?
• Quick Insights from Sequencing Data with sourmash
  • Objectives
  • Introduction to k-mers
  • Why k-mers, though? Why not just work with the full read sequences?
  • Long k-mers are species specific
  • Using k-mers to compare samples
  • Installing sourmash
  • Creating signatures
  • Compare many RNA-seq samples quickly
  • Detect Eukaryotic Contamination in Raw RNA Sequencing data
  • Compare reads to assemblies
  • Make and search a database quickly.
  • What’s in my metagenome?
  • Final thoughts on sourmash
• Analyzing the genomic and taxonomic composition of an environmental genome using GTDB and sample-specific MAGs with sourmash
  • Install sourmash
  • Create a working subdirectory
  • Download a database and a taxonomy spreadsheet.
  • Download and prepare sample reads
  • Find matching genomes with sourmash gather
  • Build a taxonomic summary of the metagenome
  • Interlude: why reference-based analyses are problematic for environmental metagenomes
  • Update gather with information from MAGs
  • Classify the taxonomy of the MAGs; update metagenome classification
  • Interlude: where we are and what we’ve done so far
  • Summary and concluding thoughts
• sourmash Python API examples
  • A first example: two k-mers
  • Introduction: k-mers, molecule types, and hashing.
  • Set operations on hashes
  • Creating MinHash sketches programmatically, from genome files
  • Plotting dendrograms and matrices
  • Saving and loading signature files
  • Going from signatures back to MinHash objects and their hashes -
  • Advanced features of sourmash MinHash objects - scaled and num
  • Working with indexed collections of signatures
• Using the LCA_Database API
  • Running this notebook.
  • What is this?
  • Default taxonomy ranks for lineages
• Using sourmash output with R and other languages
  • R code for working with compare output