nf-core/viralmetagenome
Detect iSNV and construct whole viral genomes from metagenomic samples
0.1.1
). The latest
stable release is
0.1.2
.
Define where the pipeline should find input data and save output data.
Path to comma-separated file containing information about the samples in the experiment.
string
^\S+\.csv$
The output directory where the results will be saved. You have to use absolute paths to storage on Cloud infrastructure.
string
Sample metadata that is included in the multiqc report
string
^\S+\.[tc]sv$
Email address for completion summary.
string
^([a-zA-Z0-9_\-\.]+)@([a-zA-Z0-9_\-\.]+)\.([a-zA-Z]{2,5})$
Options related to the trimming, low complexity and host removal steps of the reads
Skip read preprocessing and use input reads for downstream analysis
boolean
Skip read quality statistics summary tool ‘fastqc’
boolean
Save reads after the final preprocessing step
boolean
true
Save reads after every preprocessing step
boolean
With or without umi detection
boolean
With or without umi extraction
boolean
true
Specify at what level UMI deduplication should occur.
string
Specify the maximum number of mismatches between reads for them to still be considered neighbors.
integer
1
Specify the strategy for umi-deduplication directional vs cluster
string
Specify the strategy or method for umi-tools deduplication on mapping level
string
Discard R1 / R2 if required 0, meaning not to discard
integer
The used trimming tool
string
Skip read trimming
boolean
Use Fastp’s deduplicate option
boolean
Define the accuracy used for hashes while deduplicating with faspt
number
Fasta file of adapters
string
Specify true to save files that failed to pass trimming thresholds ending in *.fail.fastq.gz
boolean
Specify true to save all merged reads to the a file ending in *.merged.fastq.gz
boolean
Inputs with fewer than this reads will be filtered out of the “reads” output channel
integer
1
Skip filtering of low complexity regions in reads
boolean
true
Reference files containing adapter and/or contaminant sequences for sequence kmer matching (used by bbduk)
string
Skip the removal of host read sequences
boolean
Kraken2 database used to remove host and conamination
string
s3://ngi-igenomes/test-data/viralrecon/kraken2_human.tar.gz
Kraken2 library(s) required to remove host and contamination
string
human
Skip the fastqc step after host & contaminants were removed
boolean
Parameters used to determine the metagenomic diversity of the sample
Skip determining the metagenomic diversity of the sample
boolean
Specify the taxonomic read classifiers, choices are ‘kaiju,kraken2’
string
kraken2,kaiju
^(kaiju|kraken2|bracken)(?:,(kaiju|kraken2|bracken)){0,2}$
Save the used databases
boolean
Location of the Kraken2 database
string
https://genome-idx.s3.amazonaws.com/kraken/k2_viral_20230314.tar.gz
Save classified and unclassified reads as fastq files
boolean
Save summary overview of read classifications in a txt file
boolean
Save kraken2’s used minimizers
boolean
Location of bracken database
string
https://genome-idx.s3.amazonaws.com/kraken/k2_viral_20230314.tar.gz
Location of Kaiju database
string
https://kaiju-idx.s3.eu-central-1.amazonaws.com/2023/kaiju_db_rvdb_2023-05-26.tgz
Level of taxa rank that needs to be determined
string
Parameters relating to the used assembly methods
Skip de novo assembly of reads
boolean
The specified tools for denovo assembly, multiple options are possible
string
spades,trinity,megahit
^(trinity|spades|megahit)(?:,(trinity|spades|megahit)){0,2}$
specific SPAdes mode to run
string
File or directory with amino acid HMMs for Spades HMM-guided mode.
string
Path to yml file containing read information.
string
Regex pattern to identify contigs that have been made by the assemblers
string
Parameters relating to the refinement of denovo contigs
Skip the refinement/polishing of contigs through reference based scaffolding and read mapping
boolean
Save intermediate polishing files
boolean
Set of fasta sequences used as potential references for the contigs
string
https://rvdb.dbi.udel.edu/download/C-RVDBvCurrent.fasta.gz
Skip the preclustering of assemblies to facilitate downstream processing of assemblies
boolean
Keep the contigs that could not be classified with the taxonomic databases (kaiju_db
& kraken2_db
)
boolean
true
Specify the metagenomic classifiers to use for contig taxonomy classification: ‘kraken2,kaiju’
string
kraken2,kaiju
^(kaiju|kraken2)(,(kaiju|kraken2))?$
Taxon conflict resolution mode, must be 1 (Kaiju), 2 (Kraken), lca, or lowest.
string
Level of taxonomic simplification
string
Hard constrain for taxa to exclude from the preclustering, if multiple given make sure to enclose with ’”’ and separate with a space.
string
^[\d +]+$
Taxon ids to exclude along with all their children from the preclustering, if multiple given make sure to enclose with ’”’ and separate with a space.
string
^[\d +]+$
Taxon ids to exclude along with all their parents from the preclustering, if multiple given make sure to enclose with ’”’ and separate with a space.
string
^[\d +]+$
Taxon ids to include along with all their children from the preclustering, if multiple given make sure to enclose with ’”’ and separate with a space.
string
^[\d +]+$
Taxon ids to include along with all their parents from the preclustering, if multiple given make sure to enclose with ’”’ and separate with a space.
string
^[\d +]+$
Cluster algorithm used for contigs
string
(only with mash) Algorithm to partition the network.
string
Skip creation of the hybrid consensus, instead keep the scaffold with ambiguous bases if the depth of scaffolds is not high enough.
boolean
Identity threshold value used in clustering algorithms
number
0.6
Minimum allowed contig size
integer
500
Maximum allowed contig size
integer
10000000
Define the maximum percentage of ambiguous bases in a contig
integer
50
Skip the filtering of contigs that did not cluster together with other contigs
boolean
Define parameters for iterations to update denovo consensus using reference based improvements
Don’t realign reads to consensus sequences and redefine the consensus through (multiple) iterations
boolean
number of iterations
integer
2
mapping tool used during iterations
string
variant caller used during iterations
string
call variants during the iterations
boolean
consensus tool used for calling new consensus during iterations
string
bcftools
calculate summary statistics during iterations
boolean
true
Parameters relating to the analysis of variants associated to contigs and scaffolds
Skip the analysis of variants for the external reference or contigs
boolean
Define which mapping tool needs to be used when mapping reads to reference
string
Sequence to use as a mapping reference instead of the de novo contigs or scaffolds
string
deduplicate the reads
boolean
true
Define the variant caller to use: ‘ivar’ or ‘bcftools’
string
consensus tool used for calling new consensus in final iteration
string
UMI seperator in fastq header.
string
:
Specify the sketch size, the number of (non-redundant) min-hashes that are kept.
integer
4000
Specify the kmer size for mash to create their hashes
integer
15
Define the minimum number of mapped reads in order to continue the variant and consensus calling
integer
200
calculate summary statistics in final iteration
boolean
true
Directory containing the mutliqc headers for multiple tables like ‘clusters_summary_mqc.txt’, ‘blast_mqc.txt’, …
string
${projectDir}/assets/mqc_comment
string
Apply different quality control techniques on the generated consensus genomes
Skip the quality measurements on consensus genomes
boolean
Skip the use of checkv for quality check
boolean
Reference database used by checkv for consensus quality control
string
Skip the annotation of the consensus constructs
boolean
Database used for annotation of the cosensus constructs
string
https://viralzone.expasy.org/resources/Virosaurus/2020%5F4/virosaurus90%5Fvertebrate-20200330.fas.gz
Skip the use of QUAST for quality check
boolean
Skip the blast search of contigs to the provided reference DB
boolean
Skip creating an alignment of each the collapsed clusters and each iterative step
boolean
Specify the search algorithm to use for mmseqs. 0: auto 1: amino acid, 2: translated, 3: nucleotide, 4: translated nucleotide alignment
integer
4
Parameters used to describe centralised config profiles. These should not be edited.
Git commit id for Institutional configs.
string
master
Base directory for Institutional configs.
string
https://raw.githubusercontent.com/nf-core/configs/master
Institutional config name.
string
Institutional config description.
string
Institutional config contact information.
string
Institutional config URL link.
string
Set the top limit for requested resources for any single job.
Maximum number of CPUs that can be requested for any single job.
integer
16
Maximum amount of memory that can be requested for any single job.
string
128.GB
^\d+(\.\d+)?\.?\s*(K|M|G|T)?B$
Maximum amount of time that can be requested for any single job.
string
240.h
^(\d+\.?\s*(s|m|h|d|day)\s*)+$
Less common options for the pipeline, typically set in a config file.
Display help text.
boolean
Display version and exit.
boolean
Method used to save pipeline results to output directory.
string
Email address for completion summary, only when pipeline fails.
string
^([a-zA-Z0-9_\-\.]+)@([a-zA-Z0-9_\-\.]+)\.([a-zA-Z]{2,5})$
Send plain-text email instead of HTML.
boolean
File size limit when attaching MultiQC reports to summary emails.
string
25.MB
^\d+(\.\d+)?\.?\s*(K|M|G|T)?B$
Do not use coloured log outputs.
boolean
Incoming hook URL for messaging service
string
MultiQC report title. Printed as page header, used for filename if not otherwise specified.
string
Custom config file to supply to MultiQC.
string
Custom logo file to supply to MultiQC. File name must also be set in the MultiQC config file
string
Custom MultiQC yaml file containing HTML including a methods description.
string
Delete the output directory if the pipeline fails
boolean
Custom yaml file contian g the table column names selection and new names.
string
${projectDir}/assets/custom_table_headers.yml
Boolean whether to validate parameters against the schema at runtime
boolean
true
Show all params when using --help
boolean
Validation of parameters fails when an unrecognised parameter is found.
boolean
string
global_prefix
Validation of parameters in lenient more.
boolean
Prefix of all output files followed by [date][pipelineversion][runName]
string
Global prefix set if you don’t want metadata embedded in the prefix
string