kkonganti@11: # NextFlow DSL2 Module
kkonganti@11: 
kkonganti@11: ```bash
kkonganti@11: KMA_ALIGN
kkonganti@11: ```
kkonganti@11: 
kkonganti@11: ## Description
kkonganti@11: 
kkonganti@11: Run `kma` alinger on input FASTQ files with a pre-formatted `kma` index.
kkonganti@11: 
kkonganti@11: \
kkonganti@11:  
kkonganti@11: 
kkonganti@11: ### `input:`
kkonganti@11: 
kkonganti@11: ___
kkonganti@11: 
kkonganti@11: Type: `tuple`
kkonganti@11: 
kkonganti@11: Takes in the following tuple of metadata (`meta`) and a list of reads of type `path` (`reads`) and a correspondonding `kma` pre-formatted index folder per sample (`id:`).
kkonganti@11: 
kkonganti@11: Ex:
kkonganti@11: 
kkonganti@11: ```groovy
kkonganti@11: [ 
kkonganti@11:     [ 
kkonganti@11:         id: 'FAL00870',
kkonganti@11:         strandedness: 'unstranded',
kkonganti@11:         single_end: false
kkonganti@11:     ],
kkonganti@11:     [
kkonganti@11:         '/hpc/scratch/test/f1.R1.fq.gz',
kkonganti@11:         '/hpc/scratch/test/f1.R2.fq.gz'
kkonganti@11:     ],
kkonganti@11:     '/path/to/kma/index/folder'
kkonganti@11: ]
kkonganti@11: ```
kkonganti@11: 
kkonganti@11: \
kkonganti@11:  
kkonganti@11: 
kkonganti@11: #### `meta`
kkonganti@11: 
kkonganti@11: Type: Groovy Map
kkonganti@11: 
kkonganti@11: A Groovy Map containing the metadata about the FASTQ file.
kkonganti@11: 
kkonganti@11: Ex:
kkonganti@11: 
kkonganti@11: ```groovy
kkonganti@11: [ 
kkonganti@11:     id: 'FAL00870',
kkonganti@11:     strandedness: 'unstranded',
kkonganti@11:     single_end: true
kkonganti@11: ]
kkonganti@11: ```
kkonganti@11: 
kkonganti@11: \
kkonganti@11:  
kkonganti@11: 
kkonganti@11: #### `reads`
kkonganti@11: 
kkonganti@11: Type: `path`
kkonganti@11: 
kkonganti@11: NextFlow input type of `path` pointing to paired-end FASTQ files on which `bbmerge.sh` should be run.
kkonganti@11: 
kkonganti@11: \
kkonganti@11:  
kkonganti@11: 
kkonganti@11: #### `index`
kkonganti@11: 
kkonganti@11: Type: `path`
kkonganti@11: 
kkonganti@11: NextFlow input type of `path` pointing to folder containing `kma` index files.
kkonganti@11: 
kkonganti@11: \
kkonganti@11:  
kkonganti@11: 
kkonganti@11: #### `args`
kkonganti@11: 
kkonganti@11: Type: Groovy String
kkonganti@11: 
kkonganti@11: 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@11: 
kkonganti@11: Ex:
kkonganti@11: 
kkonganti@11: ```groovy
kkonganti@11: withName: 'KMA_ALIGN' {
kkonganti@11:     ext.args = '-mint2'
kkonganti@11: }
kkonganti@11: ```
kkonganti@11: 
kkonganti@11: ### `output:`
kkonganti@11: 
kkonganti@11: ___
kkonganti@11: 
kkonganti@11: Type: `tuple`
kkonganti@11: 
kkonganti@11: Outputs a tuple of metadata (`meta` from `input:`) and `kma` result files.
kkonganti@11: 
kkonganti@11: \
kkonganti@11:  
kkonganti@11: 
kkonganti@11: #### `res`
kkonganti@11: 
kkonganti@11: Type: `path`
kkonganti@11: 
kkonganti@11: NextFlow output type of `path` pointing to the `.res` file from `kma` per sample (`id:`).
kkonganti@11: 
kkonganti@11: \
kkonganti@11:  
kkonganti@11: 
kkonganti@11: #### `mapstat`
kkonganti@11: 
kkonganti@11: Type: `path`
kkonganti@11: 
kkonganti@11: NextFlow output type of `path` pointing to the `.map` file from `kma` per sample (`id:`). Optional: `true`
kkonganti@11: 
kkonganti@11: \
kkonganti@11:  
kkonganti@11: 
kkonganti@11: #### `hits`
kkonganti@11: 
kkonganti@11: Type: `path`
kkonganti@11: 
kkonganti@11: NextFlow output type of `path` pointing to a `*_template_hits.txt` file containing only hit IDs. Optional: `true`
kkonganti@11: 
kkonganti@11: \
kkonganti@11:  
kkonganti@11: 
kkonganti@11: #### `versions`
kkonganti@11: 
kkonganti@11: Type: `path`
kkonganti@11: 
kkonganti@11: NextFlow output type of `path` pointing to the `.yml` file storing software versions for this process.