Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
nh13 committed Nov 15, 2022
1 parent 630bd76 commit d5d9495
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 1 deletion.
13 changes: 13 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ This repository is home to the `sgdemux` tool for demultiplexing sequencing data
* [Usage](#usage)
* [Inputs](#inputs)
* [FASTQ Files](#fastq-files)
* [Auto-detecting FASTQS from a Path Prefix](#auto-detecting-fastqs-from-a-path-prefix)
* [Read Structures](#read-structures)
* [Sample Sheet](#sample-sheet)
* [Specifying Demultiplexing Command Line Options](#specifying-demultiplexing-command-line-options)
Expand Down Expand Up @@ -118,6 +119,18 @@ for read in R1 R2 I1 I2; do cat L*/${read}.fastq.gz > ./${read}.fastq.gz; done

FASTQ files _must_ be BGZF compressed.

All reads containing sample barcodes/indexes _must_ be of the same length.

###### Auto-detecting FASTQS from a Path Prefix

Alternatively, the FASTQS can be auto-detected when a path prefix is given to `--fastqs <dir>/<prefix>`.
The FASTQs must be named `<dir>/<prefix>_L00<lane>_<kind><kind-number>_001.fastq.gz`, where `kind` is
one of R (read/template), I (index/sample barcode), or U (umi/molecular barcode).

If the read structure is given on the command line or Sample sheet, the segments are assumed to to
apply to I1 R1 R2 I2 reads in that order. Otherwise, the read structure will be `B+ T+ T+ B+`
(all index bases are used for the sample barcode, all read bases are assumed to be template).

##### Read Structures

Read Structures are short strings that describe the origin and/or purpose of bases within sequencing reads. They are made up of a sequence of `<number><operator>` pairs. Four kinds of operators are recognized:
Expand Down
2 changes: 1 addition & 1 deletion src/lib/opts.rs
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ For support please contact: care@singulargenomics.com
#[derive(Parser, Debug, Clone)]
#[clap(name = TOOL_NAME, version = built_info::VERSION.as_str(), about=SHORT_USAGE, long_about=LONG_USAGE, term_width=0)]
pub struct Opts {
/// Path to the input FASTQs.
/// Path to the input FASTQs or path prefix.
#[clap(long, short = 'f', display_order = 1, required = true, multiple_values = true)]
pub fastqs: Vec<PathBuf>,

Expand Down

0 comments on commit d5d9495

Please sign in to comment.