nf-core/eager

Either paths or URLs to FASTQ/BAM data (must be surrounded with quotes). For paired end data, the path must use ‘{1,2}’ notation to specify read pairs. Alternatively, a path to a TSV file (ending .tsv) containing file paths and sequencing/sample metadata. Allows for merging of multiple lanes/libraries/samples. Please see documentation for template.

Specifies whether you have UDG treated libraries. Set to ‘half’ for partial treatment, or ‘full’ for UDG. If not set, libraries are assumed to have no UDG treatment (‘none’). Not required for TSV input.

Specifies that libraries are single stranded. Always affects MALTExtract but will be ignored by pileupCaller with TSV input. Not required for TSV input.

Specifies that the input is single end reads. Not required for TSV input.

Specifies which Illumina sequencing chemistry was used. Used to inform whether to poly-G trim if turned on (see below). Not required for TSV input. Options: 2, 4.

Specifies that the input is in BAM format. Not required for TSV input.

If library result of SNP capture, path to BED file containing SNPS positions on reference genome.

Turns on conversion of an input BAM file into FASTQ format to allow re-preprocessing (e.g. AdapterRemoval etc.).

Path or URL to a FASTA reference file (required if not iGenome reference). File suffixes can be: ‘.fa’, ‘.fn’, ‘.fna’, ‘.fasta’.

Name of iGenomes reference (required if not FASTA reference).

Path to directory containing pre-made BWA indices (i.e. everything before the endings ‘.amb’ ‘.ann’ ‘.bwt’. Most likely the same path as —fasta). If not supplied will be made for you.

Path to directory containing pre-made Bowtie2 indices (i.e. everything before the endings e.g. ‘.1.bt2’, ‘.2.bt2’, ‘.rev.1.bt2’. Most likely the same value as —fasta). If not supplied will be made for you.

Path to samtools FASTA index (typically ending in ‘.fai’). If not supplied will be made for you.

Path to picard sequence dictionary file (typically ending in ‘.dict’). If not supplied will be made for you.

Specify to generate more recent ‘.csi’ BAM indices. If your reference genome is larger than 3.5GB, this is recommended due to more efficient data handling with the ‘.csi’ format over the older ‘.bai’.

If not already supplied by user, turns on saving of generated reference genome indices for later re-usage.

The output directory where the results will be saved.

Mode for publishing results in the output directory. Options: ‘symlink’, ‘rellink’, ‘link’, ‘copy’, ‘copyNoFollow’, ‘move’.

Email address for completion summary.

The AWSBatch JobQueue that needs to be set when running on AWSBatch

The AWS Region for your AWS Batch job to run on

Path to the AWS CLI tool

Turn on running poly-G removal on FASTQ files. Will only be performed on 2 colour chemistry machine sequenced libraries.

Specify length of poly-g min for clipping to be performed.

Specify adapter sequence to be clipped off (forward strand).

Specify adapter sequence to be clipped off (reverse strand).

Specify read minimum length to be kept for downstream analysis.

Specify minimum base quality for trimming off bases.

Specify minimum adapter overlap required for clipping.

Skip of merging forward and reverse reads together. Only applicable for paired-end libraries.

Skip adapter and quality trimming.

Skip quality base trimming (n, score, window) of 5 prime end.

Only use merged reads downstream (un-merged reads and singletons are discarded).

Specify which mapper to use. Options: ‘bwaaln’, ‘bwamem’, ‘circularmapper’, ‘bowtie2’.

Specify the -n parameter for BWA aln, i.e. amount of allowed mismatches in the alignment.

Specify the -k parameter for BWA aln, i.e. maximum edit distance allowed in a seed.

Specify the -l parameter for BWA aln i.e. the length of seeds to be used.

Specify the number of bases to extend reference by (circularmapper only).

Specify the FASTA header of the target chromosome to extend (circularmapper only).

Turn on to filter off-target reads (circularmapper only).

Specify the bowtie2 alignment mode. Options: ‘local’, ‘end-to-end’.

Specify the level of sensitivity for the bowtie2 alignment mode. Options: ‘no-preset’, ‘very-fast’, ‘fast’, ‘sensitive’, ‘very-sensitive’.

Specify the -N parameter for bowtie2 (mismatches in seed). This will override defaults from alignmode/sensitivity.

Specify the -L parameter for bowtie2 (length of seed substrings). This will override defaults from alignmode/sensitivity.

Specify number of bases to trim off from 5’ (left) end of read before alignment.

Specify number of bases to trim off from 3’ (right) end of read before alignment.

Turn on per-library creation pre-Adapter Removal FASTQ files without reads that mapped to reference (e.g. for public upload of privacy sensitive non-host data)

Host removal mode. Remove mapped reads completely from FASTQ (remove) or just mask mapped reads sequence by N (replace).

Turn on filtering of mapping quality, read lengths, or unmapped reads of BAM files.

Minimum mapping quality for reads filter.

Specify minimum read length to be kept after mapping.

Defines whether to discard all unmapped reads, keep only bam and/or keep only fastq format Options: ‘discard’, ‘bam’, ‘fastq’, ‘both’.

Deduplication method to use. Options: ‘markduplicates’, ‘dedup’.

Turn on treating all reads as merged reads.

Specify the step size of Preseq.

Specify length filter for DamageProfiler.

Specify number of bases of each read to consider for DamageProfiler calculations.

Specify the maximum misincorporation frequency that should be displayed on damage plot. Set to 0 to ‘autoscale’.

Turn on PMDtools

Specify range of bases for PMDTools to scan for damage.

Specify PMDScore threshold for PMDTools.

Specify a path to reference mask for PMDTools.

Specify the maximum number of reads to consider for metrics generation.

Turn on ability to calculate no. reads, depth and breadth coverage of features in reference.

Path to GFF or BED file containing positions of features in reference file (—fasta). Path should be enclosed in quotes.

Turn on BAM trimming. Will only run on non-UDG or half-UDG libraries

Specify the number of bases to clip off reads from ‘left’ end of read for half-UDG libraries.

Specify the number of bases to clip off reads from ‘right’ end of read for half-UDG libraries.

Specify the number of bases to clip off reads from ‘left’ end of read for non-UDG libraries.

Specify the number of bases to clip off reads from ‘right’ end of read for non-UDG libraries.

Turn on using softclip instead of hard masking.

Turn on genotyping of BAM files.

Specify which genotyper to use either GATK UnifiedGenotyper, GATK HaplotypeCaller, Freebayes, or pileupCaller. Note: UnifiedGenotyper requires user-supplied defined GATK 3.5 jar file. Options: ‘ug’, ‘hc’, ‘freebayes’, ‘pileupcaller’, ‘angsd’.

Specify which input BAM to use for genotyping. Options: ‘raw’, ‘trimmed’ or ‘pmd’.

When specifying to use GATK UnifiedGenotyper, path to GATK 3.5 .jar.

Specify GATK phred-scaled confidence threshold.

Specify GATK organism ploidy.

Maximum depth coverage allowed for genotyping before down-sampling is turned on.

Specify VCF file for SNP annotation of output VCF files. Optional. Gzip not accepted.

Specify GATK output mode. Options: ‘EMIT_VARIANTS_ONLY’, ‘EMIT_ALL_CONFIDENT_SITES’, ‘EMIT_ALL_ACTIVE_SITES’.

Specify HaplotypeCaller mode for emitting reference confidence calls . Options: ‘NONE’, ‘BP_RESOLUTION’, ‘GVCF’.

Specify GATK output mode. Options: ‘EMIT_VARIANTS_ONLY’, ‘EMIT_ALL_CONFIDENT_SITES’, ‘EMIT_ALL_SITES’.

Specify UnifiedGenotyper likelihood model. Options: ‘SNP’, ‘INDEL’, ‘BOTH’, ‘GENERALPLOIDYSNP’, ‘GENERALPLOIDYINDEL’.

Specify to keep the BAM output of re-alignment around variants from GATK UnifiedGenotyper.

Supply a default base quality if a read is missing a base quality score. Setting to -1 turns this off.

Specify minimum required supporting observations to consider a variant.

Specify to skip over regions of high depth by discarding alignments overlapping positions where total read depth is greater than specified in —freebayes_C.

Specify ploidy of sample in FreeBayes.

Specify path to SNP panel in bed format for pileupCaller.

Specify path to SNP panel in EIGENSTRAT format for pileupCaller.

Specify calling method to use. Options: ‘randomHaploid’, ‘randomDiploid’, ‘majorityCall’.

Specify the calling mode for transitions. Options: ‘AllSites’, ‘TransitionsMissing’, ‘SkipTransitions’.

Specify which ANGSD genotyping likelihood model to use. Options: ‘samtools’, ‘gatk’, ‘soapsnp’, ‘syk’.

Specify which output type to output ANGSD genotyping likelihood results: Options: ‘text’, ‘binary’, ‘binary_three’, ‘beagle’.

Turn on creation of FASTA from ANGSD genotyping likelihood.

Specify which genotype type of ‘base calling’ to use for ANGSD FASTA generation. Options: ‘random’, ‘common’.

Turns on ability to create a consensus sequence FASTA file based on a UnifiedGenotyper VCF file and the original reference (only considers SNPs).

Specify name of the output FASTA file containing the consensus sequence. Do not include .vcf in the file name.

Specify the header name of the consensus sequence entry within the FASTA file.

Minimum depth coverage required for a call to be included (else N will be called).

Minimum genotyping quality of a call to be called. Else N will be called.

Minimum fraction of reads supporting a call to be included. Else N will be called.

Turn on MultiVCFAnalyzer. Note: This currently only supports diploid GATK UnifiedGenotyper input.

Turn on writing write allele frequencies in the SNP table.

Specify the minimum genotyping quality threshold for a SNP to be called.

Specify the minimum number of reads a position needs to be covered to be considered for base calling.

Specify the minimum allele frequency that a base requires to be considered a ‘homozygous’ call.

Specify the minimum allele frequency that a base requires to be considered a ‘heterozygous’ call.

Specify paths to additional pre-made VCF files to be included in the SNP table generation. Use wildcard(s) for multiple files.

Specify path to the reference genome annotations in ‘.gff’ format. Optional.

Specify path to the positions to be excluded in ‘.gff’ format. Optional.

Specify path to the output file from SNP effect analysis in ‘.txt’ format. Optional.

Turn on mitochondrial to nuclear ratio calculation.

Specify the name of the reference FASTA entry corresponding to the mitochondrial genome (up to the first space).

Turn on sex determination for human reference genomes.

Specify path to SNP panel in bed format for error bar calculation. Optional (see documentation).

Turn on nuclear contamination estimation for human reference genomes.

The name of the X chromosome in your bam/FASTA header. ‘X’ for hs37d5, ‘chrX’ for HG19.

Turn on metagenomic screening module for reference-unmapped reads.

Specify which classifier to use. Options: ‘malt’, ‘kraken’.

Specify path to classifier database directory. For Kraken2 this can also be a .tar.gz of the directory.

Specify a minimum number of reads a taxon of sample total is required to have to be retained. Not compatible with —malt_min_support_mode ‘percent’.

Percent identity value threshold for MALT.

Specify which alignment mode to use for MALT. Options: ‘Unknown’, ‘BlastN’, ‘BlastP’, ‘BlastX’, ‘Classifier’.

Specify alignment method for MALT. Options: ‘Local’, ‘SemiGlobal’.

Specify the percent for LCA algorithm for MALT (see MEGAN6 CE manual).

Specify whether to use percent or raw number of reads for minimum support required for taxon to be retained for MALT. Options: ‘percent’, ‘reads’.

Specify the minimum percentage of reads a taxon of sample total is required to have to be retained for MALT.

Specify the maximum number of queries a read can have for MALT.

Specify the memory load method. Do not use ‘map’ with GPFS file systems for MALT as can be very slow. Options: ‘load’, ‘page’, ‘map’.

Specify to also produce SAM alignment files. Note this includes both aligned and unaligned reads, and are gzipped. Note this will result in very large file sizes.

Turn on MaltExtract for MALT aDNA characteristics authentication.

Path to a text file with taxa of interest (one taxon per row, NCBI taxonomy name format)

Path to directory containing containing NCBI resource files (ncbi.tre and ncbi.map; available: https://github.com/rhuebler/HOPS/)

Specify which MaltExtract filter to use. Options: ‘def_anc’, ‘ancient’, ‘default’, ‘crawl’, ‘scan’, ‘srna’, ‘assignment’.

Specify percent of top alignments to use.

Turn off destacking.

Turn off downsampling.

Turn off duplicate removal.

Turn on exporting alignments of hits in BLAST format.

Turn on export of MEGAN summary files.

Minimum percent identity alignments are required to have to be reported. Recommended to set same as MALT parameter.

Turn on using top alignments per read after filtering.