Skip to content
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

Release 1.0.0 #3

Merged
merged 8 commits into from
Mar 22, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions .nf-core.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,11 @@ lint:
- .github/workflows/awsfulltest.yml
files_unchanged:
- CODE_OF_CONDUCT.md
pipeline_name_conventions: False
actions_awsfulltest: False
nextflow_config:
- manifest.name
repository_type: pipeline
- custom_config
- manifest.name
- manifest.homePage

repository_type: pipeline
10 changes: 3 additions & 7 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,10 @@
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## v1.0.0 - [date]
## v1.0.0 - [2024-03-22]

Initial release of `phac-nml/viralassembly`, created from combining the [nf-core](https://nf-co.re/) template with the artic steps.

### `Added`

### `Fixed`

### `Dependencies`

### `Deprecated`
- All initial pipeline features and logic
- All initial docs and images
294 changes: 41 additions & 253 deletions README.md

Large diffs are not rendered by default.

9 changes: 8 additions & 1 deletion assets/multiqc_config_overall.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -20,10 +20,15 @@ run_modules:
- samtools
- qualimap
- bcftools
- nanostat
- snpeff

# Order for reports
module_order:
- nanostat:
name: Nanostat filtered fastq statistics
path_filters:
- "*.nanostat.txt"
- samtools
- qualimap
- bcftools
Expand Down Expand Up @@ -178,7 +183,9 @@ custom_data:
]

# Extensions to clean from names
# extra_fn_clean_exts:
extra_fn_clean_exts:
- '.nanostat'
- '.ann'

# Search Pathes
sp:
Expand Down
8 changes: 7 additions & 1 deletion assets/multiqc_config_sample.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -16,10 +16,15 @@ skip_generalstats: true
# Modules/tools supported that we only want to grab
run_modules:
- custom_content
- nanostat
- qualimap

# Order for reports
module_order:
- nanostat:
name: Nanostat filtered fastq statistics
path_filters:
- "*.nanostat.txt"
- qualimap

report_section_order:
Expand Down Expand Up @@ -250,7 +255,8 @@ custom_data:
scale: "Purples"

# Extensions to clean from names
# extra_fn_clean_exts:
extra_fn_clean_exts:
- '.nanostat'

# Search Pathes
sp:
Expand Down
2 changes: 1 addition & 1 deletion assets/rmarkdown-reports/reportDashboard.Rmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "NML Sequencing Run Report"
title: "Sequencing Run Report"
output:
flexdashboard::flex_dashboard:
orientation: rows
Expand Down
2 changes: 0 additions & 2 deletions conf/nml.config
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,6 @@
env {
OPENBLAS_NUM_THREADS = 1
}

params {
// Config params
config_profile_name = "nml"
Expand All @@ -14,7 +13,6 @@ params {
max_retries = 3
max_jobs = 100
}

process {
// Base process
executor = "slurm"
Expand Down
2 changes: 1 addition & 1 deletion conf/test.config
Original file line number Diff line number Diff line change
Expand Up @@ -24,5 +24,5 @@ params {

// Args
variant_caller = "clair3"
reference_no_scheme = "$projectDir/.github/test-data/nanopore/MN908947.3.reference.fasta"
reference = "$projectDir/.github/test-data/nanopore/MN908947.3.reference.fasta"
}
2 changes: 2 additions & 0 deletions conf/test_full.config
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,6 @@ params {
variant_caller = "medaka"
medaka_model = "r1041_e82_400bps_sup_v4.3.0"
metadata = "$projectDir/.github/test-data/nanopore/metadata.tsv"
scheme = 'nCoV-2019'
scheme_version = 'V5.3.2'
}
6 changes: 4 additions & 2 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,9 @@

The phac-nml/viralassembly documentation is split into the following pages:

- [Usage](usage.md)
- [Usage](./usage.md)
- An overview of how the pipeline works, how to run it and a description of all of the different command-line flags.
- [Output](output.md)
- [Example Commands](./example_commands.md)
- Different command examples
- [Output](./output.md)
- An overview of the different results produced by the pipeline and how to interpret them.
94 changes: 94 additions & 0 deletions docs/example_commands.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
# phac-nml/viralassembly: Example Commands
A variety of example commands using different parameter options to display how to use each

## Amplicon

### Clair3
Clair3 with a local model, local scheme, fastq directory, conda, and the custom report output

```bash
nextflow run phac-nml/viralassembly \
-profile conda \
--fastq_pass FASTQ_PASS/ \
--variant_caller 'clair3' \
--clair3_model ./r1041_e82_400bps_sup_v420 \
--local_scheme ./primer_schemes \
--scheme 'hCMV' \
--scheme_version 'V1' \
--custom_report \
--outdir ./results
```

### Medaka
Minimal input medaka with conda, an input csv file for data, and the nCoV-2019 scheme

```bash
nextflow run phac-nml/viralassembly \
-profile conda \
--input INPUT.csv \
--variant_caller 'medaka' \
--scheme 'nCoV-2019' \
--scheme_version 'V5.3.2' \
--outdir ./results
```

### Nanopolish
Nanopolish run using singularity and the base artic command line tool (instead of the default nextflow implementation)

```bash
nextflow run phac-nml/viralassembly \
-profile singularity \
--input INPUT.csv \
--fast5_pass FAST5_PASS/ \
--sequencing_summart SEQ_SUM.txt \
--variant_caller 'nanopolish' \
--scheme 'nCoV-2019' \
--scheme_version 'V5.3.2' \
--use_artic_tool \
--outdir ./results
```

--------------------------

## Non-Amplicon

### Clair3
Minimal clair3 with docker using a fastq input directory along wth a gff3 reference file for SnpEff

```bash
nextflow run phac-nml/viralassembly \
-profile docker \
--fastq_pass FASTQ_PASS/ \
--variant_caller 'clair3' \
--reference ./REFERENCE.fa \
--gff ./REFERENCE.gff
```

### Medaka
Medaka with conda skipping QC and SnpEff

```bash
nextflow run phac-nml/viralassembly \
-profile conda \
--input INPUT.csv \
--variant_caller 'medaka' \
--reference ./REFERENCE.fa \
--skip_qc \
--skip_snpeff
```

### Nanopolish
Nanopolish running with conda, filtering the read lengths to be shorter, and creating a custom report

```bash
nextflow run phac-nml/viralassembly \
-profile conda \
--input INPUT.csv \
--fast5_pass FAST5_PASS/ \
--sequencing_summart SEQ_SUM.txt \
--variant_caller 'nanopolish' \
--reference ./REFERENCE.fa \
--min_length 100 \
--max_length 600 \
--outdir ./results
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
>Custom.1
ATTAAAGGTTTATACCTTCCCAGGTAACAAACCAACCAACTTTCGATCTCTTGTAGATCT
GTTCTCTAAACGAACTTTAAAATCTGTGTGGCTGTCACTCGGCTGCATGCTTAGTGCACT
CACGCAGTATAATTAATAACTAATTACTGTCGTTGACAGGACACGAGTAACTCGTCTATC
TTCTGCAGGCTGCTTACGGTTTCGTCCGTGTTGCAGCCGATCATCAGCACATCTAGGTTT
CGTCCGGGTGTGACCGAAAGGTAAGATGGAGAGCCTTGTCCCTGGTTTCAACGAGAAAAC
CACGCAGTATAATTAATAACTAATTACTGTCGTTGACAGGACACGAGTAACTCGTCTATC
TTCTGCAGGCTGCTTACGGTTTCGTCCGTGTTGCAGCCGATCATCAGCACATCTAGGTTT
ATTAAAGGTTTATACCTTCCCAGGTAACAAACCAACCAACTTTCGATCTCTTGTAGATCT
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
Custom.1 10 34 custom_1_LEFT 1 +
Custom.1 300 320 custom_1_RIGHT 1 -
Custom.1 220 246 custom_2_LEFT 2 +
Custom.1 440 460 custom_2_RIGHT 2 -
11 changes: 11 additions & 0 deletions docs/example_files/inputs/input.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
sample,reads
negative-ctrl-1,barcode11
run-ntc-1,barcode94
pos-ctrl-1,barcode95
cov-1,barcode5
cov-2,barcode01
cov-3,barcode12
cov-4,barcode19
cov-5,barcode40
cov-6,barcode61
cov-7,barcode75
11 changes: 11 additions & 0 deletions docs/example_files/inputs/metadata.tsv
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
sample barcode run other
negative-ctrl-1 11 example-run additional_info
run-ntc-1 94 example-run additional_info
pos-ctrl-1 95 example-run additional_info
cov-1 5 example-run additional_info
cov-2 1 example-run additional_info
cov-3 12 example-run additional_info
cov-4 19 example-run additional_info
cov-5 40 example-run additional_info
cov-6 61 example-run additional_info
cov-7 75 example-run additional_info
Binary file added docs/images/amplicons_custom.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/bcftools_mqc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/completeness_mqc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/nanostat_mqc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/qc_mqc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/qualimap_mqc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/run_summary_custom.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/sample_custom.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/sample_mqc_mqc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/samtools_mqc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/snpeff_mqc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/variation_mqc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading