Spritz

Software for RNA-Seq analysis to create sample-specific proteoform databases from RNA-Seq data

Project maintained by smith-chem-wisc Hosted on GitHub Pages — Theme by mattgraham

Spritz

Software for RNA-Seq analysis on Windows, including creating sample-specific proteoform databases from genomic data

GitHub Action Builds Release Github All Releases Docker Pulls Follow us on Twitter

Spritz can be downloaded here.

Spritz uses snakemake and a container runtime to install and run commandline tools for Next-Generation Sequencing (NGS) analysis. These tools include an adapted version of SnpEff to annotate sequence variations and create an annotated protein database in XML format. The combinatorics of producing full-length proteoforms from these annotations is written in mzLib’s VariantApplication class.

image

Running Spritz with GUI

  1. Install a container runtime. Podman is recommended: it is Apache-2.0, needs no paid subscription, and is what Spritz uses by default.

    • macOS: brew install podman, then podman machine init && podman machine start
    • Windows: the Podman installer, or winget install RedHat.Podman
    • Linux: your distribution’s package manager

    Docker still works if you already have it — pass --container-runtime docker. On a cluster, see Running Spritz on a cluster with Apptainer.

  2. Allocate resources to the runtime. For Docker there are two ways, described in the Spritz wiki:
    1. The recommended method requires Windows 10 version 2004 and is more robust. Here, we allocate computer resources to Docker like any other program.
    2. The alternate method is available on all Windows versions but is less robust. Here, we allocate computer resources to Docker using a virtual machine that’s packaged with Docker.

  3. Launch Spritz.

    Step 1: Input SRA accessions and/or add FASTQ files.

    • SRAs are added with the button indicating single-end or paired-end.
    • FASTQ files must end with *_1.fastq if single-end, and paired-end sequences must have the same filename other than ending with *_1.fastq and *_2.fastq.

    Step 2: Create and customize your Spritz workflow.

    Step 3: Run Spritz!

    Intro-01

GUI System Requirements

Running Spritz with commandline

Spritz runs on the commandline on macOS, Linux and Windows by running the published container: see Running Spritz from the command line. It needs a container runtime and nothing else, and it is the route CI exercises on every push.

Running snakemake directly on the host also works on Linux and macOS, and is covered on the same page as the advanced route.

Container runtimes

Spritz drives one of three runtimes, all running the same published image:

Runtime Use it for Flag
Podman the default; macOS, Windows, Linux, no Docker Desktop (nothing — it is the default)
Docker you already have it installed --container-runtime docker
Apptainer HPC clusters, where a root daemon is not permitted --container-runtime apptainer

The image is published to both Docker Hub and GitHub Container Registry (ghcr.io/smith-chem-wisc/spritz). Prefer GHCR on a cluster: Docker Hub rate-limits anonymous pulls per IP address, and everyone on a login node shares one. Each release also attaches a .sif for compute nodes with no outbound network.

Test it out! Try constructing the database for U2OS from the paper.

  1. Add SRR629563 to the SRA list.

  2. Create the Spritz workflow. Select “release-97” and “homo_sapiens.”

  3. Run Spritz!

Monitor progress in the Information textbox. The final database named final/combined.spritz.snpeff.protein.withmods.xml.gz can be used to search MS/MS with MetaMorpheus to find variant peptides and proteoforms, possibly with modifications. We recommend performing 1) Calibration, 2) Global PTM Discovery (G-PTM-D), and 3) Search tasks to get the best results.

image

The final database named final/combined.spritz.snpeff.protein.fasta is generated to contain variant protein sequences, and it may be used in other search software, such as Proteome Discoverer, ProSight, and MASH Explorer.

The final database named final/combined.spritz.snpeff.protein.withdecoys.fasta is ready for use in MSFragger. It is generated to contain variant protein sequences with decoy protein sequences appended.

Citations

If you use this Spritz, please cite:

This pipeline uses the following tools: