Long Ranger1.3, printed on 11/14/2024
The longranger run command provides the means to define samples according to the output of a single longranger demux's output FASTQs. While this sample specification (i.e., one flowcell per sample) is the most common, high-depth sequencing often involves sequencing a single sample using multiple flowcells. To this end, the longranger run pipeline allows complex sample construction such as combining sample indices from multiple flowcells into a single sample.
To create complex sample specifications, you will have to write your own MRO file for the longranger run pipeline. MRO is the language used to define pipelines to the Martian pipeline framework which is responsible for managing pipeline execution. The longranger run command is simply a shell script that converts command line arguments into an MRO file which is passed to the Martian pipeline execution command, mrp, and writing MROs directly allows you to access the full range of options available for each pipeline.
The easiest way to write your own MRO is to start with the MRO from a previous pipeline. Assuming you have already run a single-flowcell sample (e.g., sample345) from the same run mode (e.g., Whole Genome Mode) you will be using for your multi-flowcell sample, examine the _invocation file contained in its output directory:
$ cat sample345/_invocation @include "phaser_svcaller_cs.mro" call PHASER_SVCALLER_CS( fastq_mode = "BCL_PROCESSOR", sample_id = "sample345", sample_def = [ { "gem_group": null, "lanes": null, "read_path": "/home/jdoe/runs/HBA2TADXX", "sample_indices": [ "any" ] } ], reference_path = "/opt/refdata-hg19-1.2.0", sample_desc = "", sex = "f", targets = null, vc_mode = "freebayes", vc_ground_truth = null, restrict_locus = null, )
The sample_def argument controls the parameters used to define this sample and is a JSON-encoded list of maps that define:
Make a copy of this _invocation file; this will be the MRO from which we will build our multi-flowcell invocation MRO.
Continuing with the example MRO above, we would make the following changes:
For example, the two-flowcell MRO may appear as
$ cp sample345/_invocation sample345-multi.mro $ nano sample345-multi.mro ... $ cat sample345-multi.mro @include "phaser_svcaller_cs.mro" call PHASER_SVCALLER_CS( fastq_mode = "BCL_PROCESSOR", sample_id = "sample345-multi", sample_def = [ { "gem_group": null, "lanes": null, "read_path": "/home/jdoe/runs/HAWT7ADXX", "sample_indices": [ "any" ] }, { "gem_group": null, "lanes": null, "read_path": "/home/jdoe/runs/HAWPUADXX", "sample_indices": [ "any" ] } ], reference_path = "/opt/refdata-hg19-1.2.0", sample_desc = "", sex = "f", targets = null, vc_mode = "freebayes", vc_ground_truth = null, restrict_locus = null, )
where the changes from the original MRO are highlighted.
Once you have this multi-flowcell MRO, confirm that its syntax is valid with mrc, the MRO compiler included with Long Ranger:
$ mrc sample345-multi.mro Successfully compiled 1 mro files.
A MRO ParseError: unexpected token error suggests that your sample_def entry is not valid JSON. Ensure that your commas are (and are not) present after each item. |
Then run the MRO file using longranger run command's alternate MRO-mode syntax:
$ longranger run sample345-multi sample345-multi.mro --uiport=3600 Martian Runtime - 1.3.1 Serving UI at http://localhost:3600 Running preflight checks (please wait)... 2012-01-01 12:00:00 [runtime] (ready) ID.sample345-multi.PHASER_SVCALLER_CS.PHASER_SVCALLER._ALIGNER.SETUP_CHUNKS 2012-01-01 12:00:00 [runtime] (run:local) ID.sample345-multi.PHASER_SVCALLER_CS.PHASER_SVCALLER._SNPINDEL_PHASER.SORT_GROUND_TRUTH 2012-01-01 12:00:00 [runtime] (run:local) ID.sample345-multi.PHASER_SVCALLER_CS.PHASER_SVCALLER._SNPINDEL_PHASER.SORT_GROUND_TRUTH.fork0.chnk0.main
where