annotate 0.6.1/modules/cat/tables/README.md @ 12:c5faadb3386f

"planemo upload"
author kkonganti
date Tue, 05 Sep 2023 11:57:15 -0400
parents 749faef1caa9
children
rev   line source
kkonganti@11 1 # NextFlow DSL2 Module
kkonganti@11 2
kkonganti@11 3 ```bash
kkonganti@11 4 TABLE_SUMMARY
kkonganti@11 5 ```
kkonganti@11 6
kkonganti@11 7 ## Description
kkonganti@11 8
kkonganti@11 9 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@11 10
kkonganti@11 11 \
kkonganti@11 12  
kkonganti@11 13
kkonganti@11 14 ### `input:`
kkonganti@11 15
kkonganti@11 16 ___
kkonganti@11 17
kkonganti@11 18 Type: `tuple`
kkonganti@11 19
kkonganti@11 20 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@11 21
kkonganti@11 22 Ex:
kkonganti@11 23
kkonganti@11 24 ```groovy
kkonganti@11 25 [ ['ectyper'], ['/data/sample1/f1_ectyper.txt', '/data/sample2/f2_ectyper.txt'] ]
kkonganti@11 26 ```
kkonganti@11 27
kkonganti@11 28 \
kkonganti@11 29  
kkonganti@11 30
kkonganti@11 31 #### `table_sum_on`
kkonganti@11 32
kkonganti@11 33 Type: `val`
kkonganti@11 34
kkonganti@11 35 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@11 36
kkonganti@11 37 Ex:
kkonganti@11 38
kkonganti@11 39 ```groovy
kkonganti@11 40 [ ['ectyper'], ['/data/sample1/f1_ectyper.txt', '/data/sample2/f2_ectyper.txt'] ]
kkonganti@11 41 ```
kkonganti@11 42
kkonganti@11 43 \
kkonganti@11 44  
kkonganti@11 45
kkonganti@11 46 #### `tables`
kkonganti@11 47
kkonganti@11 48 Type: `path`
kkonganti@11 49
kkonganti@11 50 NextFlow input type of `path` pointing to a list of tables (files) to be concatenated.
kkonganti@11 51
kkonganti@11 52 \
kkonganti@11 53  
kkonganti@11 54
kkonganti@11 55 ### `output:`
kkonganti@11 56
kkonganti@11 57 ___
kkonganti@11 58
kkonganti@11 59 Type: `tuple`
kkonganti@11 60
kkonganti@11 61 Outputs a tuple of table key (`table_sum_on` from `input:`) and list of concatenated table files (`tblsummed`).
kkonganti@11 62
kkonganti@11 63 \
kkonganti@11 64  
kkonganti@11 65
kkonganti@11 66 #### `tblsummed`
kkonganti@11 67
kkonganti@11 68 Type: `path`
kkonganti@11 69
kkonganti@11 70 NextFlow output type of `path` pointing to the concatenated table files per table key (Ex: `ectyper`).
kkonganti@11 71
kkonganti@11 72 \
kkonganti@11 73  
kkonganti@11 74
kkonganti@11 75 #### `mqc_yml`
kkonganti@11 76
kkonganti@11 77 Type: `path`
kkonganti@11 78
kkonganti@11 79 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@11 80
kkonganti@11 81 \
kkonganti@11 82  
kkonganti@11 83
kkonganti@11 84 #### `versions`
kkonganti@11 85
kkonganti@11 86 Type: `path`
kkonganti@11 87
kkonganti@11 88 NextFlow output type of `path` pointing to the `.yml` file storing software versions for this process.