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