Long Ranger is a set of analysis pipelines that processes Chromium sequencing output to align reads and call and phase SNPs, indels, and structural variants.
Long Ranger is available as a module on Apocrita.
To run the default installed version of Long Ranger, simply load the
$ module load longranger $ longranger longranger (<VERSION>) Copyright (c) 2017 10x Genomics, Inc. All rights reserved. ------------------------------------------------------------------------------- Usage: longranger mkfastq longranger demux ...
For more information regarding each analysis pipeline, pass the
switch after the pipeline sub-command (i.e.
longranger wgs --help).
Running Long Ranger in cluster mode
To run Long Ranger jobs on Apocrita, pass the
This will make the underlying Martian pipeline framework launch each
stage through the scheduler
As stages' jobs are queued, launched, and completed, the pipeline framework will track their states using the metadata files that each stage maintains in the pipeline output directory.
We have configured a template (located at:
sge.template) with the default settings:
- Bash Shell
- Single Machine Processing PE
- 24 hour run time
- Execution in the current working directory
The above settings will be used per job, so each stage will have a 24 hour runtime.
Core Requests and Consumption
The number of cores required is determined by the pipeline framework stage however, Martian jobs will run with only 1 thread.
Memory Requests and Consumption
To specify the memory-per-core resource (
h_vmem), pass the
--mempercore switch. This value will be used at all pipeline
Here is an example job to submit each stage (with 4GB per core), running with 1 core and 1G memory:
#!/bin/bash #$ -cwd #$ -j y #$ -pe smp 1 #$ -l h_rt=24:0:0 #$ -l h_vmem=1G module load longranger longranger wgs --id 1234 --fastqs raw_data.fastq \ --reference /share/apps/centos7/longranger/<VERSION>/reference_data/GRCh38 \ --sample 1234 \ --jobmode=sge --mempercore=4
Long Ranger can also be submitted from within a
qlogin session; replace
<COMMAND> with the actual command to be executed (see example above).
qlogin -pe smp 1 -l h_vmem=1G -l h_rt=24:0:0 -j y module load longranger longranger <COMMAND>
Chromium references are available at: