kkonganti@105: # NextFlow DSL2 Module
kkonganti@105: 
kkonganti@105: ```bash
kkonganti@105: CENTRIFUGE_CLASSIFY
kkonganti@105: ```
kkonganti@105: 
kkonganti@105: ## Description
kkonganti@105: 
kkonganti@105: Run `centrifuge` tool on reads in FASTQ format. Produces 3 output files in ASCII text format and optional output files.
kkonganti@105: 
kkonganti@105: \
kkonganti@105:  
kkonganti@105: 
kkonganti@105: ### `input:`
kkonganti@105: 
kkonganti@105: ___
kkonganti@105: 
kkonganti@105: Type: `tuple`
kkonganti@105: 
kkonganti@105: Takes in the following tuple of metadata (`meta`) and a list of reads of type `path` (`reads`) per sample (`id:`).
kkonganti@105: 
kkonganti@105: Ex:
kkonganti@105: 
kkonganti@105: ```groovy
kkonganti@105: [ 
kkonganti@105:     [ id: 'FAL00870',
kkonganti@105:        strandedness: 'unstranded',
kkonganti@105:        single_end: true,
kkonganti@105:        centrifuge_x: '/hpc/db/centrifuge/2022-04-12/ab'
kkonganti@105:     ],
kkonganti@105:     '/hpc/scratch/test/FAL000870/f1.merged.fq.gz'
kkonganti@105: ]
kkonganti@105: ```
kkonganti@105: 
kkonganti@105: \
kkonganti@105:  
kkonganti@105: 
kkonganti@105: #### `meta`
kkonganti@105: 
kkonganti@105: Type: Groovy Map
kkonganti@105: 
kkonganti@105: A Groovy Map containing the metadata about the FASTQ file.
kkonganti@105: 
kkonganti@105: Ex:
kkonganti@105: 
kkonganti@105: ```groovy
kkonganti@105: [ 
kkonganti@105:     id: 'FAL00870',
kkonganti@105:     strandedness: 'unstranded',
kkonganti@105:     single_end: true,
kkonganti@105:     centrifuge_x: '/hpc/db/centrifuge/2022-04-12/ab'
kkonganti@105: ]
kkonganti@105: ```
kkonganti@105: 
kkonganti@105: \
kkonganti@105:  
kkonganti@105: 
kkonganti@105: #### `reads`
kkonganti@105: 
kkonganti@105: Type: `path`
kkonganti@105: 
kkonganti@105: NextFlow input type of `path` pointing to FASTQ files on which `centrifuge` classification should be run.
kkonganti@105: 
kkonganti@105: \
kkonganti@105:  
kkonganti@105: 
kkonganti@105: #### `args`
kkonganti@105: 
kkonganti@105: Type: Groovy String
kkonganti@105: 
kkonganti@105: String of optional command-line arguments to be passed to the tool. This can be mentioned in `process` scope within `withName:process_name` block using `ext.args` option within your `nextflow.config` file.
kkonganti@105: 
kkonganti@105: Ex:
kkonganti@105: 
kkonganti@105: ```groovy
kkonganti@105: withName: 'CENTRIFUGE_CLASSIFY' {
kkonganti@105:     ext.args = '--met 3'
kkonganti@105: }
kkonganti@105: ```
kkonganti@105: 
kkonganti@105: \
kkonganti@105:  
kkonganti@105: 
kkonganti@105: ### `output:`
kkonganti@105: 
kkonganti@105: ___
kkonganti@105: 
kkonganti@105: Type: `tuple`
kkonganti@105: 
kkonganti@105: Outputs a tuple of metadata (`meta` from `input:`) and list of `centrifuge` result files.
kkonganti@105: 
kkonganti@105: \
kkonganti@105:  
kkonganti@105: 
kkonganti@105: #### `report`
kkonganti@105: 
kkonganti@105: Type: `path`
kkonganti@105: 
kkonganti@105: NextFlow output type of `path` pointing to the `centrifuge` report table file (`.report.txt`) per sample (`id:`).
kkonganti@105: 
kkonganti@105: \
kkonganti@105:  
kkonganti@105: 
kkonganti@105: #### `output`
kkonganti@105: 
kkonganti@105: Type: `path`
kkonganti@105: 
kkonganti@105: NextFlow output type of `path` pointing to the `centrifuge` output table file (`.output.txt`) per sample (`id:`).
kkonganti@105: 
kkonganti@105: \
kkonganti@105:  
kkonganti@105: 
kkonganti@105: #### `kreport`
kkonganti@105: 
kkonganti@105: Type: `path`
kkonganti@105: 
kkonganti@105: NextFlow output type of `path` pointing to the `centrifuge` **Kraken** style report table file (`.kreport.txt`) per sample (`id:`).
kkonganti@105: 
kkonganti@105: \
kkonganti@105:  
kkonganti@105: 
kkonganti@105: #### `sam`
kkonganti@105: 
kkonganti@105: Type: `path`
kkonganti@105: \
kkonganti@105: Optional: `true`
kkonganti@105: 
kkonganti@105: NextFlow output type of `path` pointing to the `centrifuge` alignment results in SAM (`.sam`) format per sample (`id:`). Obtaining this output will depend on the mention of `--centrifuge_out_fmt_sam` command-line option when the NextFlow pipeline is called.
kkonganti@105: 
kkonganti@105: \
kkonganti@105:  
kkonganti@105: 
kkonganti@105: #### `fastq_mapped`
kkonganti@105: 
kkonganti@105: Type: `path`
kkonganti@105: \
kkonganti@105: Optional: `true`
kkonganti@105: 
kkonganti@105: NextFlow output type of `path` pointing to the `centrifuge` alignment results in FASTQ (`.fastq.gz`) format per sample (`id:`). Obtaining this output will depend on the mention of `--centrifuge_save_aligned` command-line option when the NextFlow pipeline is called.
kkonganti@105: 
kkonganti@105: \
kkonganti@105:  
kkonganti@105: 
kkonganti@105: #### `fastq_unmapped`
kkonganti@105: 
kkonganti@105: Type: `path`
kkonganti@105: \
kkonganti@105: Optional: `true`
kkonganti@105: 
kkonganti@105: NextFlow output type of `path` pointing to the `centrifuge` FASTQ (`.fastq.gz`) files of unaligned reads per sample (`id:`). Obtaining this output will depend on the mention of `--centrifuge_save_unaligned` command-line option when the NextFlow pipeline is called.
kkonganti@105: 
kkonganti@105: \
kkonganti@105:  
kkonganti@105: 
kkonganti@105: #### `versions`
kkonganti@105: 
kkonganti@105: Type: `path`
kkonganti@105: 
kkonganti@105: NextFlow output type of `path` pointing to the `.yml` file storing software versions for this process.