kkonganti@17: # NextFlow DSL2 Module
kkonganti@17: 
kkonganti@17: ```bash
kkonganti@17: TABLE_SUMMARY
kkonganti@17: ```
kkonganti@17: 
kkonganti@17: ## Description
kkonganti@17: 
kkonganti@17: Concatenates a list of tables (CSV or TAB delimited) in `.txt` or `.csv` format. The table files to be concatenated **must** have a header as the header from one of the table files will be used as the header for the concatenated result table file.
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 `val` table key (`table_sum_on`) and a list of table files of input type `path` (`tables`) to be concatenated. For this module to work, a `bin` directory with the script `create_mqc_data_table.py` should be present where the NextFlow script using this DSL2 module will be run. This `python` script will convert the aggregated table to `.yml` format to be used with `multiqc`.
kkonganti@17: 
kkonganti@17: Ex:
kkonganti@17: 
kkonganti@17: ```groovy
kkonganti@17: [ ['ectyper'], ['/data/sample1/f1_ectyper.txt', '/data/sample2/f2_ectyper.txt'] ]
kkonganti@17: ```
kkonganti@17: 
kkonganti@17: \
kkonganti@17:  
kkonganti@17: 
kkonganti@17: #### `table_sum_on`
kkonganti@17: 
kkonganti@17: Type: `val`
kkonganti@17: 
kkonganti@17: A single key defining what tables are being concatenated. For example, if all the `ectyper` results are being concatenated for all samples, then this can be `ectyper`.
kkonganti@17: 
kkonganti@17: Ex:
kkonganti@17: 
kkonganti@17: ```groovy
kkonganti@17: [ ['ectyper'], ['/data/sample1/f1_ectyper.txt', '/data/sample2/f2_ectyper.txt'] ]
kkonganti@17: ```
kkonganti@17: 
kkonganti@17: \
kkonganti@17:  
kkonganti@17: 
kkonganti@17: #### `tables`
kkonganti@17: 
kkonganti@17: Type: `path`
kkonganti@17: 
kkonganti@17: NextFlow input type of `path` pointing to a list of tables (files) to be concatenated.
kkonganti@17: 
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 table key (`table_sum_on` from `input:`) and list of concatenated table files (`tblsummed`).
kkonganti@17: 
kkonganti@17: \
kkonganti@17:  
kkonganti@17: 
kkonganti@17: #### `tblsummed`
kkonganti@17: 
kkonganti@17: Type: `path`
kkonganti@17: 
kkonganti@17: NextFlow output type of `path` pointing to the concatenated table files per table key (Ex: `ectyper`).
kkonganti@17: 
kkonganti@17: \
kkonganti@17:  
kkonganti@17: 
kkonganti@17: #### `mqc_yml`
kkonganti@17: 
kkonganti@17: Type: `path`
kkonganti@17: 
kkonganti@17: NextFlow output type of `path` pointing to the `.yml` file storing table contents in `YAML` format which can be used to inject this table as part of the `multiqc` report.
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.