Skip to content

Commit

Permalink
Updated cli page
Browse files Browse the repository at this point in the history
  • Loading branch information
ZhuBry committed Jan 2, 2024
1 parent 4fac566 commit 3ec2291
Showing 1 changed file with 82 additions and 24 deletions.
106 changes: 82 additions & 24 deletions website/docs/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,15 @@ title: Command Line Reference
This is the subcommand that will kick off the tool. This will always follow directly after the call to the Lancet executable

```bash
lancet2 pipeline --help
lancet2 pipeline -t /path/to/tumor.bam -n /path/to/normal.bam -r /path/to/ref.fasta -o /path/to/out_prefix
./Lancet2 pipeline --help
./Lancet2 pipeline -t /path/to/tumor.bam -n /path/to/normal.bam -r /path/to/ref.fasta -o /path/to/out_prefix
```

## General Options:
### `--help`
### `-h`, `--help`
Bring up the standard help output. This will give examples of options the user can change to customize a run.

### `--version`
### `-v`, `--version`
Print the version information for the build

## Required Arguments:
Expand All @@ -24,16 +24,16 @@ A standard run of Lancet will provide a tumor bam file, a normal bam file, the r
```

### `-t`, `--tumor`
Provide the path to the tumor bam file. Index for this file should also be in the same directory
Provide the path to the tumor BAM/CRAM file(s). Index for this file should also be in the same directory

### `-n`, `--normal`
Provide the path to the normal bam file. Index for this file should also be in the same directory
Provide the path to normal BAM/CRAM file(s). Index for this file should also be in the same directory

### `-r`, `--reference`
Provide the path to the reference fasta file. Index for this file should also be in the same directory

### `-o`, `--out-prefix`
Prefix to use for output VCF (will be bgzipped and indexed)
### `-o`, `--out-vcfgz`
Output path to the compressed VCF file

## Optional Arguments:
These arguments allow for more fine-tuned control of the tool. If not provided, default values will be assigned
Expand All @@ -43,11 +43,11 @@ This tag allows you to define the output path for dumping serialized graphs from
### Regions
These options will allow you to play around with what the tool looks at.

### `--region`
Allows the user to define what region the tool should run on. Should be of format chr:start_pos-end_pos.
For example, this will indicate that the tool will run on chromosome 2 between positions 33091000 and 33092000:
### `-R`, `--region`
Allows the user to define what region(s) the tool should run on. Should be of format chr:start_pos-end_pos and multiple regions will be separated by a comma.
For example, this will indicate that the tool will run on chromosome 2 between positions 33091000 and 33092000 as well as chromosome 18 between positions 5729000 and 5759000:
```shell
... --region 2:33091000-33092000 ...
... --region 2:33091000-33092000,18:5729000-5759000 ...
```
If no region(s) specified, the tool will default to run on the whole genome provided

Expand All @@ -62,29 +62,87 @@ is the chromosome, the second column is the start position, and the third column
If no region(s) specified, the tool will default to run on the whole genome provided

### `-P`, `--padding`
Padding to be applied to all input regions. By default, there will be a padding of 250 bp.
Padding to be applied to all input regions. By default, there will be a padding of 500 bp.

### `-w`, `--window-size`
This tag allows you to define the window size used for each microassembly task. By default, the window will be 600 bp.
This tag allows you to define the window size used for each microassembly task. By default, the window will be 500 bp.

### `-T`, `--num-threads`
Allows the user to specify the number of cores to be used for the tool.

### `--pct-overlap`
Allows the user to define how much overlap there should be between windows. If not specified, the tool will default to 50% overlap
### `-p`, `--pct-overlap`
Allows the user to define how much overlap there should be between windows. If not specified, the tool will default to 20% overlap

### Parameters
These options allow you to define certain parameters for how the tool performs its variant calling

### `-T`, `--num-threads`
This allows you to define how many threads are used by the tool. If not specified, the tool will default to running with 1 thread.
This allows you to define how many async worker threads are used by the tool. If not specified, the tool will default to running with 2 threads.

### `-k`, `--min-kmer`
This allows you to define the minimum length kmers should be for graph nodes. If no length specified, the min kmer length defaults to 31 bp.

### `-K`, `--max-kmer`
This allows you to define the maximum length kmers should be for graph nodes. If no length specified, the max kmer length defaults to 133 bp.

### `-s`, `--kmer-step
This allows you to define the kmer step sizes to try for graph nodes. If not specified, the kmer step size defaults to 4

### `--min-anchor-cov`
Minimum coverage for anchor nodes (source & sink). Default is 5

### `--min-node-cov`
Minimum coverage for all nodes in the graph. Default is 2

### `--max-sample-cov`
Maximum per sample coverage before downsampling. Default is 500

### `--min-alt-qual`
Minimum phred quality supporting ALT allele. Default is 20

### Filters
These options let you apply different filters to apply to the variant caller

### `--min-nml-cov`
Minimum normal coverage. Default is 20

### `--min-tmr-cov`
Minimum tumor coverage. Default is 20

### `--min-odds-ratio`
Minimum VAF odds in tumor vs normal. Default is 10

### `--min-snv-fisher`
Minimum phred scaled fisher score for SNVs

### `--min-indel-fisher`
Minimum phred scaled fisher score for InDels

### `--min-str-fisher`
Minimum phred scaled fisher score for STRs

### Flags
Use these flags to toggle certain portions of the code to apply different features. By default, these features are off, but by using tags (with no argument following), you can toggle the feature on.

### `--verbose`
Turn on verbose logging for more detailed messages

### `--extract-pairs`
Extract all useful read pairs

### `--no-active-region`
Force assemble all windows

### `--no-contig-check`
Skip contig check with reference








### `-k`, `--min-kmer-length`
This allows you to define the minimum length kmers should be for graph nodes. If no length specified, the min kmer length defaults to 11 bp.

### `-K`, `--max-kmer-length`
This allows you to define the maximum length kmers should be for graph nodes. If no length specified, the max kmer length defaults to 101 bp.

***old***
### `--min-trim-qual`
This allows you to define the minimum base quality for trimming 5' and 3' read bases. If this option is not used, the minimum base quality will be defaulted to 10.

Expand Down

0 comments on commit 3ec2291

Please sign in to comment.