nf-core/mag
Assembly and binning of metagenomes
4.0.0). The latest
stable release is
5.0.0
.
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/Suffix to add to the trace report filename. Default is the date and time in the format yyyy-MM-dd_HH-mm-ss.
stringUse 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.
booleanTurn on detecting and trimming of poly-G tails
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.
stringAGATCGGAAGAGCACACGTCTGAACTCCAGTCACNNNNNNATCTCGTATGCCGTCTTCTGCTTG^[ATGCRYKMSWBDHVN]*$Reverse read adapter to be trimmed by AdapterRemoval for paired end data.
stringAGATCGGAAGAGCGTCGTGTAGGGAAAGAGTGTAGATCTCGGTGGTCGCCGTATCATT^[ATGCRYKMSWBDHVN]*$Name 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.
integer1000Discard any read which has a mean quality score lower than this value.
integerKeep 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 long read FASTQ files to —outdir.
booleanSpecify which long read adapter trimming tool to use.
stringSpecify which long read filtering 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.
booleanCo-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!
stringSpecify whether to use contigs or scaffolds assembled by SPAdes
stringAdditional custom options for MEGAHIT.
stringSkip Illumina-only SPAdes assembly.
booleanSkip SPAdes hybrid assembly.
booleanSkip MEGAHIT assembly.
booleanSkip metaQUAST.
booleanSkip Prodigal gene prediction
booleanTurn on Prokka complicance mode for truncating contig names for NCBI/ENA compatibility.
booleanSpecify sequencing centre name required for Prokka’s compliance mode.
stringSkip 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.
booleanDatabase for virus classification with geNomad
stringMinimum 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.
integer100Specify the shortest length a bin should be to retain for downstream processing (in base pairs)
integerSpecify the longest length a bin should be to retain for downstream processing (in base pairs). By default no limit.
integerSpecify length of sub-contigs cut up prior CONCOCT binning
integer10000Specify the overlap between each sub-contig prior CONCOCT binning
integerSpecify to not append the last contig less than sub-contig length to the last correct length contig
booleanSpecify alternative Bowtie2 settings for aligning reads back against the assembly.
string^[-\w]*$Save 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.
integer3000Exclude unbinned contigs in the post-binning steps (bin QC, taxonomic classification, and annotation steps).
booleanDisable bin QC with BUSCO, CheckM or CheckM2.
booleanSpecify which tool for bin quality-control validation to use.
stringDownload URL, local tar.gz archive, or local uncompressed directory for an *_odb10 or *_odb12 BUSCO lineage dataset.
stringName of the BUSCO *_odb10 or *_odb12 lineage to check against. Additionally supports ‘auto’, ‘auto_prok’ and ‘auto_euk’ for automatic lineage selection mode.
stringauto(.*_odb(10|12))|auto(_prok|_euk)?$Save 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.
booleanPath to local file of an already downloaded and uncompressed CheckM2 database (.dmnd file).
stringCheckM2 database version number to download (Zenodo record ID, for reference check the canonical reference https://zenodo.org/records/5571251, and pick the Zenodo ID of the database version of your choice).
integer14897628Save the used CheckM2 reference files downloaded when not using —checkm2_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