Skip to content

Commit 40e8902

Browse files
authored
Merge pull request #64 from CCBR/docs_readme
docs: Update readme
2 parents b799370 + 683c8e4 commit 40e8902

File tree

1 file changed

+19
-18
lines changed

1 file changed

+19
-18
lines changed

README.md

+19-18
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,15 @@ Original pipelining and code forked from the CCBR Exome-seek Pipeline [Exome-see
1919
[singularity](https://singularity.lbl.gov/all-releases) must be installed on the target system. Snakemake orchestrates the execution of each step in the pipeline. To guarantee the highest level of reproducibility, each step relies on versioned images from [DockerHub](https://hub.docker.com/orgs/nciccbr/repositories). Nextflow uses singularity to pull these images onto the local filesystem prior to job execution, and as so, nextflow and singularity are the only two dependencies.
2020

2121
## Setup
22-
LOGAN is installed on the Biowulf in the ccbrpipeliner module.
23-
Please clone this repository to your local filesystem using the following command:
22+
LOGAN can be used with the Nextflow pipelining software
23+
Please clone this repository to your local filesystem using the following command on Biowulf:
2424
```bash
2525
# start an interactive node
2626
sinteractive --mem=2g --cpus-per-task=2 --gres=lscratch:200
27-
# load the ccbrpipeliener module
28-
module load ccbrpipeliner
27+
git clone https://github.com/CCBR/LOGAN
28+
module load nextflow
29+
##Example run
30+
nextflow run /data/LOGAN//main.nf
2931
```
3032

3133
## Usage
@@ -89,17 +91,17 @@ c130889189_TUMOR c130889189_PBMC
8991

9092
#### 2. Tumor only mode
9193

92-
No flags are required
94+
No addtional flags for sample sheet are required as all samples will be used to call variants
9395

9496
#### Calling Mode
9597

9698
Adding flags determines SNV (germline and/or somatic), SV, and/or CNV calling modes
9799

98100
`--vc`- Enables somatic SNV calling using mutect2, vardict, varscan, octopus, strelka (TN only), MUSE (TN only), and lofreq (TN only)
99101

100-
`--germline`- Enables germline using DV
102+
`--germline`- Enables germline using Deepvariant
101103

102-
`--sv`- Enables somatic SV calling using Manta and SVABA
104+
`--sv`- Enables somatic SV calling using Manta, SVABA, and GRIDSS (coming soon)
103105

104106
`--cnv`- Enables somatic CNV calling using FREEC, Sequenza, and Purple (hg19/hg38 only)
105107

@@ -111,33 +113,32 @@ Adding flags determines SNV (germline and/or somatic), SV, and/or CNV calling mo
111113
`--callers`- Comma separated argument for callers, the default is to use all available.
112114
Example: `--callers mutect2,octopus`
113115

114-
`--cnvcallers`- - Comma separated argument for cnvcallers. Adding flag allows only certain callers to run.
116+
`--cnvcallers`- - Comma separated argument for CNV callers to use. Adding flag allows only certain callers to run.
115117
Example: `--cnvcallers purple`
116118

119+
`--svcallers`- - Comma separated argument for SV callers. Adding flag allows only certain callers to run.
120+
Example: `--cnvcallers manta`
121+
117122

118123
## Running LOGAN
119124
Example of Tumor_Normal calling mode
120125
```bash
121-
# copy the logan config files to your current directory
122-
logan init
123126
# preview the logan jobs that will run
124-
logan run --mode local -profile ci_stub --genome hg38 --sample_sheet samplesheet.tsv --outdir out --fastq_input "*R{1,2}.fastq.gz" -preview --vc --sv --cnv
127+
nextflow run /data/LOGAN/main.nf --mode local -profile ci_stub --genome hg38 --sample_sheet samplesheet.tsv --outdir out --fastq_input "*R{1,2}.fastq.gz" -preview --vc --sv --cnv
125128
# run a stub/dryrun of the logan jobs
126-
logan run --mode local -profile ci_stub --genome hg38 --sample_sheet samplesheet.tsv --outdir out --fastq_input "*R{1,2}.fastq.gz" -stub --vc --sv --cnv
129+
nextflow run /data/LOGAN/main.nf --mode local -profile ci_stub --genome hg38 --sample_sheet samplesheet.tsv --outdir out --fastq_input "*R{1,2}.fastq.gz" -stub --vc --sv --cnv
127130
# launch a logan run on slurm with the test dataset
128-
logan run --mode slurm -profile biowulf,slurm --genome hg38 --sample_sheet samplesheet.tsv --outdir out --fastq_input "*R{1,2}.fastq.gz" --vc --sv --cnv
131+
nextflow run /data/LOGAN/main.nf --mode slurm -profile biowulf,slurm --genome hg38 --sample_sheet samplesheet.tsv --outdir out --fastq_input "*R{1,2}.fastq.gz" --vc --sv --cnv
129132
```
130133

131134
Example of Tumor only calling mode
132135
```bash
133-
# copy the logan config files to your current directory
134-
logan init
135136
# preview the logan jobs that will run
136-
logan run --mode local -profile ci_stub --genome hg38 --outdir out --fastq_input "*R{1,2}.fastq.gz" --callers octopus,mutect2 -preview --vc --sv --cnv
137+
nextflow run /data/LOGAN/main.nf --mode local -profile ci_stub --genome hg38 --outdir out --fastq_input "*R{1,2}.fastq.gz" --callers octopus,mutect2 -preview --vc --sv --cnv
137138
# run a stub/dryrun of the logan jobs
138-
logan run --mode local -profile ci_stub --genome hg38 --outdir out --fastq_input "*R{1,2}.fastq.gz" --callers octopus,mutect2 -stub --vc --sv --cnv
139+
nextflow run /data/LOGAN/main.nf --mode local -profile ci_stub --genome hg38 --outdir out --fastq_input "*R{1,2}.fastq.gz" --callers octopus,mutect2 -stub --vc --sv --cnv
139140
# launch a logan run on slurm with the test dataset
140-
logan run --mode slurm -profile biowulf,slurm --genome hg38 --outdir out --fastq_input "*R{1,2}.fastq.gz" --callers octopus,mutect2 --vc --sv --cnv
141+
nextflow run /data/LOGAN/main.nf --mode slurm -profile biowulf,slurm --genome hg38 --outdir out --fastq_input "*R{1,2}.fastq.gz" --callers octopus,mutect2 --vc --sv --cnv
141142
```
142143

143144

0 commit comments

Comments
 (0)