annotate 0.5.0/modules/cat/tables/README.md @ 0:3c767f9cfd88 draft default tip

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