Help items
File Menu Edit Menu Align Menu Props Menu Sites Menu Species Menu
Footers Menu Search Goto Trees Menu Alignment panel Tree windows
Dot plot Mase file format Program arguments Sequence coloring Miscellaneous options Customization
About seaview

Program seaview was published in:
Gouy, M. Guindon, S. & Gascuel., O. (2010) SeaView version 4 : a multiplatform graphical user interface for sequence alignment and phylogenetic tree building. Molecular Biology and Evolution 27(2):221-224.
Galtier, N., Gouy, M. & Gautier, C. (1996) SEAVIEW and PHYLO_WIN: two graphic tools for sequence alignment and molecular phylogeny. Comput. Appl. Biosci., 12:543-548.

Version 5.0.5

Binaries and full source code available from http://doua.prabi.fr/software/seaview

© 1996-2020 Manolo Gouy
Laboratoire de Biométrie et Biologie Evolutive
CNRS / Université de Lyon

Licensed under the GNU General Public Licence.

Seaview drives the Muscle, Clustal Omega, Gblocks, PhyML and Treerecs programs and uses code from the PHYLIP package for parsimony. Please quote:

Seaview uses the FLTK project for its user interface.

Some seaview versions use the PDFlib Lite library for pdf output under the "Open Source Developer Exemption" of the PDFlib Lite License Agreement.


Alignment panel

Mouse Use:

Active keys: Mouse use on the site line (when there is one, white line at bottom):
File Menu

Open: opens a sequence alignment file in any of the supported formats, or a Newick-formatted tree file.
Open Mase, Open Phylip, Open Clustal, Open MSF, Open Fasta, Open NEXUS: to load an alignment in one of these formats.
Formats Phylip, Clustal and Fasta use _ instead of space in names. Only the interleaved version of the Phylip format is supported. Mase and Nexus formats have the useful feature of allowing extra data beyond sequences and names (comments, accession numbers are really useful!). They can also store trees, site sets [see Sites Menu], species sets, footers, genetic code information.

Import from DBs: to import one or several sequences from various databases (EMBL, GenBank, SwissProt/UniProt) into the alignment window. Importation requires an internet connection that allows outbound access to port # 5558. See Troubleshooting Importation from Databases if you experience problems with this function. Imported sequences will be named in the alignment window either by the name of their ID or LOCUS record or by their species. Sequences can be identified by two means:
1. By name, accession number or keyword. Protein IDs, without their extension (e.g., CAA06608 from /protein_id="CAA06608.1"), are processed as keywords attached to sequences, so can also be used. Because imported sequences are named with information taken from their ID/LOCUS record, the protein ID won't be used to name the sequence.
2. By a local text file of names or accession nos (one per line, strict text file, e.g., not a .doc or .odt file).
In case 1. and for nucleotide databases, it is also possible to import sequence fragments corresponding to a specified feature key (e.g., CDS, rRNA, tRNA) and, optionally, to require a given string to be present in the feature's annotations. If no matching string is specified, only the first matching feature key is imported. CDSs are imported with their correct genetic code and reading frame. Access to a series of other databases is also possible.

Save: when active, saves the alignment in the current file (which name appears as window title). The shortcut for this operation is ctrl-S (cmd-S on Mac).

Save as...: to save the alignment under a name and a format to be chosen in the file selector appearing next. This item is unavailable when a nucleotide alignment is translated to proteins. Use "Save prot alignmt" below instead.

Save selection: only active when some sequences are selected or when a site line is displayed; allows to save in a file selected sites, or selected sequences, or selected sites of selected sequences.

Save prot alignmt: only active when a nucleotide alignment is translated to proteins; allows to save resulting protein sequences in any format.

Save bootstrap replicates: allows to store in a PHYLIP-formatted output file bootstrap replicates of the sequences of the alignment window. This command operates on selected sequences, and on selected sites if a sequence or site selection is currently active. It operates with protein sequences when a nucleotide alignment is translated to proteins. It asks for the desired output filename and number of bootstrap replicates. The "phylip names width" item of the "Props/Customize" dialog window allows to control the maximum name length used in the output file.

Prepare PDF/PostScript and PDF/PostScript options: Writes the alignment as a PDF/PostScript file with optional choices set through the "PDF/PostScript options..." menu item (or the save dialog on Mac OS):

Concatenate: To add one alignment (source) to the end of another (target). Can be done "by name" (seqs with same name are concatenated) or "by rank" (seqs with same rank in alignments are concatenated). Option "add gaps" replaces names absent in either alignment by gap-only sequences ("by name" only).

New window: Opens a new, empty alignment window.

Close window: Closes the alignment window.

Quit: guess what?


Edit Menu

Copy selected seqs: only active when some sequences are selected; copies in clipboard these sequences, or only their selected sites if a site line is displayed.
Paste alignment data: To paste sequence data from the clipboard to the bottom of the current alignment window (inactive in "View as protein" mode). The clipboard can either contain sequences that were previously copied in seaview using "Copy selected seqs", or sequence data in Fasta format copied from anywhere. In the latter case, the user is asked for confirmation before adding sequences to the alignment.
Select all: Selects all sequences from the alignment.
Rename sequence: To rename the currently selected (= name in black background) sequence.
Edit comments: To see or change comments of the currently selected sequence (Comments can only be saved in mase/NEXUS formats).
Edit sequence: To edit the selected sequence, typically by pasting external data, or by opening two edit sequence windows and transferring sequence data between them. The edit window is limited to sequences of length < 32000.
Delete sequence(s): Deletes all selected sequences from the alignment.
Create sequence: Allows to create a new, empty sequence in the alignment; set "Allow seq. edition" from Props menu ON to be able to type the sequence in.
Load sequence: Allows to load a new sequence in the alignment. The sequence can be typed in or pasted from a selection made in another window. The "Sequence loading window" is limited to sequences of length < 32000.
Duplicate sequence: Duplicates the currently selected sequence with prefix D_ in its name.
Complement sequence: Creates a new sequence equal to the complementary strand of the currently selected sequence with prefix C_ in its name.
Reverse sequence: Creates a new sequence by reading 3' -> 5' the currently selected sequence and named with prefix R_
Exchange Us and Ts: Exchange bases Us and Ts in all currently selected sequences.
Dot plot: Performs a dot plot analysis of the two selected sequences.
Consensus sequence: Computes the consensus of all currently selected sequences. The consensus sequence is added to the alignment with the name "Consensus##" below all selected sequences. At any site, the consensus residue is the most frequent one if its frequency is above a threshold value. Below threshold, N or X is used. See Consensus options of menu Props for more details.
Del gap-only sites: Deletes all gap-only sites from the alignment.
Set genetic code: Allows to specify the genetic code used to translate to protein the selected sequence(s). Active only with nucleotide alignments. Genetic codes are saved if the mase, NEXUS, or FASTA file formats are used.


Align Menu

Align all
Align selected sequences:
Runs the chosen alignment program on all or on selected sequences. Alignment program is chosen with Alignment options of menu Align. With MSWindows and Unix, the chosen alignment program is searched in the directory of the seaview program and in directories of your PATH.
Align selected sites: Runs the chosen alignment program on the block of selected sites and the set of selected sequences. A window will ask for choosing the reference sequence: gaps present before alignment in the chosen sequence will be preserved in the new alignment.
Profile alignment: Align selected sequences against a profile, that is, a group of pre-aligned sequences.
Possible operations for making a profile alignment:

  1. select members of the profile group;
  2. do 'Create group' of menu Species;
  3. select sequences you want to align against the profile group;
  4. do 'Profile alignment' of menu Align;
  5. choose the profile group in the dialog menu;
  6. choose alignment algorithm;
  7. if using clustalo, choose between "each sequence to profile" and "profile to profile" (with "profile to profile", selected sequences are expected to be pre-aligned to each other.
  8. Uncheck "Propagate gaps to sites" if you don't want gaps created in the profile group by the profile alignment to be propagated to all your site selections (menu "Sites").

De-align selection: Remove all gaps from selected sequences.
Alignment options:
Props Menu

Fontsize: 8, 10, ..., 36: Sets the font size used to display sequences.
View as proteins: When ON, DNA sequences are displayed as translated to protein sequences. This allows to align them, and to go back to the DNA level by unselecting this item. Items Save/Save as of menu File and sequence edition are impossible when ON.
Colors:


Allow seq. editing: When ON, residues can be deleted/inserted. When OFF (normally), only gaps can be deleted/inserted.
by Reference: To display the alignment by reference to a particular sequence: residues identical to that of the ref. seq. are displayed as dots. Possible only when one sequence, the reference, is selected. Alignment edition is impossible while in the reference mode. When used, item "Prepare pdf" of menu "File" produces an output by reference. Combination ctrl/cmd+R is a shortcut for calling/exiting this mode.
DNA keys: Allows to use keys "hjkl" to enter DNA sequences. "Allow seq. edition" should be ON for this item to be usable. Choose in the submenu what bases will be mapped to these keys: hjkl => GATC, hjkl => TCGA, hjkl => ACGT. Also, the space bar will be mapped to base N.
Consensus options: Allows to set the threshold fraction of identical residues needed to define a residue when building a consensus sequence (the default value is 60 %). Sites where this fraction is not reached are filled with N or X (or, for DNA, with nucleotide ambiguity symbols if "Use IUPAC symbols" is on). If "allow gaps" is off, gaps are ignored to compute which residue will appear in the consensus; this option in effect treats gaps as missing information. If "allow gaps" is on, gaps are treated as another character state to compute consensus.
IUPAC nucleotide ambiguity symbols
SymbolMRWS YK VHDB
NucleotidesACAGATUGCCTUGTU ACGACTUAGTUCGTU

Allow lowercase: If set, lowercase residues will be apparent. If not set, lowercase residues in sequence files display as uppercase.
Customize: To change, possibly permanently, various display settings. See Miscellaneous options and Sequence coloring help items. Apply: applies changes in current program session. Set changes permanent: applies changes in current and future program sessions. Close: ignores changes.
Statistics: Displays base or amino acid sequence compositions, and transition and transversion counts. These statistics apply to all sequences or to selected sequences only. When two nucleotide sequences are selected, the frequency of all pairs of homologous bases is also computed. Statistics can also be saved to a user-chosen text file.
Sites Menu

Site sets allow to specify parts of a multiple alignment to be retained for further analyses (e.g., those parts of the alignment taken as reliably aligned). Retained sites are depicted as series of Xs on a special line at bottom of the alignment panel. Mouse clicks and drags on this line allow to construct/alter the set (see Mouse use on the site line).

Several sets of sites can be created and stored with the alignment if the Mase or NEXUS formats of alignment files are used. Each set has a name chosen by the user. One set of sites at most can be displayed at any time through this menu.

Item Save selection of menu "File" allows to save in an alignment file only those sites of the alignment pertaining to the currently displayed site set.

Create set: Several kinds of sets of sites are possible:

Non-custom site sets are better used once alignment operations are completed.
Duplicate set: duplicates the current set of sites under a new name
Hide set: hides (but remembers) the current set of sites
Delete set: removes the currently displayed set of sites from list of known sets
name: shows the site line of name name. It can have been read in together with the alignment data, or previously created by "Create set".
Species Menu

Species sets can be created and stored with the alignment if the Mase or NEXUS formats of alignment files are used.

To select one or several species, click or drag on their names; they will appear in black background.

To memorize the current set of selected species, choose "Create set" from this menu. The program will ask for a name for this set.

Delete set: deletes (just from memory) the current set of species.
name: displays with black background the set of species memorized under that name.


Footers Menu

Comment lines can be created and displayed at bottom of the screen. These lines can contain any text and the program will maintain the vertical alignment between this text and sequences. This text can be saved using the mase or NEXUS file formats only.

To edit this text, click on the line name, position the cursor, and type text.
Click again on the line name to stop editing this text.

Show / Hide footers: To show / hide all footer lines
Create footer: To create a new footer line
Delete footer: To delete the currently selected footer line


Search

Type a string in box at right and strike <return> key or push button to position the cursor in the next occurence of this string from its current place.

Push button to position the cursor at next occurence of the current search string.

Sequence gaps are ignored by the search procedure.


Goto

Moves the cursor to desired position or sequence:


Trees Menu

This menu allows to compute, draw, save, and import DNA or protein phylogenetic trees.
Protein-coding DNA sequences displayed as protein sequences (item "View as proteins" of menu Props) are treated as protein sequences.
All tree computations apply to selected sequences (or all if none) and selected sites (or complete alignment if none).
All trees, sequence, and site selections can be saved together with the alignment data in either the mase or Nexus formats.

Parsimony:
Computes parsimony trees using PHYLIP's v3.696 dnapars or protpars algorithms and returns the consensus of all most parsimonious trees found.


Randomize seq. order: to repeat n times the search for shortest trees with randomized sequence order.
Ignore all gap sites: if on, all gap-containing sites are excluded from analysis.
Gaps as unknown states: if on, gap-containing sites are coded as unknown states so don't introduce parsimony steps; if off, they are treated as an additional character state. The interface forbids the meaningless configuration that would ignore gaps and treat them as unknown states.
More/Less thorough tree search/Rearrange on best tree: (DNA only) these 3 options control, in decreasing order, how, and how much, rearrangement is done on the tied trees to find shorter trees. It may be necessary to select the second or third option when the data set contains many (near-)identical sequences.
Equally best trees retained (DNA only): maximum number of equally best trees retained in search.
% level for consensus tree building: Parsimony often identifies several most parsimonious trees, and seaview computes their consensus and displays it. The default 100% consensus level corresponds to the strict consensus rule. The 50% level corresponds to the majority rule consensus. Intermediate values v include in the consensus tree all species groups present in at least a fraction v of the most parsimonious trees.
Bootstrap: performs bootstrap evaluation of clade statistical support (can be interrupted). Furthermore, if "Show bootstrap trees" is checked, individual bootstrap trees will appear in a second tree window, in addition to the main parsimony tree window. Each bootstrap tree has a weight that appears at the top left of the tree window when this tree is displayed. The weights of all equally parsimonious trees add up to 1 for each bootstrap replicate.
User tree: computes the number of steps of a user-given tree taken from those in the "Trees" menu. Such trees can have been previously computed or imported from an external source in Newick format.

Distance methods:
Computes NJ or BioNJ trees on a variety of pairwise phylogenetic distances.
NJ/BioNJ: to select the tree-building algorithm
Save to file: does not compute any tree but saves sequence pairwise distances to a local file.
Distance: select one among a variety of evolutionary distances: J-C: Jukes & Cantor (1969); K2P: Kimura (1980) JME 16:111; HKY: Rzhetsky & Nei (1995) MBE 12:131; LogDet: Lake (1994) PNAS 91:1455; Lockhart et al. (1994) MBE 11:605; Ka/Ks: Li (1993) JME 36:96.
ignore all gap sites: if on, all gap-containing sites are excluded from analysis; if off, not all sequence pairs use the same set of sites for computation of distances.
Bootstrap: performs bootstrap evaluation of clade statistical support (can be interrupted). Bootstrap supports can be optionally computed with the Transfer Bootstrap Expectation method. Furthermore, if "Show bootstrap trees" is checked, individual bootstrap trees will appear in a second tree window, in addition to the main distance tree window.
User tree: computes least squares branch lengths for selected user tree topology.

PhyML:
Computes trees using PhyML v3.0 as an external program.
If needed, PhyML can be downloaded from its web site
Under Unix, file $HOME/.seaviewrc may contain the name of the PhyML executable used by seaview.
Please quote: Guindon S., Dufayard J.F., Lefort V., Anisimova M., Hordijk W., Gascuel O. (2010) New Algorithms and Methods to Estimate Maximum-Likelihood Phylogenies: Assessing the Performance of PhyML 3.0. Systematic Biology 59(3):307-321.
Model: select one among a variety of evolutionary models.
Branch support: can be omitted (None) or estimated either by the approximate likelihood ratio test approach (aLRT) or by bootstrap. The bootstrap branch support can be computed by two methods:

If "Transfer Bootstrap Expectation method" is checked, both methods for computing bootstrap supports are used and displayed in two tree windows. With both bootstrap methods, if "Show bootstrap trees" is checked, individual bootstrap trees will appear in yet another tree window.
Nucleotide/Amino acid equilibrium frequencies: Residue frequencies can be estimated by counting their frequencies in the sequence alignment ("Empirical" option). Alternatively, they can be optimized by maximum likelihood ("Optimized" option for DNA data) or fixed to a set of model-given values ("Model-given" option for protein data).
Ts/Tv ratio: (applies to some nucleotide models only) optimize or fix a priori this ratio.
Invariable sites: ignore (None), optimize, or set to an a priori value (Fixed) the fraction of invariable sites.
Across site rate variation: ignore (None), optimize, or set to an a priori value (Fixed) the alpha parameter of the gamma distribution of rates across sites. If not ignored, the # of rate categories must also be set.
Tree searching operations: NNI (nearest-neighbor interchange), SPR (subtree pruning and regrafting) and 'best of NNI & SPR' are options improving the search for the most likely tree but requiring increasing computation time.
Starting tree: controls the tree used to start tree-space search; can be BioNJ, a user-given tree from the trees menu, or a number of random trees (possible only with SPR). Turn off "Optimize tree topology" to compute the likelihood of a user-given tree.
Quiet: If ON, no indication of the computation progression will appear. Turning this ON also ensures that runs requiring large memory don't block with the "WARNING: this analysis requires at least ## Mo of memory space." message.

Import tree: to import an external, Newick-formatted tree.

New tree window: opens a new, empty tree window.


Tree windows
Plots/saves/prints/copies phylogenetic trees that can be rooted or unrooted, with or without branch lengths, binary or multibranched, with or without branch support values.
A tree window can contain several trees. In that case, left and right arrows at top right of the window allow to circulate around them. Multiple-tree windows can occur after these operations:

File menu


Save to Trees menu: to save in menu Trees of alignment window a previously computed tree.
Remove from Trees menu: removes a tree from menu Trees of alignment window.
Save rooted (unrooted) (sub)tree: saves displayed tree or subtree to a local file as rooted or unrooted form.
Save all trees: writes all trees attached to the tree window to a single file (active only when several trees are attached to the tree window and arrows at window top-right allow to circulate around them).
Save patristic distances: writes in a file the patristic distances for all pairs of tree leaves (= sum of the lengths of branches connecting the two leaves). Computes also the tree length equal to the sum of all tree branch lengths. Computations are restricted to the subtree if the tree display is currently limited to a subtree. For trees without branch lengths, the computation is run as if all branch lengths were equal to 1, except the two branches that stem from the root of length taken as equal to 0.5.
Print: prints displayed tree (see also 'Page count' below).
Save as PDF/PostScript: saves displayed tree to PDF (or PostScript) local file (see Page Count).
A4 - Letter: controls the page format for PDF/PostScript operations.
Landscape: controls the page layout for PDF/PostScript operations.
Page count>#: controls the # of pages used for print/PDF/PostScript operations.
Save as SVG: saves displayed (sub)tree to a scalable vector graphics (SVG) local file suitable to be edited using appropriate programs (e.g., Inkscape).
Reorder following tree: reorders sequences of alignment window as in displayed tree.
Select in alignment: selects in alignment window all members of subtree (active when only a subtree is plotted).
Open tree or alignment: opens a new tree (Newick format; the file can contain several trees consecutively) or alignment file (any format).
New window: opens a new, empty tree window where a Newick-formatted tree can be pasted from clipboard.
Close window: closes the displayed tree that gets lost unless it had been saved to Trees menu.

Edit menu


Copy: (Mac OS and MSWindows only) copies tree plot to clipboard for pasting to external programs.
Paste tree: (only if window is empty) to paste a Newick-formatted tree contained in the clipboard. The clipboard may contain several trees.
Find: finds sequence names in tree that contain a user-given string, and red-colors them in tree display (case insensitive).
Again: repeats 'Find' operation with same matching rules.
Edit tree header: to change the tree's brief descriptive header line.
Branch support threshold: only branch support values above given threshold become displayed.
Root at tree center: roots the tree in the middle of the largest path between two leaves (when branch lengths exist).
Get or Set window size: to control the size of the current tree window.
Edit tree shape: to alter tree shape by moving or deleting sequence groups. A new window displays the tree without branch lengths. Clicking on a square selects a sequence group that appears in red. It can be moved to another branch of tree by clicking on another square, or deleted ("Delete group" button). "Select group" button allows to select another group for further move or delete operations. Complete edits by pressing "End edit" button, and, possibly, "File/Save to Trees menu".
Default name trimming rule: allows to set and change the rule used to trim long sequence names when displaying trees. Use an empty rule not to trim sequence names. See Trim rule for details about how trimming rules work.

Reconcile menu:: See Treerecs for details about how gene/species tree reconciliation works.

Font menu: to control font, style and size of all text in tree display.

Br lengths: toggles display of branch length values next to each branch (very small values are not displayed).
Br support: toggles display of support values (typically, bootstrap, posterior probabilities, or aLRT) next to branches.

squared/circular/cladogram: toggles display between squared plot convenient for rooted trees, circular plot convenient for unrooted trees, and cladogram which displays trees with all branch lengths a multiple of a unit length and all leaves aligned at right. Cladogram is not available for branch length-free trees because it is equivalent to the squared display for them.

counter:Appears when the loaded treefile contains several trees (e.g., after a bootstrap analysis in which the "Show bootstrap trees" option was selected), and allows to navigate around those trees.

Trim rule: Allows to enter a rule for trimming long sequence names. Click on the white area. A dialog window allows to enter the desired sequence name trimming rule.
Trim by content: enter one or more characters; each sequence name will be trimmed after all these characters have been found in the name.
Trim by length: enter a number; each sequence name longer than this number will by cut.
Examples:

Use an empty trimming rule to go back to full sequence names.

The default trimming rule can be set with the Edit menu.

Full: normal, full tree display.
Swap: to swap branches around a node. Click on relevant square that appears.
Re-root: to set tree outgroup. Click on relevant square that appears.
Select: to select/unselect alignment sequences from a tree. Click in the tree on a square at a sequence name or at a node to select/unselect it in the corresponding alignment window. Conversely, click on sequence names in the alignment window to select/unselect them in the tree. Selected sequences appear with a red square in the tree, and with their name on black background in the alignment.
Subtree: to limit display to a subtree. Click on relevant square that appears.
Subtree up: when a subtree is being displayed, adds one more node towards tree root to display.

Zoom: vertical zoom for tree display; one or two scrollers appear. The tree can be moved by the scrollers, the mouse wheel, or by clicking on and dragging the plot.

Treerecs:
Use the
Treerecs method to rearrange, root and/or correct a gene tree according to a species tree.
If needed, Treerecs sources can be downloaded.
Species tree: select the full-binary species tree associated with your genes.
Branch support threshold: change to contract/remove branches with a support lower than this value. With -1 there is no branch contraction.
Duplication cost: define the cost associated with a gene duplication event
Loss cost: define the cost associated with a gene loss event
Find best root: check the box to ask Treerecs to root or reroot the tree
Use gene names: associate gene with species according to gene names (which contains the associated species name). There is two methods: the Auto method and the manual. The manual needs to give a character as a separator and a position to define species name location in gene.
Use file: use Smap file to associate genes with species.
Output tree: check Full reconciliation to view the tree with all duplication and loss events found by Treerecs.

N.B. On the macOS platform, tree reconciliation requires macOS version 10.9 or higher.


Dot Plot
Performs a "dot plot" analysis of two sequences

Enter desired values for the window size and # of matches/window, and click on button "Compute", the dot plot will appear.

Click in the dot plot, the corresponding sequence regions appear in the alignment panel above the dot plot. Use "Magnify" to take a close look.
Click on arrows at left to move the hit point by one residue in either of six directions.
Move the slider below the alignment panel to control the number of displayedresidues.

Fit to window, Reduce, Magnify: perform zoom in and out operations
Write PDF/ps: saves the dot plot to a PDF or PostScript file.
Close: closes the dot plot window

To perform a dot plot-guided alignment

Click on a diagonal representing two sequence parts to be aligned, then click on button "align". Repeat this for each sequence parts you want to be aligned to each other.
To transfer into the multiple alignment the result of these operations, click on button "Record alignment".
Most often, one of the two compared sequences is already aligned to other sequences of the multiple alignment, while the other one is not. Choose which of the two sequences is already aligned by clicking on the arrow next to "Ref. sequence".
Mase file format
Mase files follow the following format:

Zero or more header lines each beginning with ;;
Next, for each sequence in the alignment:
One or more comment lines each beginning with ;
Sequence name alone on a line (may be long and may contain spaces)
Sequence data in free form, possibly with numbers and spaces ignored while reading the file. Dashes denote gaps.

Header lines may contain any text and also contain descriptions of trees, site sets and species groups when such data have been defined.

Trees are as in this example:


;;$ BioNJ tree
;;[BioNJ 658 sites J-C](((boli_haplo_03:0.00146,boli_haplo_06:0.00159)
;;:0.00159,boli_haplo_05:0.00146):0.02886,boli_haplo_01:0.03142);

Site sets are written as in this example:


;;# of segments=10  mychoice
;; 14,74 221,256 416,449 990,1148 1363,1384 1474,1483 1556,1668 
;; 2034,2062 2114,2139 2756,2859
where "mychoice" is the name of the set of sites and where the series of pairs of numbers lists the endpoints of successive block of sites.

Species groups are written as in this example:


;;@ of species = 4 distant outgroup
;; 2, 3, 4, 5
where "distant outgroup" is the name of the species group and where the series of numbers lists the ranks of sequences members of the species group.
Program arguments
Seaview can be run by using a command line:
seaview [options] [alignment-or-tree-file]
where alignment-or-tree-file is an optional sequence alignment or tree file to be read (always the last argument) and options are as in the following table:
-h display all program options and exit
-fast sequences will be displayed faster but less smoothly
-fontsize n font size used for the tree or alignment windows
Options for non-interactive usage driven by command-line arguments
Use exactly one of these options to get a non-interactive seaview run. Add any of the sub-options described below.
-convert convert an input alignment to another format (no window creation)
-concatenate concatenate alignment(s) to the end of an input alignment (no window creation)
-align align an input sequence file (no window creation)
-build_tree compute a phylogenetic tree from an input alignment file (no window creation)
-printout draw a multiple sequence alignment to PDF/SVG (no window creation)
-reroot modify the rooting of, or process otherwise, an input tree (no window creation)
-plotonly draw an input tree in a pdf or svg file (no window creation)
 
Sub-options for -convert
Use '-' as last argument to read alignment from standard input
-output_format fmt format of the converted alignment file (mase, phylip, clustal, msf, fasta, or nexus). The format of the input file is the default.
-o fname use fname as name of the converted alignment (default is built from input filename)
-o - write the output alignment to standard output
-translate translate input sequences to protein before outputting them (don't use the -sites option)
Add /transl_table=# (where # is a genetic code number) to sequence comments to use variant genetic codes. If the input file is in FASTA format, put this after each sequence name.
-no_terminal_stop translate terminal stop codons as a gap (with -translate option)
-del_gap_only_sites remove all gap-only sites from alignment (don't use the -sites option)
-def_species_group group_name,group_members create a species group of given name and members (species group members are expressed with their ranks as in this example: 3-8,12,19)
-def_site_selection name,endpoints create a selection of sites of given name and endpoints (site selection endpoints are expressed as in this example: 10-200,305,310-342)
-gblocks create under the name 'Gblocks' a set of blocks of conserved sites with the Gblocks program. Requires the nexus or mase output formats: the output file contains a new site selection called 'Gblocks'. A second command line with -convert -sites Gblocks allows to extract the set of conserved sites identified by Gblocks. Further options can be used to modify the Gblocks run:
-b4 allow smaller final blocks
-b5 allow gaps within final blocks
-b2 less strict flanking positions
-b3 don't allow many contiguous nonconserved positions
-sites selection_name use the named selection of sites from the input alignment
-species group_name use the named group of species from the input alignment
-bootstrap n writes n bootstrap replicates of the input sequence alignment to the output file. Can be combined with the species and sites selection options, -translate (-no_terminal_stop is implied), and -del_gap_only_sites. The -output_format option is not necessary because the output file is always in phylip format.
 
Sub-options for -concatenate
Use '-' as last argument to read alignment from standard input
-concatenate align1,...name(s) of alignment files to add at the end of the input alignment
-by_rankidentify sequences by their rank in alignments, i.e., the 1st seq. of align1 will be added at the end of the 1st seq of the input file, the 2nd with the 2nd, and so on. Without this option, sequences with the same name in alignment files are concatenated.
-record_partition record as 'site sets' the locations of the concatenated pieces in the final concatenate
-output_format fmtformat of the concatenated alignment file (mase, phylip, clustal, msf, fasta, or nexus). Default is the format of the input alignment.
-o fname use fname as name of the concatenated alignment (default is built from input filename)
-o - write the concatenated alignment to standard output
 
Sub-options for -align
Use '-' as last argument to read sequence file from standard input
-align_algo n rank (in seaview, from 0) of alignment algorithm. 0 is clustalo, 1 is muscle. Other algorithms can be used after having been added as external alignment method in seaview. Without this option, seaview's default alignment algorithm is used. This can be changed using seaview's GUI.
-align_extra_args "option1 ..."additional options to use when running the alignment algorithm
-align_at_protein_level input sequences are translated to protein; those protein sequences are aligned; and the resulting alignment is reproduced at the DNA level.
-o fname use fname as name of the output alignment
-o - write the output alignment to standard output
-output_format fmt format of the output alignment (mase, phylip, clustal, msf, fasta, or nexus)
 
Sub-options for -build_tree (either -distance or -parsimony is required and -o or -distance_matrix)
Use '-' as last argument to read alignment from standard input
-o fname use fname as name of the output tree
-o - write the output tree to standard output
-distance dist_name computes the tree with a distance method using the named distance (one among observed, JC, K2P, logdet, Ka, Ks, Poisson or Kimura)
-usertree tree_file_name tree_file_name is the name of a user-given tree file (in Newick format). In association with -distance, branch lengths of the user tree are computed. In association with -parsimony, the length of the tree is computed (and its branch lengths too for DNA sequences).
-distance_matrix fname don't compute the tree, but write to file fname the matrix of pairwise distances
-NJ compute the distance tree by the Neighbor-Joining method (default is BioNJ)
-parsimony compute the tree by the parsimony method
-search more|less|onefor parsimony on DNA only: controls, in decreasing order, how much rearrangement is done to find better trees (more is the default, corresponds to the S option of the dnapars program)
-nogaps remove all gap-containing sites before computations
-replicates n use n bootstrap replicates to compute tree branch support
-jumbles n jumble input sequence order n times (parsimony only)
-gaps_as_unknown encode gaps as unknown character state (parsimony only, by default they are encoded as an extra character state)
-sites selection_name use the named selection of sites from the input alignment
-species group_name use the named group of species from the input alignment
 
Sub-options for -printout (-o is required, available only in seaview versions able to create PDF files)
Use '-' as last argument to read alignment from standard input
-o fname use fname as name of the output PDF/SVG file
-o - send the printout to standard output
-fontsize n font size used for the alignment printout (10 by default)
-blocksize n divide sequences in blocks of size n (10 by default) separated by one space
-svg w produce a file in SVG format of width w pixels (without this option, the output is in PDF format)
-landscape write the alignment in landscape orientation (PDF output only)
-letter write the alignment using Letter-sized pages (A4 by default, PDF output only)
 
Sub-options for -reroot (available only in seaview versions able to create PDF files)
Use '-' as last argument to read input tree from standard input
-outnewick filename write the resulting tree to named file in Newick format
-outgroup name use tree leaf labelled 'name' as tree outgroup
-outgroup "name1,name2,name3" use node at center of the 3 named leaves as tree center and name3-containing clade as outgroup
-ingroup "name1,name2,name3" use node at center of the 3 named leaves as tree center and name1-containing clade as ingroup
-root_at_center reroot the tree at its center
-unroot remove the root from the input tree, if any
-trim trim_rule trim long leaf names using the given trim rule
-patristic_distances fname write to named file patristic distances between leaves of input tree
-remove_bootstrap remove branch support values present in input tree
 
Sub-options for -plotonly (available only in seaview versions able to create PDF files)
options -outgroup, -ingroup, -outnewick above can be used as well as the following ones:
Use '-' as last argument to read tree from standard input
-o fname use fname as name of the output plot (.pdf or .svg)
-o - write the output plot to standard output (svg only)
-svg draw the input tree in a .svg file (default is .pdf file)
-unrooted draw the input tree in unrooted (circular) form
-pagecount n number of pages used for the tree plot (pdf only)
-letter use letter-sized paper for the tree plot
-landscape draw in landscape orientation
-fontsize n font size used in the tree plot
-lengths display branch lengths in the tree plot
-bootstrap display branch support values in the tree plot
-bootstrap_threshold x display branch supports if they are ≥ x
-size WxH pixel Width and Height of tree plot (svg only) (default is 595x842)
-match text display in color (red by default) tree labels containing this text (case is not significant)
-color RRGGBB hexadecimal color used for matching labels (example: 00FF00 means green)
-branch_width_as_support draw plot with branches of increasing widths with increasing support
-support_threshold_high f support above which a branch is drawn with maximal width (def=.95)
-support_threshold_low f support below which a branch is drawn with minimal width (def=.8)
-trim trim_rule trim long leaf names using the given trim rule

Use item "Customize" of menu Props to further customize the program.


Sequence Coloring
The item "Customize" of menu Props allows to control colors.

SETTING DNA/RNA SEQUENCE COLORING
A,C,G,T/U buttons show the colors that are in use for the corresponding nucleotide.
Click on a button to open a color chooser and select the desired color (OK will accept the new choice; reset will use the starting shade).
"reset" will use default colors.
"Apply" or "Set changes permanent" will apply new shades to current alignment.

SETTING PROTEIN SEQUENCE COLORING
aa coloring scheme: by default, amino acids are split in 8 families each displayed in a different color. These families can be customized, up to a maximum of 10. Also, an alternative coloring scheme can be defined, and seaview will allow to switch between the first and the alternative coloring schemes.

catalog of amino acid colors: colors used for each amino acid family. Click on any to control the desired shade, as explained above. White is used for gaps and for unlisted residues.

Example: with the default coloring scheme, groups of amino acids KR and AFILMVW are displayed with the first and second catalog colors starting from left, respectively.

Click "reset" to use default amino acid families and color catalog. "Apply" or "Set changes permanent" to apply new shades to current alignment.

SETTING SYNONYMOUS CODON COLORING
Click on "Change" button. A window with a series of color cells appear. The 21 sets of synonymous codons and of stop codons can be colored with any of these colors. Click on a color cell and type a one-letter amino acid (or * to refer to stop codons) to reaffect a codon set to a new color. Repeat these operations as many times as necessary. Click on "OK" button when color re-assignments are complete.
Back to "Customization" window, "Apply" applies color re-assignments to this session's windows, "Set changes permanent" applies them to future seaview sessions as well.


Miscellaneous options
The item "Customize" of menu Props allows to set these options:
Customization
Note for users of Mac OS 10.9 and above: deleting the file $HOME/Library/Preferences/fr.cnrs.seaview.plist is no longer enough to reset seaview's preferences. You can enter this in a terminal:
defaults delete fr.cnrs.seaview
You may also force using a given fr.cnrs.seaview.plist file with this command:
defaults read fr.cnrs.seaview
Troubleshooting Importation from Databases
If you experience problems importing sequences from databases with the "Import from DBs" item of the File menu, open a terminal (or command prompt) window, and type in it:
telnet pbil.univ-lyon1.fr 5558
If you see this :
OK acnuc socket started
then sequence importation will work.
If the terminal remains blocked for some time and the above OK message does not appear, your communication to the database server is most probably blocked by your firewall. Please, contact your local network administrators, and ask them to allow outbound communications to the port number 5558.