Skip to content

Commit ef1378d

Browse files
committed
update README.md
1 parent df7062e commit ef1378d

1 file changed

Lines changed: 49 additions & 0 deletions

File tree

payload-gen-qc/README.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Nextflow Package `payload-gen-qc`
2+
3+
A simple wrapper written in `nextflow` for the payload generation tool to generate ARGO Song payloads containing QC metrics files.
4+
5+
## Package development
6+
7+
The initial version of this package was created by the WorkFlow Package Manager CLI tool, please refer to
8+
the [documentation](https://wfpm.readthedocs.io) for details on the development procedure including
9+
versioning, updating, CI testing and releasing.
10+
11+
12+
## Inputs
13+
### Required
14+
- `files_to_upload`: All files to upload
15+
- `metadata_analysis`: JSON file contains donor/sample/specimen/experiment/read_groups/files metadata for input data
16+
- `wf_name`: Workflow name
17+
- `wf_version`: Workflow version
18+
19+
### Optional
20+
- `genome_annotation`: Genome annotation version
21+
- `genome_build`: Genome build version
22+
- `cpus`: Set cpu number for running the tool
23+
- `mem`: Set memory(G) for running the tool
24+
- `publish_dir`: Specify directory for getting output files
25+
26+
## Outputs
27+
- `payload`: Payload contains metadata
28+
- `files_to_upload`: All files to upload with normalized name convention
29+
30+
## Usage
31+
32+
### Run the package directly
33+
34+
With inputs prepared, you should be able to run the package directly using the following command.
35+
Please replace the params file with a real one (with all required parameters and input files). Example
36+
params file(s) can be found in the `tests` folder.
37+
38+
```
39+
nextflow run icgc-argo-workflows/data-processing-utility-tools/payload-gen-qc/main.nf -r payload-gen-qc.v0.1.0 -params-file <your-params-json-file>
40+
```
41+
42+
### Import the package as a dependency
43+
44+
To import this package into another package as a dependency, please follow these steps at the
45+
importing package side:
46+
47+
1. add this package's URI `github.com/icgc-argo-workflows/data-processing-utility-tools/payload-gen-qc@0.1.0` in the `dependencies` list of the `pkg.json` file
48+
2. run `wfpm install` to install the dependency
49+
3. add the `include` statement in the main Nextflow script to import the dependent package from this path: `./wfpr_modules/github.com/icgc-argo-workflows/data-processing-utility-tools/payload-gen-qc@0.1.0/main.nf`

0 commit comments

Comments
 (0)