FlexiDot is a cross-platform dotplot suite generating high quality self, pairwise and all-against-all visualizations. To improve dotplot suitability for comparison of consensus and error-prone sequences, FlexiDot harbors routines for strict and relaxed handling of mismatches and ambiguous residues. The custom shading modules facilitate dotplot interpretation and motif identification by adding information on sequence annotations and sequence similarities to the images. Combined with collage-like outputs, FlexiDot supports simultaneous visual screening of a large sequence sets, allowing dotplot use for routine screening.
If you use FlexiDot in your research, please cite us:
Kathrin M. Seibt, Thomas Schmidt, and Tony Heitkam (2018) "FlexiDot: Highly customizable, ambiguity-aware dotplots for visual sequence analyses". Bioinformatics 34 (20), 3575–3577, doi: 10.1093/bioinformatics/bty395 - Read article - Preprint
Current version (Dec 2024): FlexiDot v2.0.0
For an overview of FlexiDot version updates please see the code history.
Corresponding parameter cheat sheets are available as well.
- in depth documentation (This readme gives an overview, and more detail is in the documentation.)
- parameter cheat sheet
- artificial test sequences used for the examples
- example: adding annotation-based shading to a dotplot
- presentation slides introducing dotplots and our FlexiDot tool
FlexiDot is implemented in Python 3, with dependencies:
You can create a Conda environment with these dependencies using the YAML file in this repo.
conda env create -f environment.yml
conda activate flexidotAfter activating the flexidot environment you can use pip to install the latest version of Flexidot.
Installation options:
pip install the latest development version directly from this repo.
% pip install git+https://github.com/molbio-dresden/flexidot.gitFlexidot is not currently available via PyPi or Bioconda. Watch this space.
Flexidot accepts one or more uncompressed fasta files as input. The files can contain multiple sequences.
# Use individual fasta file (can contain multiple sequences)
flexidot -i input.fasta [optional arguments]
# Use multiple fasta files
flexidot -i input1.fasta input2.fasta [optional arguments]
# Use all fasta files in current directory
flexidot -i *.fasta [optional arguments]Optional arguments are explained below and in detail in the usage. Importantly, -k defines the word size (e.g. -k 10) and -t specifies the sequence type (-t nuc for DNA [default]; -t aa for proteins). The plotting mode is chosen via -m and described below.
FlexiDot allows sequence investigation in three run modes via the option -m/--mode:
-m 0 self sequence comparison
-m 1 pairwise sequence comparison
-m 2 all-to-all sequence comparison
To run multiple plotting modes, call the option multiple times i.e. -m 0 -m 1 -m 2.
with -m/--mode 0
In self dotplot mode, each sequence is compared with itself. The resulting dotplots can be combined to form a collage (with --collage) or written to separate files.
flexidot -i test-seqs.fas -m 0 -D top -f pdf -k 10 -w -x --n_col 6 -P 15 -g example.gff3 -G gff_color.configwith -m/--mode 1
For pairwise dotplots, the collage output is recommended for larger numbers of sequences. The collage output of the 15 pairwise dotplots for the test sequences is shown below. By default, dotplot images are in square format (panel A). This maximizes the visibility of matches, if the compared sequences differ drastically in length. To enable scaling according to the respective sequence lengths, the FlexiDot scaling feature is callable via option -L/--length_scaling (panel B). If scaling is enabled, a red line indicates the end of the shorter sequence in the collage output.
#Panel A
flexidot -i test-seqs.fas -p 1 -D top -f png -k 10 -w --n_col 5 -c
#Panel B
flexidot -i test-seqs.fas -p 1 -D top -f png -k 10 -w --n_col 5 -c -Lwith -m/--mode 2
In all-against-all mode, FlexiDot compares each pair from a set of input sequences. To enable the identification of long shared subsequences at a glance, FlexiDot offers similarity shading (switched on/off via option -x/--lcs_shading) based on the LCS length in all-against-all comparisons (see below).
flexidot -i test-seqs.fasta -m 2 -D top -f png -t nuc -k 10 -w -x -y 0In diverged or distantly related sequences matches may be interrupted by mismatches, or residues might be represented as ambiguities to refer to frequent variants or mutations. Similarly, relaxed matching is helpful when analyzing error-prone sequences like SMRT reads. Relaxation of the matching conditions thus increases sensitivity, while decreasing specificity.
Firstly, FlexiDot handles ambiguous residues, often found in consensus sequences. This allows the comparison of species-specific representations of multigene or repeat families as well as common variants or sequence subfamilies. The ambiguity handling is controlled via-w/--wobble_conversion.
Secondly, a defined number of mismatches within the window can be allowed with -S/--substitution_count [number of allowed mismatches (substitutions)]. This is even less stringent than the ambiguity handling. Please note, that only substitution mutations are allowed but not indels.
Lastly, both mismatch and ambiguity handling can be combined for the analysis.
#Panel tl
flexidot -i Seq4.fasta Seq1.fasta -m 1 -D top -f png -k 10
#Panel tm
flexidot -i Seq4.fasta Seq1.fasta -m 1 -D top -f png -k 10 -S 1
#Panel tr
flexidot -i Seq4.fasta Seq1.fasta -m 1 -D top -f png -k 10 -S 2
#Panel bl
flexidot -i Seq4.fasta Seq1.fasta -m 1 -D top -f png -k 10 -w y
#Panel bm
flexidot -i Seq4.fasta Seq1.fasta -m 1 -D top -f png -k 10 -w y -S 1
#Panel br
flexidot -i Seq4.fasta Seq1.fasta -m 1 -D top -f png -k 10 -w y -S 2Note: See also our tutorial on how to integrate annotation shadings with a real-life example.
In FlexiDot self dotplots, annotated sequence regions can be highlighted by shading to allow clear assignment of dotplot regions to specific sequence contexts (see Seq2 in self dotplots). The underlying annotation information must be provided in general feature format (gff3), either as individual file or file list via the -g/--input_gff_files option. To customize GFF-based shading, a user-defined configuration file can be provided via the -G/--gff_color_config option. Example files are provided in the test-data directory. Please note, that a legend is generated in a separate file.
If you wish to find out more on the gff3 file format used here, Ensembl provides a good overview.
flexidot -i Seq2.fasta -m 0 -D top -f png -k 10 -w --n_col 12 -P 5 -g example.gff3 -G gff_color.configPreviously only available for self dotplots, we added annotation-based shading to all-against-all dotplots, allowing for many new visualizations. As before, annotation information is provided as general feature file (GFF3). These features are added to the middle diagonal (see our example below).
Basic command:
flexidot -i test-seqs.fas -g example2.gff3 -G gff_color.config -m 2Command plus aesthetics as shown here (+ LCS shading, wordsize 10, change of subplot spacing and line width):
flexidot -i test-seqs.fas -g example2.gff3 -G gff_color.config -m 2 -x -k 10 -F 0.06 -A 1.5The test files used here are provided:
In all-against-all mode, FlexiDot compares each pair from a set of input sequences. To enable the identification of long shared subsequences at a glance, FlexiDot offers similarity shading (switched on/off via option -x/--lcs_shading) based on the LCS length (longest common subsequence, or longest match if mismatches are considered) in all-against-all comparisons. Longer matches are represented by darker background shading. A separate shading legend output file is created written according to mathematical interval notation, where interval boundaries are represented by a pair of numbers. Consequently, the symbols “(” or “)” represent exclusion, whereas “[” or “]” represent inclusion of the respective number.
FlexiDot similarity shading is highly customizable with the following parameters, explained in depth in the documentation:
- Reference for shading (option
-y/--lcs_shading_ref) - Number of shading intervals (option
-X/--lcs_shading_num) - Shading based on sequence orientation (option
-z/--lcs_shading_ori)
Shading examples based on sequence orientation (forward, panel A; reverse, panel B; both, panel C) are shown:
#Panel A
flexidot -i test-seqs.fas -m 2 -D top -f png -t nuc -k 10 -x -y 0 -z 0
#Panel B
flexidot -i test-seqs.fas -m 2 -D top -f png -t nuc -k 10 -x -y 0 -z 1
#Panel C
flexidot -i test-seqs.fas -m 2 -D top -f png -t nuc -k 10 -x -y 0 -z 2
When comparing related sequences, multiple sequence alignments are frequently applied. The resulting pairwise sequence similarities can be integrated in the FlexiDot images by providing a matrix file via -u/--user_matrix_file <matrix.txt>. This allows a shading of the upper right triangle according to the matrix (here orange). With -U/--user_matrix_print the matrix values can be printed into the respective fields. Besides, also text information can be provided in the matrix, but then shading is suppressed.
In the example, LCS and matrix shading are combined to visualize the relationships between different members of a repeat family.
flexidot -i Beetle.fas -m 2 -x -k 10 -S 1 -r -u custom_matrix.txt -U