-
Notifications
You must be signed in to change notification settings - Fork 12
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add info about diffab #67
base: dev
Are you sure you want to change the base?
Changes from 9 commits
85eef24
086c13b
692930a
94217ef
3ee9733
fa03fe8
c982c28
b4f2d3c
4a2216c
20b7be4
44875d5
3093ce3
1739ba4
c6a8479
b8acaff
957a7ac
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -31,23 +31,73 @@ Example command (change `cfc` for `binac` on binac cluster): | |
|
||
```bash | ||
#!/usr/bin/bash | ||
nextflow run qbicsoftware/rnadeseq -r 1.3.2 -profile docker \ | ||
--rawcounts 'merged_gene_counts.txt' \ | ||
--metadata 'QXXXX_sample_preparations.tsv' \ | ||
nextflow run qbic-pipelines/rnadeseq -r 2.4.1 -profile cfc \ | ||
--gene_counts 'merged_gene_counts.txt' \ | ||
--input 'QXXXX_sample_preparations.tsv' \ | ||
--model 'linear_model.txt' \ | ||
--contrast_matrix 'contrasts.tsv' \ | ||
--project_summary 'QXXXX_summary.tsv' \ | ||
--multiqc 'MultiQC.zip' \ | ||
--quote 'QXXXX_signed_offer.pdf' \ | ||
--versions 'software_versions.csv' \ | ||
--report_options 'report_options.yml' \ | ||
--species Hsapiens | ||
--software_versions 'software_versions.csv' \ | ||
--outdir 'results' | ||
``` | ||
|
||
### Docker containers | ||
|
||
After the release of rnadeseq 2.1, the docker containers were moved from Docker Hub to the GitHub Container Registry (ghcr) as Docker announced a change of free subscriptions. For all rnadeseq versions >2.1, this is reflected in the pipeline, so you don't need to do anything. | ||
|
||
For version 2.1 or later, should you have trouble executing the pipeline because the container was removed from Docker Hub (this could for example lead to an error like "docker: Error response from daemon: manifest for qbicpipelines/rnadeseq:2.1 not found: manifest unknown: manifest unknown."), please save the following code to a `container.config` (change 2.1 to the version you want to use): | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. you mean "2.1 or previous versions"? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Sorry Sabrina, I don't understand you question. If you refer to the sentence |
||
|
||
```bash | ||
process { | ||
withName: REPORT { | ||
container = 'ghcr.io/qbic-pipelines/rnadeseq:2.1' | ||
} | ||
} | ||
``` | ||
|
||
If you want to run a version <2.1, the container.config has to look like this: | ||
WackerO marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
```bash | ||
process.container = 'ghcr.io/qbic-pipelines/rnadeseq:1.1.0' | ||
``` | ||
|
||
The container link has to be adjusted to the version you want to run. You should just have to change the version number, but you can double-check on https://github.com/qbic-pipelines/rnadeseq/pkgs/container/rnadeseq if you are not sure if the link is correct. | ||
|
||
Then, call this container.config when running the pipeline, like so: | ||
WackerO marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
```bash | ||
qbic-pipelines/rnadeseq -r 2.4.1 -profile cfc \ | ||
--many-many "params" \ | ||
-c path/to/container.config | ||
``` | ||
|
||
### Known issues | ||
|
||
- No known issues | ||
|
||
## Switch to nf-core/differentialabundance | ||
|
||
In the future, we want to switch to the [nf-core/differentialabundance](https://github.com/nf-core/differentialabundance) pipeline. It was developed as a pipeline that is capable of a differential abundance analysis of different types of input data, including proteomics experiments if the upstream analysis was done with MaxQuant. | ||
|
||
### Quick start | ||
|
||
Example command on cfc: | ||
WackerO marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
```bash | ||
#!/usr/bin/bash | ||
nextflow run nf-core/differentialabundance -r 1.5.0 -profile cfc,rnaseq \ | ||
-params-file /sfs/9/ws/shared_files/qbic_differentialabundance_rnaseq.yml \ | ||
--matrix 'salmon.merged.gene_counts_length_scaled.tsv' \ | ||
--input 'sample_preparations.tsv' \ | ||
--contrast_matrix 'contrasts.tsv' \ | ||
--report_contributors 'Jane Doe\nDirector of Institute of Microbiology\nUniversity of Smallville;John Smith\nPhD student\nInstitute of Microbiology\nUniversity of Smallville' | ||
``` | ||
|
||
The file `/sfs/9/ws/shared_files/qbic_differentialabundance_rnaseq.yml` contains several settings that will probably be necessary for any such analysis at QBiC and is saved in a folder on cfc which is accessible by every qbic-staff member. This includes a custom CSS and PNG file which set the style of the HTML report that is generated at the end of pipeline runs (i.e. this changes the color of highlighted text to QBiC blue and adds a combination of the QBiC rectangle and the pipeline logo to the very top of the report). If you want to run such an analysis on another machine, simply copy the relevant files from the shared_files folder over, then modify the paths in the YML file accordingly. | ||
WackerO marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
For more information about how to run the pipeline, have a look at the [usage docs](https://nf-co.re/differentialabundance/docs/usage/). | ||
|
||
## Reporting | ||
|
||
The reporting is taken care of as part of the [qbic-pipelines/rnadeseq](https://github.com/qbic-pipelines/rnadeseq) pipeline. Check the previous section. | ||
The reporting is taken care of as part of the [qbic-pipelines/rnadeseq](https://github.com/qbic-pipelines/rnadeseq) and [nf-core/differentialabundance](https://github.com/nf-core/differentialabundance) pipelines. Check the previous sections. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Where is this part, I can't find the corresponding markdown part?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I forgot to add that file to git...I just pushed it