Aligner Options

The following options are in the [Aligner] section of the configuration file. For more information, see DNA Aligning

Name

Description

Command Line Equivalent

Value

aln-min-score

(signed) Minimum alignment score to report; baseline for MAPQ.

When using local alignments (global = 0), aln-min-score is computed by the host software as "22 * match-score".

When using global alignments (global = 1), aln-min-score is set to -1000000.

Host software computation may be overridden by setting aln-min-score in configuration file.

--Aligner.aln-min-score

−2,147,483,648 to 2,147,483,647

dedup-min-qual

Minimum base quality for calculating read quality metric for deduplication.

--Aligner.dedup-min-qual

0–63

en-alt-hap-aln

Allows chimeric alignments to be output, as supplementary.

--Aligner.en-alt-hap-aln

0–1

en-chimeric-aln

Allows chimeric alignments to be output, as supplementary.

--Aligner.en-chimeric-aln

0–1

gap-ext-pen

Score penalty for gap extension.

--Aligner.gap-ext-pen

0–15

 

gap-open-pen

Score penalty for opening a gap (insertion or deletion).

gap-open-pen

0–127

global

If alignment is global (Needleman-Wunsch) rather than local (Smith-Waterman).

--Aligner.global

0–1

hard-clips

Flags for hard clipping: [0] primary, [1] supplementary, [2] secondary.

--Aligner.hard-clips

3 bits

map-orientations

Constrain orientations to accept forward-only, reverse-complement only, or any alignments.

--Aligner.map-orientations

0 (any)

1 (forward only)

2 (reverse only)

mapq-max

Ceiling on reported MAPQ.

--Aligner.mapq-max

0 to 255

 

mapq-strict-js

Specific to RNA. When set to 0, a higher MAPQ value is returned, expressing confidence that the alignment is at least partially correct. When set to 1, a lower MAPQ value is returned, expressing the splice junction ambiguity.

--mapq-strict-js

0/1

match-n-score

(signed) Score increment for matching a reference 'N' nucleotide IUB code.

--Aligner.match-n-score

-16–15

match-score

Score increment for matching reference nucleotide.

--Aligner.match-score

When global = 0, match-score > 0; When global = 1, match-score >= 0

max-rescues Maximum rescue alignments per read pair. Default is 10. --max-rescues 0–1023

min-score-coeff

Adjustment to aln-min-score per read base.

--Aligner. min-score-coeff

-64–63.999

mismatch-pen

Score penalty for a mismatch.

--Aligner.mismatch-pen

0–63

no-unclip-score

When no-unclip-score is set to 1, any unclipped bonus (unclip-score) contributing to an alignment is removed from the alignment score before further processing.

--Aligner.no-unclip-score

0-1

 

no-unpaired

If only properly paired alignments should be reported for paired reads.

--Aligner. no-unpaired

0–1

pe-max-penalty

Maximum pairing score penalty, for unpaired or distant ends.

--Aligner.pe-max-penalty

0–255

 

pe-orientation

Expected paired-end orientation: 0=FR, 1=RF, 2=FF.

--Aligner.pe-orientation

0, 1, 2

 

rescue-sigmas

Deviations from the mean read length used for rescue scan radius. Default is 2.5.

--Aligner.rescue-sigmas

 

sec-aligns

Maximum secondary (suboptimal) alignments to report per read.

--Aligner.sec-aligns

0–30

sec-aligns-hard

Set to force unmapped when not all secondary alignments can be output.

--Aligner.sec-aligns-hard

0–1

sec-phred-delta

Only secondary alignments with likelihood within this Phred of the primary are reported.

--Aligner.sec-phred-delta

0–255

sec-score-delta

Secondary aligns allowed with pair score no more than this far below primary.

--Aligner. sec-score-delta

 

supp-aligns

Maximum supplementary (chimeric) alignments to report per read.

--Aligner.supp-aligns

0–30

 

supp-as-sec

If supplementary alignments should be reported with secondary flag.

--Aligner.supp-as-sec

0–1

supp-min-score-adj

Amount to increase minimum alignment score for supplementary alignments. This score is computed by host software as "8 * match-score" for DNA, and is default 0 for RNA.

--Aligner. supp-min-score-adj

 

unclip-score

Score bonus for reaching each edge of the read.

--Aligner.unclip-score

0–127

 

unpaired-pen

Penalty for unpaired alignments in Phred scale.

--Aligner.unpaired-pen

0–255

If you disable automatic detection of insert-length statistics via the --enable-sampling option, you must override all the following options to specify the statistics. For more information, see Mean Insert Size Detection. These options are part of the [Aligner] section of the configuration file.

Option

Description

Command Line Equivalent

Value

pe-stat-mean-insert

Average template length.

 

0–65535

pe-stat-mean-read-len

Average read length.

 

0–65535

pe-stat-quartiles-insert

A comma-delimited trio of numbers specifying 25th, 50th, and 75th percentile template lengths.

 

0–65535

pe-stat-stddev-insert

Standard deviation of template length distribution.

 

0–65535