Scroll to navigation

BANDAGE(1) User Commands BANDAGE(1)

NAME

Bandage - Bioinformatics Application for Navigating De novo Assembly Graphs Easily

SYNOPSIS

Bandage <command> [options]

DESCRIPTION

Bandage is a GUI program that allows users to interact with the assembly graphs made by de novo assemblers such as Velvet, SPAdes, MEGAHIT and others..

OPTIONS

Commands

<blank> Launch the Bandage GUI
Launch the Bandage GUI and load a graph file
Display information about a graph
Generate an image file of a graph
Output graph paths for BLAST queries
Save a subgraph of a larger graph

Options

View this help message
View all command line settings
View Bandage version number

Settings

The following options configure the Bandage settings that are available in the Bandage GUI.

Note that hex colours will either need to be enclosed in quotes (e.g. "#FFB6C1") or have the hash symbol escaped (e.g. \#FFB6C1).

Graph scope

These settings control the graph scope. If the aroundnodes scope is used, then the --nodes option must also be used. If the aroundblast scope is used, a BLAST query must be given with the --query option

Graph scope, from one of the following options: entire, aroundnodes, aroundblast, depthrange (default: entire)
A comma-separated list of starting nodes for the aroundnodes scope (default: none)
Use partial node name matching (default: exact node name matching)
The number of node steps away to draw for the aroundnodes and aroundblast scopes (0 to 100, default: 0)
The minimum allowed depth for the depthrange scope (0 to 1e+6, default: 10)
The maximum allowed depth for the depthrange scope (0 to 1e+6, default: 100)
Draw graph in double mode (default: off)

Graph size

Node length per megabase (0 to 1e+6, default: auto)
Minimum node length (1 to 100, default: 5)
Edge length (0.1 to 100, default: 5)
Edge width (0.1 to 100, default: 1.5)
Double mode separation (0 to 100, default: 2)

Graph layout

Node segment length (1 to 1000, default: 20)
Graph layout iterations (0 to 4, default: 2)
Linear graph layout (default: off)

Graph appearance

Colour for edges (default: black)
Colour for node outlines (default: black)
Node outline thickness (0 to 100, default: 0)
Colour for selections (default: blue)
Disable antialiasing (default: antialiasing on)
Show node arrowheads in single mode (default: nodes are only displayed with arrowheads in double mode)

Text appearance

Colour for label text (default: black)
Colour for text outline (default: white)
Surround text with an outline with this thickness (0 to 10, default: 1.5)
Node labels appear at the centre of the node (default: off, node labels appear over visible parts of nodes)

Node width

Node widths are determined using the following formula:

a*b*((c/d)^e-1)+1
a = average node width
b = depth effect on width
c = node depth
d = mean depth
e = power of depth effect on width
Average node width (0.5 to 1000, default: 5)
Depth effect on width (0 to 1, default: 0.5)
Power of depth effect on width (0 to 1, default: 0.5)

Node labels

Label nodes with name (default: off)
Label nodes with length (default: off)
Label nodes with depth (default: off)
Label BLAST hits (default: off)
Font size for node labels (1 to 100, default: 12)

Node colours

Node colouring scheme, from one of the following options: random, uniform, depth, blastsolid, blastrainbow (default: random if --query option not used, blastsolid if --query option used)

Random colour scheme

These settings only apply when the random colour scheme is used.

Positive node saturation (0 to 255, default: 127)
Negative node saturation (0 to 255, default: 127)
Positive node lightness (0 to 255, default: 150)
Negative node lightness (0 to 255, default: 90)
Positive node opacity (0 to 255, default: 255)
Negative node opacity (0 to 255, default: 255)

Uniform colour scheme

These settings only apply when the uniform colour scheme is used.

Positive node colour (default: firebrick)
Negative node colour (default: maroon)
Special node colour (default: green)

Depth colour scheme

These settings only apply when the depth colour scheme is used.

Colour for nodes with depth below the low depth value (default: black)
Colour for nodes with depth above the high depth value (default: red)
Low depth value (0 to 1e+6, default: auto)
High depth value (0 to 1e+6, default: auto)

BLAST search

A FASTA file of either nucleotide or protein sequences to be used as BLAST queries (default: none)
Parameters to be used by blastn and tblastn when conducting a BLAST search in Bandage (default: none). Format BLAST parameters exactly as they would be used for blastn/tblastn on the command line, and enclose them in quotes.
Alignment length filter for BLAST hits. Hits with shorter alignments will be excluded (1 to 1e+6, default: off)
Query coverage filter for BLAST hits. Hits with less coverage will be excluded (0 to 100, default: off)
Identity filter for BLAST hits. Hits with less identity will be excluded (0 to 100, default: off)
E-value filter for BLAST hits. Hits with larger e-values will be excluded (1e-999 to 9.9e1, default: off)
Bit score filter for BLAST hits. Hits with lower bit scores will be excluded (0 to 1e+6, default: off)

BLAST query paths

These settings control how Bandage searches for query paths after conducting a BLAST search.

The number of allowed nodes in a BLAST query path (1 to 50, default: 6)
Minimum fraction of a BLAST query which must be covered by a query path (0.3 to 1, default: 0.9)
Minimum fraction of a BLAST query which must be covered by BLAST hits in a query path (0.3 to 1, default: 0.9)
Minimum mean identity of BLAST hits in a query path (0 to 1, default: 0.5)
Maximum e-value product for all BLAST hits in a query path (1e-999 to 9.9e1, default: 1e-10)
Minimum allowed relative path length as compared to the query (0 to 10000, default: 0.95)
Maximum allowed relative path length as compared to the query (0 to 10000, default: 1.05)
Minimum allowed length discrepancy (in bases) between a BLAST query and its path in the graph (-1e+6 to 1e+6, default: off)
Maximum allowed length discrepancy (in bases) between a BLAST query and its path in the graph (-1e+6 to 1e+6, default: off)

SEE ALSO

Online Bandage help: https://github.com/rrwick/Bandage/wiki

AUTHOR

This manpage was written by Andreas Tille for the Debian distribution and can be used for any other usage of the program.

August 2018 Bandage 0.8.1