Skip to content

Commit 7a743ac

Browse files
committed
Add YAML and Table example outputs for all pipelines
1 parent f36f5bd commit 7a743ac

11 files changed

Lines changed: 31363 additions & 7 deletions

File tree

docs/examples.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,10 @@
22

33
Generated documentation for real-world Nextflow pipelines.
44

5-
| Pipeline | Description | HTML | Markdown | Table | JSON |
6-
| --------------- | -------------------------------------------- | ------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------- | ------------------------------------------------------- |
7-
| hello | Nextflow hello-world pipeline | [HTML](examples/hello/index.html) | [Markdown](examples/hello/markdown/index.md) | [Table](examples/hello/table/README.md) | [JSON](examples/hello/json/pipeline-api.json) |
8-
| rnaseq-nf | Simple RNA-seq pipeline | [HTML](examples/rnaseq-nf/index.html) | [Markdown](examples/rnaseq-nf/markdown/index.md) | [Table](examples/rnaseq-nf/table/README.md) | [JSON](examples/rnaseq-nf/json/pipeline-api.json) |
9-
| rnavar | nf-core/rnavar — RNA variant calling | [HTML](examples/rnavar/index.html) | [Markdown](examples/rnavar/markdown/index.md) | [Table](examples/rnavar/table/README.md) | [JSON](examples/rnavar/json/pipeline-api.json) |
10-
| sarek | nf-core/sarek — variant calling & annotation | [HTML](examples/sarek/index.html) | [Markdown](examples/sarek/markdown/index.md) | [Table](examples/sarek/table/README.md) | [JSON](examples/sarek/json/pipeline-api.json) |
11-
| wf-metagenomics | Oxford Nanopore metagenomics workflow | [HTML](examples/wf-metagenomics/index.html) | [Markdown](examples/wf-metagenomics/markdown/index.md) | [Table](examples/wf-metagenomics/table/README.md) | [JSON](examples/wf-metagenomics/json/pipeline-api.json) |
5+
| Pipeline | Description | HTML | Markdown | Table | JSON | YAML |
6+
| --------------- | -------------------------------------------- | ------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------- |
7+
| hello | Nextflow hello-world pipeline | [HTML](examples/hello/index.html) | [Markdown](examples/hello/markdown/index.md) | [Table](examples/hello/table/README.md) | [JSON](examples/hello/json/pipeline-api.json) | [YAML](examples/hello/yaml/pipeline-api.yaml) |
8+
| rnaseq-nf | Simple RNA-seq pipeline | [HTML](examples/rnaseq-nf/index.html) | [Markdown](examples/rnaseq-nf/markdown/index.md) | [Table](examples/rnaseq-nf/table/README.md) | [JSON](examples/rnaseq-nf/json/pipeline-api.json) | [YAML](examples/rnaseq-nf/yaml/pipeline-api.yaml) |
9+
| rnavar | nf-core/rnavar — RNA variant calling | [HTML](examples/rnavar/index.html) | [Markdown](examples/rnavar/markdown/index.md) | [Table](examples/rnavar/table/README.md) | [JSON](examples/rnavar/json/pipeline-api.json) | [YAML](examples/rnavar/yaml/pipeline-api.yaml) |
10+
| sarek | nf-core/sarek — variant calling & annotation | [HTML](examples/sarek/index.html) | [Markdown](examples/sarek/markdown/index.md) | [Table](examples/sarek/table/README.md) | [JSON](examples/sarek/json/pipeline-api.json) | [YAML](examples/sarek/yaml/pipeline-api.yaml) |
11+
| wf-metagenomics | Oxford Nanopore metagenomics workflow | [HTML](examples/wf-metagenomics/index.html) | [Markdown](examples/wf-metagenomics/markdown/index.md) | [Table](examples/wf-metagenomics/table/README.md) | [JSON](examples/wf-metagenomics/json/pipeline-api.json) | [YAML](examples/wf-metagenomics/yaml/pipeline-api.yaml) |
Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
<!-- BEGIN_NF_DOCS -->
2+
# hello
3+
4+
## Workflows
5+
6+
| Name | Description | Entry |
7+
|------|-------------|:-----:|
8+
| *(entry)* | n/a | yes |
9+
10+
## Processes
11+
12+
| Name | Description |
13+
|------|-------------|
14+
| `sayHello` | n/a |
15+
16+
### `sayHello` Outputs
17+
18+
| Name | Type | Emit | Description |
19+
|------|------|------|-------------|
20+
| `stdout` | `stdout` | n/a | n/a |
21+
22+
---
23+
24+
*This pipeline was built with [Nextflow](https://nextflow.io).
25+
Documentation generated by [nf-docs](https://github.com/ewels/nf-docs) v0.2.0 on 2026-03-03 22:40:53 UTC.*
26+
27+
<!-- END_NF_DOCS -->
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
pipeline:
2+
name: hello
3+
repository: https://github.com/nextflow-io/hello
4+
inputs: []
5+
config_params: []
6+
workflows:
7+
- name: ''
8+
docstring: ''
9+
file: main.nf
10+
line: 16
11+
end_line: 18
12+
inputs: []
13+
outputs: []
14+
calls: []
15+
is_entry: true
16+
source_url: https://github.com/nextflow-io/hello/blob/2ce0b0e2943449188092a0e25102f0dadc70cb0a/main.nf#L16-L18
17+
processes:
18+
- name: sayHello
19+
docstring: ''
20+
file: main.nf
21+
line: 3
22+
end_line: 14
23+
inputs: []
24+
outputs:
25+
- name: stdout
26+
type: stdout
27+
description: ''
28+
emit: ''
29+
directives: {}
30+
source_url: https://github.com/nextflow-io/hello/blob/2ce0b0e2943449188092a0e25102f0dadc70cb0a/main.nf#L3-L14
31+
functions: []
Lines changed: 94 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,94 @@
1+
<!-- BEGIN_NF_DOCS -->
2+
# rnaseq-nf
3+
4+
Proof of concept of a RNA-seq pipeline implemented with Nextflow
5+
6+
## Inputs
7+
8+
### Input/output options
9+
10+
| Name | Description | Type | Default | Required |
11+
|------|-------------|------|---------|:--------:|
12+
| `--outdir` | The output directory where the results will be saved. You have to use absolute paths to storage on Cloud infrastructure. | `string` | `results` | no |
13+
| `--reads` | The input read-pair files | `string` | `${projectDir}/data/ggal/ggal_gut_{1,2}.fq` | no |
14+
| `--transcriptome` | The input transcriptome file | `string` | `${projectDir}/data/ggal/ggal_1_48850000_49020000.Ggal71.500bpflank.fa` | no |
15+
| `--multiqc` | n/a | `string` | `${projectDir}/multiqc` | no |
16+
17+
## Workflows
18+
19+
| Name | Description | Entry |
20+
|------|-------------|:-----:|
21+
| *(entry)* | n/a | yes |
22+
| `RNASEQ` | n/a | no |
23+
24+
### `RNASEQ` Inputs
25+
26+
| Name | Description |
27+
|------|-------------|
28+
| `read_pairs_ch` | n/a |
29+
| `transcriptome` | n/a |
30+
31+
### `RNASEQ` Outputs
32+
33+
| Name | Description |
34+
|------|-------------|
35+
| `fastqc` | n/a |
36+
| `quant` | n/a |
37+
38+
## Processes
39+
40+
| Name | Description |
41+
|------|-------------|
42+
| `QUANT` | n/a |
43+
| `MULTIQC` | n/a |
44+
| `INDEX` | n/a |
45+
| `FASTQC` | n/a |
46+
47+
### `QUANT` Inputs
48+
49+
| Name | Type | Description |
50+
|------|------|-------------|
51+
| `val(id), path(fastq_1), path(fastq_2)` | `tuple` | n/a |
52+
53+
### `QUANT` Outputs
54+
55+
| Name | Type | Emit | Description |
56+
|------|------|------|-------------|
57+
| `quant_${id` | `path` | n/a | n/a |
58+
59+
### `MULTIQC` Inputs
60+
61+
| Name | Type | Description |
62+
|------|------|-------------|
63+
| `*` | `path` | n/a |
64+
65+
### `MULTIQC` Outputs
66+
67+
| Name | Type | Emit | Description |
68+
|------|------|------|-------------|
69+
| `multiqc_report.html` | `path` | n/a | n/a |
70+
71+
### `INDEX` Outputs
72+
73+
| Name | Type | Emit | Description |
74+
|------|------|------|-------------|
75+
| `index` | `path` | n/a | n/a |
76+
77+
### `FASTQC` Inputs
78+
79+
| Name | Type | Description |
80+
|------|------|-------------|
81+
| `val(id), path(fastq_1), path(fastq_2)` | `tuple` | n/a |
82+
83+
### `FASTQC` Outputs
84+
85+
| Name | Type | Emit | Description |
86+
|------|------|------|-------------|
87+
| `fastqc_${id` | `path` | n/a | n/a |
88+
89+
---
90+
91+
*This pipeline was built with [Nextflow](https://nextflow.io).
92+
Documentation generated by [nf-docs](https://github.com/ewels/nf-docs) v0.2.0 on 2026-03-03 22:40:53 UTC.*
93+
94+
<!-- END_NF_DOCS -->
Lines changed: 168 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,168 @@
1+
pipeline:
2+
name: rnaseq-nf
3+
description: Proof of concept of a RNA-seq pipeline implemented with Nextflow
4+
repository: https://github.com/nextflow-io/rnaseq-nf
5+
authors:
6+
- Paolo Di Tommaso
7+
readme_content: "A basic pipeline for quantification of genomic features from short read data\nimplemented\
8+
\ with Nextflow.\n\n[![nextflow](https://img.shields.io/badge/nextflow-%E2%89%A523.04.0-brightgreen.svg)](http://nextflow.io)\n\
9+
\n\n## Requirements \n\n* Unix-like operating system (Linux, macOS, etc)\n* Java 11 \n\n## Quickstart\
10+
\ \n\n1. If you don't have it already install Docker in your computer. Read more [here](https://docs.docker.com/).\n\
11+
\n2. Install Nextflow (version 23.10.0 or later):\n \n curl -s https://get.nextflow.io\
12+
\ | bash\n\n3. Launch the pipeline execution: \n\n ./nextflow run nextflow-io/rnaseq-nf -with-docker\n\
13+
\ \n4. When the execution completes open in your browser the report generated at the following\
14+
\ path:\n\n results/multiqc_report.html \n\t\nYou can see an example report at the following\
15+
\ [link](http://multiqc.info/examples/rna-seq/multiqc_report.html).\t\n\t\nNote: the very first time\
16+
\ you execute it, it will take a few minutes to download the pipeline \nfrom this GitHub repository\
17+
\ and the associated Docker images needed to execute the pipeline. \n\n## Pipeline flowchart\n\n\
18+
Here is a visual representation of the design of RNASeq-NF pipeline, generated using the [visualization\
19+
\ functionality](https://www.nextflow.io/docs/latest/tracing.html#dag-visualisation) of Nextflow.\n\
20+
\n```mermaid\n%%{init: { 'theme': 'forest' } }%%\nflowchart TD\n p0((Channel.fromFilePairs))\n\
21+
\ p1(( ))\n p2[RNASEQ:INDEX]\n p3[RNASEQ:FASTQC]\n p4[RNASEQ:QUANT]\n p5([concat])\n\
22+
\ p6([collect])\n p7(( ))\n p8[MULTIQC]\n p9(( ))\n p0 -->|read_pairs_ch| p3\n p1\
23+
\ -->|transcriptome| p2\n p2 --> p4\n p3 --> p5\n p0 -->|read_pairs_ch| p4\n p4 -->|pair_id|\
24+
\ p5\n p5 --> p6\n p6 -->|$out0| p8\n p7 -->|config| p8\n p8 --> p9\n```\n\n## Cluster\
25+
\ support\n\nRNASeq-NF execution relies on [Nextflow](http://www.nextflow.io) framework which provides\
26+
\ an \nabstraction between the pipeline functional logic and the underlying processing system.\n\n\
27+
This allows the execution of the pipeline in a single computer or in a HPC cluster without modifying\
28+
\ it.\n\nCurrently the following resource manager platforms are supported:\n\n + Univa Grid Engine\
29+
\ (UGE)\n + Platform LSF\n + SLURM\n + PBS/Torque\n\n\nBy default the pipeline is parallelized\
30+
\ by spawning multiple threads in the machine where the script is launched.\n\nTo submit the execution\
31+
\ to a UGE cluster create a file named `nextflow.config` in the directory\nwhere the pipeline is going\
32+
\ to be executed with the following content:\n\n process {\n executor='uge'\n queue='<queue\
33+
\ name>'\n }\n\nTo lean more about the avaible settings and the configuration file read the \n\
34+
Nextflow [documentation](http://www.nextflow.io/docs/latest/config.html).\n\n\n## Components \n\n\
35+
RNASeq-NF uses the following software components and tools: \n\n* [Salmon](https://combine-lab.github.io/salmon/)\n\
36+
* [FastQC](https://www.bioinformatics.babraham.ac.uk/projects/fastqc/)\n* [MultiQC](https://multiqc.info)\n\
37+
\n"
38+
inputs:
39+
- name: outdir
40+
type: string
41+
description: The output directory where the results will be saved. You have to use absolute paths to
42+
storage on Cloud infrastructure.
43+
required: false
44+
default: results
45+
format: directory-path
46+
group: Input/output options
47+
fa_icon: fas fa-folder-open
48+
- name: reads
49+
type: string
50+
description: The input read-pair files
51+
required: false
52+
default: ${projectDir}/data/ggal/ggal_gut_{1,2}.fq
53+
group: Input/output options
54+
fa_icon: fas fa-folder-open
55+
- name: transcriptome
56+
type: string
57+
description: The input transcriptome file
58+
required: false
59+
default: ${projectDir}/data/ggal/ggal_1_48850000_49020000.Ggal71.500bpflank.fa
60+
group: Input/output options
61+
fa_icon: fas fa-folder-open
62+
- name: multiqc
63+
type: string
64+
description: ''
65+
required: false
66+
default: ${projectDir}/multiqc
67+
group: Input/output options
68+
fa_icon: fas fa-folder-open
69+
config_params: []
70+
workflows:
71+
- name: ''
72+
docstring: ''
73+
file: main.nf
74+
line: 26
75+
end_line: 51
76+
inputs: []
77+
outputs: []
78+
calls: []
79+
is_entry: true
80+
source_url: https://github.com/nextflow-io/rnaseq-nf/blob/ca20a6dfd2d799b903e557dc2e736d55419c7a1a/main.nf#L26-L51
81+
- name: RNASEQ
82+
docstring: ''
83+
file: modules/rnaseq.nf
84+
line: 5
85+
end_line: 18
86+
inputs:
87+
- name: read_pairs_ch
88+
type: ''
89+
description: ''
90+
- name: transcriptome
91+
type: ''
92+
description: ''
93+
outputs:
94+
- name: fastqc
95+
type: ''
96+
description: ''
97+
- name: quant
98+
type: ''
99+
description: ''
100+
calls: []
101+
is_entry: false
102+
source_url: https://github.com/nextflow-io/rnaseq-nf/blob/ca20a6dfd2d799b903e557dc2e736d55419c7a1a/modules/rnaseq.nf#L5-L18
103+
processes:
104+
- name: QUANT
105+
docstring: ''
106+
file: modules/quant/main.nf
107+
line: 2
108+
end_line: 17
109+
inputs:
110+
- name: val(id), path(fastq_1), path(fastq_2)
111+
type: tuple
112+
description: ''
113+
qualifier: ''
114+
outputs:
115+
- name: quant_${id
116+
type: path
117+
description: ''
118+
emit: ''
119+
directives: {}
120+
source_url: https://github.com/nextflow-io/rnaseq-nf/blob/ca20a6dfd2d799b903e557dc2e736d55419c7a1a/modules/quant/main.nf#L2-L17
121+
- name: MULTIQC
122+
docstring: ''
123+
file: modules/multiqc/main.nf
124+
line: 3
125+
end_line: 20
126+
inputs:
127+
- name: '*'
128+
type: path
129+
description: ''
130+
qualifier: ''
131+
outputs:
132+
- name: multiqc_report.html
133+
type: path
134+
description: ''
135+
emit: ''
136+
directives: {}
137+
source_url: https://github.com/nextflow-io/rnaseq-nf/blob/ca20a6dfd2d799b903e557dc2e736d55419c7a1a/modules/multiqc/main.nf#L3-L20
138+
- name: INDEX
139+
docstring: ''
140+
file: modules/index/main.nf
141+
line: 2
142+
end_line: 16
143+
inputs: []
144+
outputs:
145+
- name: index
146+
type: path
147+
description: ''
148+
emit: ''
149+
directives: {}
150+
source_url: https://github.com/nextflow-io/rnaseq-nf/blob/ca20a6dfd2d799b903e557dc2e736d55419c7a1a/modules/index/main.nf#L2-L16
151+
- name: FASTQC
152+
docstring: ''
153+
file: modules/fastqc/main.nf
154+
line: 3
155+
end_line: 18
156+
inputs:
157+
- name: val(id), path(fastq_1), path(fastq_2)
158+
type: tuple
159+
description: ''
160+
qualifier: ''
161+
outputs:
162+
- name: fastqc_${id
163+
type: path
164+
description: ''
165+
emit: ''
166+
directives: {}
167+
source_url: https://github.com/nextflow-io/rnaseq-nf/blob/ca20a6dfd2d799b903e557dc2e736d55419c7a1a/modules/fastqc/main.nf#L3-L18
168+
functions: []

0 commit comments

Comments
 (0)