nf-core/mag
Assembly and binning of metagenomes
3.2.0). The latest
stable release is
5.0.0
.
See the advisory entry for more information.
Define where the pipeline should find input data and save output data.
CSV samplesheet file containing information about the samples in the experiment.
string^\S+\.csv$Specifies that the input is single-end reads.
booleanAdditional input CSV samplesheet containing information about pre-computed assemblies. When set, both read pre-processing and assembly are skipped and the pipeline begins at the binning stage.
string^\S+\.csv$The output directory where the results will be saved. You have to use absolute paths to storage on Cloud infrastructure.
stringEmail address for completion summary.
string^([a-zA-Z0-9_\-\.]+)@([a-zA-Z0-9_\-\.]+)\.([a-zA-Z]{2,5})$MultiQC report title. Printed as page header, used for filename if not otherwise specified.
stringReference genome related files and options required for the workflow.
Do not load the iGenomes reference config.
booleanThe base path to the igenomes reference files
strings3://ngi-igenomes/igenomes/Parameters used to describe centralised config profiles. These should not be edited.
Git commit id for Institutional configs.
stringmasterBase directory for Institutional configs.
stringhttps://raw.githubusercontent.com/nf-core/configs/masterInstitutional config name.
stringInstitutional config description.
stringInstitutional config contact information.
stringInstitutional config URL link.
stringLess common options for the pipeline, typically set in a config file.
Display version and exit.
booleanMethod used to save pipeline results to output directory.
stringUse monochrome_logs
booleanEmail 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.
booleanFile size limit when attaching MultiQC reports to summary emails.
string25.MB^\d+(\.\d+)?\.?\s*(K|M|G|T)?B$Incoming hook URL for messaging service
stringCustom config file to supply to MultiQC.
stringCustom logo file to supply to MultiQC. File name must also be set in the MultiQC config file
stringCustom MultiQC yaml file containing HTML including a methods description.
stringBoolean whether to validate parameters against the schema at runtime
booleantrueBase URL or local path to location of pipeline test dataset files
stringhttps://raw.githubusercontent.com/nf-core/test-datasets/Use these parameters to also enable reproducible results from the individual assembly and binning tools .
Fix number of CPUs for MEGAHIT to 1. Not increased with retries.
booleanFix number of CPUs used by SPAdes. Not increased with retries.
integer-1Fix number of CPUs used by SPAdes hybrid. Not increased with retries.
integer-1RNG seed for MetaBAT2.
integer1Specify which adapter clipping tool to use.
stringSpecify to save the resulting clipped FASTQ files to —outdir.
booleanThe minimum length of reads must have to be retained for downstream analysis.
integer15Minimum phred quality value of a base to be qualified in fastp.
integer15The mean quality requirement used for per read sliding window cutting by fastp.
integer15Save reads that fail fastp filtering in a separate file. Not used downstream.
booleanThe minimum base quality for low-quality base trimming by AdapterRemoval.
integer2Turn on quality trimming by consecutive stretch of low quality bases, rather than by window.
booleanForward read adapter to be trimmed by AdapterRemoval.
stringAGATCGGAAGAGCACACGTCTGAACTCCAGTCACNNNNNNATCTCGTATGCCGTCTTCTGCTTGReverse read adapter to be trimmed by AdapterRemoval for paired end data.
stringAGATCGGAAGAGCGTCGTGTAGGGAAAGAGTGTAGATCTCGGTGGTCGCCGTATCATTName of iGenomes reference for host contamination removal.
stringFasta reference file for host contamination removal.
stringBowtie2 index directory corresponding to --host_fasta reference file for host contamination removal.
stringUse the --very-sensitive instead of the--sensitivesetting for Bowtie 2 to map reads against the host genome.
booleanSave the read IDs of removed host reads.
booleanSpecify to save input FASTQ files with host reads removed to —outdir.
booleanKeep reads similar to the Illumina internal standard PhiX genome.
booleanGenome reference used to remove Illumina PhiX contaminant reads.
string${baseDir}/assets/data/GCA_002596845.1_ASM259684v1_genomic.fna.gzSkip read preprocessing using fastp or adapterremoval.
booleanSpecify to save input FASTQ files with phiX reads removed to —outdir.
booleanRun BBnorm to normalize sequence depth.
booleanSet BBnorm target maximum depth to this number.
integer100Set BBnorm minimum depth to this number.
integer5Save normalized read files to output directory.
booleanSkip removing adapter sequences from long reads.
booleanDiscard any read which is shorter than this value.
integer1000Keep this percent of bases.
integer90The higher the more important is read length when choosing the best reads.
integer10Keep reads similar to the ONT internal standard Escherichia virus Lambda genome.
booleanGenome reference used to remove ONT Lambda contaminant reads.
string${baseDir}/assets/data/GCA_000840245.1_ViralProj14204_genomic.fna.gzSpecify to save input FASTQ files with lamba reads removed to —outdir.
booleanSpecify to save the resulting clipped FASTQ files to —outdir.
booleanSpecify to save the resulting length filtered FASTQ files to —outdir.
booleanSpecify which long read adapter trimming tool to use.
stringTaxonomic classification is disabled by default. You have to specify one of the options below to activate it.
Database for taxonomic binning with centrifuge.
stringDatabase for taxonomic binning with kraken2.
stringDatabase for taxonomic binning with krona
stringSkip creating a krona plot for taxonomic binning.
booleanDatabase for taxonomic classification of metagenome assembled genomes. Can be either a zipped file or a directory containing the extracted output of such.
stringGenerate CAT database.
booleanSave the CAT database generated when specified by --cat_db_generate.
booleanOnly return official taxonomic ranks (Kingdom, Phylum, etc.) when running CAT.
booleanSkip the running of GTDB, as well as the automatic download of the database
booleanSpecify the location of a GTDBTK database. Can be either an uncompressed directory or a .tar.gz archive. If not specified will be downloaded for you when GTDBTK or binning QC is not skipped.
stringhttps://data.gtdb.ecogenomic.org/releases/release220/220.0/auxillary_files/gtdbtk_package/full_package/gtdbtk_r220_data.tar.gzSpecify the location of a GTDBTK mash database. If missing, GTDB-Tk will skip the ani_screening step
stringMin. bin completeness (in %) required to apply GTDB-tk classification.
number50Max. bin contamination (in %) allowed to apply GTDB-tk classification.
number10Min. fraction of AA (in %) in the MSA for bins to be kept.
number10Min. alignment fraction to consider closest genome.
number0.65Number of CPUs used for the by GTDB-Tk run tool pplacer.
integer1Speed up pplacer step of GTDB-Tk by loading to memory.
booleanDatabase for virus classification with geNomad
stringCo-assemble samples within one group, instead of assembling each sample separately.
booleanAdditional custom options for SPAdes and SPAdesHybrid. Do not specify --meta as this will be added for you!
stringAdditional custom options for MEGAHIT.
stringSkip Illumina-only SPAdes assembly.
booleanSkip SPAdes hybrid assembly.
booleanSkip MEGAHIT assembly.
booleanSkip metaQUAST.
booleanSkip Prodigal gene prediction
booleanSkip Prokka genome annotation.
booleanSkip MetaEuk gene prediction and annotation
booleanA string containing the name of one of the databases listed in the mmseqs2 documentation. This database will be downloaded and formatted for eukaryotic genome annotation. Incompatible with —metaeuk_db.
stringPath to either a local fasta file of protein sequences, or to a directory containing an mmseqs2-formatted database, for annotation of eukaryotic genomes.
stringSave the downloaded mmseqs2 database specified in --metaeuk_mmseqs_db.
booleanRun virus identification.
booleanMinimum geNomad score for a sequence to be considered viral
number0.7Number of groups that geNomad’s MMSeqs2 databse should be split into (reduced memory requirements)
integer1Defines mapping strategy to compute co-abundances for binning, i.e. which samples will be mapped against the assembly.
stringSkip metagenome binning entirely
booleanSkip MetaBAT2 Binning
booleanSkip MaxBin2 Binning
booleanSkip CONCOCT Binning
booleanMinimum contig size to be considered for binning and for bin quality check.
integer1500Minimal length of contigs that are not part of any bin but treated as individual genome.
integer1000000Maximal number of contigs that are not part of any bin but treated as individual genome.
integer100Bowtie2 alignment mode
stringSave the output of mapping raw reads back to assembled contigs
booleanEnable domain-level (prokaryote or eukaryote) classification of bins using Tiara. Processes which are domain-specific will then only receive bins matching the domain requirement.
booleanSpecify which tool to use for domain classification of bins. Currently only ‘tiara’ is implemented.
stringtiaraMinimum contig length for Tiara to use for domain classification. For accurate classification, should be longer than 3000 bp.
integer3000Disable bin QC with BUSCO or CheckM.
booleanSpecify which tool for bin quality-control validation to use.
stringDownload URL for BUSCO lineage dataset, or path to a tar.gz archive, or local directory containing already downloaded and unpacked lineage datasets.
stringRun BUSCO with automated lineage selection, but ignoring eukaryotes (saves runtime).
booleanSave the used BUSCO lineage datasets provided via --busco_db.
booleanEnable clean-up of temporary files created during BUSCO runs.
booleanURL pointing to checkM database for auto download, if local path not supplied.
stringhttps://zenodo.org/records/7401545/files/checkm_data_2015_01_16.tar.gzPath to local folder containing already downloaded and uncompressed CheckM database.
stringSave the used CheckM reference files downloaded when not using —checkm_db parameter.
booleanTurn on bin refinement using DAS Tool.
booleanSpecify single-copy gene score threshold for bin refinement.
number0.5Specify which binning output is sent for downstream annotation, taxonomic classification, bin quality control etc.
stringTurn on GUNC genome chimerism checks
booleanSpecify a path to a pre-downloaded GUNC dmnd database file
stringSpecify which database to auto-download if not supplying own
stringSave the used GUNC reference files downloaded when not using —gunc_db parameter.
booleanPerforms ancient DNA assembly validation and contig consensus sequence recalling.
Turn on/off the ancient DNA subworfklow
booleanPyDamage accuracy threshold
number0.5deactivate damage correction of ancient contigs using variant and consensus calling
booleanPloidy for variant calling
integer1minimum base quality required for variant calling
integer20minimum minor allele frequency for considering variants
number0.33minimum genotype quality for considering a variant high quality
integer30minimum genotype quality for considering a variant medium quality
integer20minimum number of bases supporting the alternative allele
integer3