Subsections


5 Menus Description

This chapter describes all the Ordalie menus. Only the entries which have not been already explained in this manual will be described in details here.

5.1 The File Menu

5.1.1 Open

Opens an alignment file. Several file formats are recognized:

A format checking is done using the file extension (. tfa/. fasta, .msf, .xml, .rsf, .aln or. ord recognized) against the file content. In case of inconsistency, the user will be asked for the correct file format.

5.1.2 Save

Save the entire current snapshot in the current file format with the current file name. The first time 'Save' is invoked, the user will be prompted to enter a file name. Subsequent call too “Save” will save the snapshot using the defined name and file format.

5.1.3 Save As ...

Ask for a file format and a file name to save the current snapshot. If there are selected sequences, the user is asked to save all sequences or the selected ones.

5.1.4 Save Window As

Save only the visible part of the snapshot in the specified file format and file name.

5.1.5 Close

Close all snapshots and all dependencies (Overview, 3D Viewer... ), and set Ordalie ready to load a new file.

5.1.6 Print

When the 'Print' option is invoked, a 'Setup' properties window will pop up. Several printing parameters can be set:

5.1.7 Quit Ordalie

Guess...

5.2 The Edit Menu

5.2.1 Cut

Cut the selected sequences.

5.2.2 Copy

Copy the selected sequences into the memory buffer.

5.2.3 Paste

Paste the sequences present in the memory buffer. The sequences are pasted just below the current selected sequence. If no sequence is selected, then no sequences are pasted. Note that in case of pasting sequences that already exist in the snapshot, their names will be suffixed by '__<n>' where '<n>' is the copy number.

5.2.4 Preferences

Access the 'Preferences' panel. This gives access to Ordalie internals.

5.3 The View Menu

5.3.1 Bigger font

Increases the font size for sequence display. The Ordalie default font type and size can be defined through 'Edit' -> 'Preferences' -> 'General'.

5.3.2 Smaller font

Decreases the font size for sequence display.

5.3.3 Open Log Console

Most of Ordalie information and computations are logged. The Log window allows accessing the crude log text and to save it as a raw text file.

5.3.4 Output Log as ...

This will output the whole Ordalie lo in a file. A cascade menu allows selecting between an HTML or Text format. The output file name is the root name of the original alignment file suffixed by the format type.

5.3.5 Toggle Full Screen

Toggles the main window between its actual size and full screen size. This can also be achieved by hitting the <F1> key on the keyboard.

5.3.6 Show/Hide Icon Bar

Displays or hides the Icon bar buttons frame. This is useful when a maximal window size is required, for alignment editing for example.

5.3.7 Show/Hide Scores

This turns on and off the scores frame. When displaying a conservation score, either through the Features buttons or inside the 'Conservation' tool, the global score and groups scores for each column is plotted. By default, the Score frame is turned off.

5.3.8 Show/Hide Features frame

This turns on and off the Features frame. This is useful when a maximal window size is required, for alignment editing for example.

5.3.9 Show/Hide Phylum

If the “life domain” characteristic information is available for the sequences, then the sequence names are coloured according to their life domain : eukaryots in red, archaea in blue, bacteria in yellow, and viruses in black.

5.3.10 Show/Hide groups colours

Colours the sequences according to their groups.

5.3.11 Show/Hide sec. Str.

If the secondary structures are available, show or hide -helices (red) and -strands (green).

5.4 The Sequence Menu

5.4.1 Names as

In Ordalie, there are several ways to display sequences names:

By default, the Sequence Name is displayed.

In Macsims/Xml and Ordalie file formats, the Sequence Name, Accession Number and Bank ID are clearly identified for each sequence. For all other formats, there is only one ID per sequence, and this one will be taken as the sequence name, accession number and bank ID.

5.4.2 Identity tool

Launches the Identity tool, see 4.3.

5.4.3 Search motif

Launches the Search motif tool, see 4.4.


5.4.4 Retrieve Seq. Info.

This command is intended to retrieve information for some sequences by querying their original databases. When invoked a window appears asking if all sequences or only the selected ones should be treated. After pressing “OK” Ordalie will query the database to which the sequences belong to and retrieve corresponding information. If some amino acid sequences have changed, they will be immediately realigned against the other sequences with the MAFFT program. Once terminated a summary window appears showing the number of updates that occurred for Accession, Phylum, Taxa ID, Organism, Description and the amino acid sequence. Below the changes table the “Show details...” button launches a web page with the detailed changes that occurred for each sequence.


5.4.5 Edit Info Seq

Enters the sequence information edit tool. This tool gives access to all information available for a given sequence, and allows modifying some of them.

At the top of the “Edit Info. Seq.” window a combobox allows selecting the desired sequence.

5.4.6 Features Editor

Launches the Features Editor tool, see 4.10.

5.4.7 Add feature from file

Opens a file dialogue asking for a feature file. The loaded features are immediately available in Ordalie. The feature file format is described in Appendix 6.4.

5.4.8 Features Summary

Launches the Feature Summary tool, see 4.11

5.4.9 Add in snapshot

This item triggers a menu allowing to add sequences or PDB from files or database. Choices are:

Depending on the choice a dedicated window pops up with corresponding fields to be filled. Figure 17 shows the window for adding sequences from file.

Figure 17: The window corresponding to adding sequences from file
Image windowaddseq

After specifying a file, PDB ID or accession numbers, the user should select whether:

After sequences have been added, features positions are recomputed if needed, and basics sequences characteristics are computed for the new sequences (isoelectric point, molecular weight, identity, composition, ...) and are logged.

5.5 The Alignment Menu

5.5.1 Editor

Launches the Editor tool, see 4.2.

5.5.2 Re-Align sequences

Re-aligns the selected sequences by using the MAFFT program [7,6,5,8]. The selected sequences are first degapped and then re-aligned against the remaining sequences. The re-aligned sequences stay at their original place.

5.5.3 Clustering

Launches the Clustering tool, see 4.5.

5.5.4 Add separator

In Ordalie a “separator” is simply a blank line between sequences. Adding separator allow the user to create his own clusters. This command will add a blank line separator just below the selected sequence. Be aware that only one sequence should be selected.

5.5.5 Remove Separator

Removes the separator just below the selected sequence. Be aware that only one sequence should be selected.

5.5.6 Remove All separators

Removes all separators, and unselects all sequences. This results in an unclustered snapshot.

5.5.7 Overview

Creates an instance of the Overview Window for the current snapshot, see “Snapshot Overview” section 4.1.

5.5.8 Conservation

Launches Conservation computation tool, see 4.7.

5.5.9 Tree building

Launches the Tree tool, see 4.6.

5.5.10 Annotate snapshot

Launches the Annotation tool, see 4.12.

5.5.11 Barcode

Launches the Barcode tool, see 4.13.

5.5.12 Features Editor

Launches the feature editor, see 4.10.

5.5.13 Features Summary

Launches the 'Features Summary' tool, see 4.11. Sequences selected in the main window will automatically be selected in the 'Features Summary' tool.

5.5.14 Toggle physicochem. col.

Toggle the colouring of residues with the same mapping as in the 'Editor'.

5.6 The Structure Menu

5.6.1 Superpose Structures

Launches the 'Superposition' tool if several PDB structures are available in the snapshot, see 4.8.

5.6.2 Display Structures

Launches the '3D Viewer' tool, see 4.9.

5.6.3 Colour Sec. Str. by identity

This tool allows colouring the secondary structures according to their sequence identity level in the snapshot. When invoked, a parameter window will pop up with the following parameters to select:

5.6.4 Save PDB

As the 3D structures may be changed using the 'Superposition' tool, this option allows saving a given 3D structure present in the snapshot. It may be useful to output the superposed structures in order to render them in a more sophisticated drawing program.

When invoked, a window will pop up to ask the user for some parameters:

5.7 The "?" Menu

5.7.1 About

This menu item pops up a window giving some information about Ordalie, such as the currently used version, and the URL for the Ordalie home page.

5.8 Help

5.8.1 Local Ordalie documentation

Launches this manual on the default web browser using local version.

5.8.2 On-line documentation

Launches the Ordalie documentation on a web browser using Ordalie website.