+Alignment consensus annotation reflects the percentage of the different residue
+per column. By default this calculation includes gaps in columns, gaps can be ignored via the Consensus label context
+menu to the left of the consensus bar chart.
+The consensus histogram can be overlaid
+with a sequence logo that reflects the symbol distribution at each column of
+the alignment. Right click on the Consensus annotation row and select the {\sl Show
+Logo} option to display the Consensus profile for the group or alignment.
+Sequence logos can be enabled by default for all new alignments {\sl via} the
+Visual tab in the Jalview desktop's preferences dialog box.
+
+\subsubsection{Quality Annotation}
+
+Alignment quality annotation is an ad-hoc measure of the likelihood of observing
+the mutations (if any) in a particular column of the alignment. The quality score is calculated for each column in an alignment by summing,
+for all mutations, the ratio of the two BLOSUM 62 scores for a mutation pair and each residue's conserved BLOSUM62 score (which is higher).
+This value is normalised for each column, and then plotted on a scale from 0 to 1.
+
+\subsubsection{Occupancy Annotation}
+
+Alignment occupancy simply reflects the number of residues aligned at each column
+in the multiple sequence alignment. To see this annotation you may first need to enable it by ticking the {\sl Occupancy} check-box
+in the {\sl Visual} tab in Jalview's {\sl Preferences} before opening an alignment. Occupancy is particularly useful in conjunction with
+the {\sl Select/Hide by Annotations} dialog since it allows the view to be filtered to exclude regions of the alignment with a high proportion of gaps.
+
+\subsubsection{Group Associated Annotation}
+\label{groupassocannotation}
+Group associated consensus and conservation annotation rows reflect the
+sequence variation within a particular group. Their calculation is enabled
+by selecting the {\sl Group Conservation} or {\sl Group Consensus} options in
+the {\sl Annotation $\Rightarrow$ Autocalculated Annotation } submenu of the
+alignment window.
+
+\subsection{Creating User Defined Annotation}
+
+To create a new annotation row, right click on the annotation label panel and select the {\sl Add New Row} menu option (Figure \ref{newannotrow}).
+A dialog box appears. Enter the label to use for this row and a new row will appear.
+
+To create a new annotation, first select all the positions to be annotated on the appropriate row.
+Right-clicking on this selection brings up the context menu which allows the insertion of graphics for secondary structure ({\sl Helix} or {\sl Sheet}),
+text {\sl Label} and the colour in which to present the annotation (Figure \ref{newannot}). On selecting {\sl Label} a dialog box will appear,
+requesting the text to place at that position. After the text is entered, the selection can be removed and the annotation becomes clearly
+visible\footnote{When annotating a block of positions, the text can be partly obscured by the selection highlight. Pressing the [ESC] key clears
+the selection and the label is then visible.}. Annotations can be coloured or deleted as desired.
+
+\begin{figure}[htbp]
+\begin{center}
+\includegraphics[width=1.3in]{images/annots1.pdf}
+\includegraphics[width=2in]{images/annots2.pdf}
+\caption{{\bf Creating a new annotation row.} Annotation rows can be reordered by dragging them to the desired place.}
+\label{newannotrow}
+\end{center}
+\end{figure}
+
+\begin{figure}[htbp]
+\begin{center}
+\includegraphics[width=2in]{images/annots3.pdf}
+\includegraphics[width=2in]{images/annots4.pdf}
+\includegraphics[width=2in]{images/annots5.pdf}
+\caption{{\bf Creating a new annotation.} Annotations are created from a selection on the annotation row and can be coloured as desired.}
+\label{newannot}
+\end{center}
+\end{figure}
+
+\subsection{Automated Annotation of Alignments and Groups}
+
+On loading a sequence alignment, Jalview will normally\footnote{Automatic
+annotation can be turned off in the {\sl Visual } tab in the {\sl Tools
+$\Rightarrow$ Preferences } dialog box.} calculate a set of automatic annotation
+rows which are shown below the alignment. For nucleotide sequence alignments,
+only an alignment consensus row will be shown, but for amino acid sequences,
+alignment quality (based on BLOSUM 62) and physicochemical conservation will
+also be shown. Conservation is calculated according to Livingstone and
+Barton\footnote{{\sl ``Protein Sequence Alignments: A Strategy for the
+Hierarchical Analysis of Residue Conservation." } Livingstone C.D. and Barton
+G.J. (1993) {\sl CABIOS } {\bf 9}, 745-756}.
+Consensus is the modal residue (or {\tt +} where there is an equal top residue).
+The inclusion of gaps in the consensus calculation can be toggled by
+right-clicking on the Consensus label and selecting {\sl Ignore Gaps in
+Consensus} from the pop-up context menu located with consensus annotation row.
+Quality is a measure of the inverse likelihood of unfavourable mutations in the alignment. Further details on these
+calculations can be found in the on-line documentation.
+
+
+\exercise{Annotating Alignments}{
+ \label{annotatingalignex}
+\exstep{Load the alignment at \textsf{http://www.jalview.org/tutorial/alignment.fa}.
+Right-click on the label name of the {\sl Conservation} annotation row to
+bring up the context menu and select {\sl Add New Row}. A dialog box will
+appear asking for {\sl Annotation Name} and {\sl Annotation Description}.
+Enter "Iron binding site" and click {\sl OK}. A new, empty, row appears.
+}
+\exstep{
+Navigate to column 97. Move down and on the new annotation row called
+"Iron binding site", select column 97.
+Right click at this selection and select {\sl Label} from the context menu.
+Enter "Fe" in the box and click {\sl OK}. Right-click on the selection again
+and select {\sl Colour}.
+Choose a colour from the colour chooser dialog
+and click {\sl OK}. Press [ESC] to remove the selection.
+
+{\sl Note: depending on your Annotation sort settings, your newly
+created annotation row might "jump" to the top or bottom of the annotation
+panel. Just scroll up or down to find it again - the column you marked will
+still be selected. }
+
+}
+\exstep{ Select columns 70-77 on the annotation row. Right-click and choose {\sl Sheet} from the
+ context menu. You will be prompted for a label. Enter "B" and press {\sl OK}. A new line showing the
+ sheet as an arrow appears. The colour of the label can be changed but not the colour of the sheet
+ arrow.
+}
+\exstep{Right click on the title text in the annotation row that you just
+created.
+Select {\sl Export Annotation} in context menu and, in the Export Annotation
+dialog box that will open, select the Jalview format and click the {\sl [To Textbox]} button.
+(The format for this file is given in the Jalview help. Press [F1] to open it ([F1]-[Fn] (Mac)),
+and find the "Annotations File Format" entry in the "Alignment Annotations" section of the contents
+pane.) }
+
+\exstep{Open a text editor and copy the annotation text into the editor.
+Edit the text by changing the name of the annotation row and save the file.}
+\exstep{Drag the file onto the alignment in Jalview and check the annotation
+panel.} \exstep{Return to the text editor, add an additional helix somewhere
+along the row, save the file and re-importing it into Jalview as previously.
+{\sl Hint: Use the Export Annotation function to view what helix annotation looks like in
+a Jalview annotation file.}}
+\exstep{In the alignment window menu, select {\sl File $\Rightarrow$ Export Annotations...}
+to export all the alignment's annotation to a file. Save the file.}
+\exstep{Open the exported annotation in a text editor, and use the Annotation File Format
+documentation to modify the style of the Conservation, Consensus and Quality annotation rows so
+they appear as several lines on a single line graph.
+{\sl Hint: You need to change the style of annotation row in the first field of the annotation
+row entry in the file. Create an annotation row grouping to overlay the
+three quantitative annotation rows.}
+}
+\exstep{{\bf Homework once you have completed exercise
+\ref{secstrpredex}:}
+\label{viewannotfileex}
+
+Recover or recreate the secondary structure predictions that you made from
+JPred. Use the {\sl File $\Rightarrow$ Export Annotation} function to view the Jnet secondary structure prediction annotation row.
+Note: the
+SEQUENCE\_REF statements surrounding the row specifying the sequence association for the
+annotation.
+}
+\bf See the video at:
+\url{http://www.jalview.org/training/Training-Videos}.}
+
+
+\section{Sequence Features}
+Sequence features are annotation associated with a specific sequence - often marking a specific region, such as a domain or binding site. Jalview allows features to be created simply by selecting the area in a sequence (or sequences) to form the feature and selecting {\sl Selection $\Rightarrow$ Create Sequence Feature } from the right-click context menu (Figure \ref{features}). A dialog box allows the user to customise the feature with respect to name, group, and colour. The feature is then associated with the sequence. Moving the mouse over a residue associated with a feature brings up a tool tip listing all features associated with the residue.
+
+\begin{figure}[htbp]
+\begin{center}
+\includegraphics[width=2in]{images/feature1.pdf}
+\includegraphics[width=2.5in]{images/feature2.pdf}
+\includegraphics[width=1.5in]{images/feature3.pdf}
+\caption{{\bf Creating sequence features.} Features can readily be created from selections via the context menu and are then displayed on the sequence. }
+\label{features}
+\end{center}
+\end{figure}
+
+Creation of features from a selection spanning multiple sequences results in the creation of one feature per sequence.
+Each feature remains associated with its own sequence.
+
+%%TODO: change EMBL to ENA in Jalview and the Manual !
+
+\section{Importing Features from Databases}
+\label{featuresfromdb}
+Jalview supports feature retrieval from public databases.
+It includes built in parsers for Uniprot, Ensembl and ENA (or EMBL) records retrieved
+from the EBI. Sequences retrieved from these sources using the sequence fetcher (see
+Section \ref{fetchseq}) will already possess features.
+
+
+\begin{figure}[htbp]
+\begin{center}
+\includegraphics[width=4in]{images/features4.pdf}
+\caption{{\bf Multiple sequence features.} An alignment with JPred secondary structure prediction annotation below it, and many sequence features overlaid onto the aligned sequences. The tooltip lists the features annotating the residue below the mouse-pointer.}
+\end{center}
+\end{figure}
+
+
+\subsection{Sequence Database Reference Retrieval}
+\label{fetchdbrefs}
+Jalview maintains a list of external database references for each sequence in
+an alignment. These are listed in a tooltip when the mouse is moved over the
+sequence ID when the {\sl View $\Rightarrow$ Sequence ID Tooltip $\Rightarrow$
+Show Database Refs } option is enabled. Sequences retrieved using the sequence
+fetcher will always have at least one database reference, but alignments
+imported from an alignment file generally have no database references.
+
+\subsubsection{Database References and Sequence Coordinate Systems}
+
+Jalview displays features in the local sequence's coordinate system which is
+given by its `start' and `end'. Any sequence features on the sequence will be
+rendered relative to the sequence's start position. If the start/end positions
+do not match the coordinate system from which the features were defined, then
+the features will be displayed incorrectly.
+
+\subsubsection{Viewing and Exporting a Sequence's Database Annotation}
+
+You can export all the database cross references and annotation terms shown in
+the sequence ID tooltip for a sequence by right-clicking and selecting the {\sl
+[Sequence ID] $\Rightarrow$ Sequence Details} option from the popup
+menu.
+A similar option is provided in the {\sl Selection} sub-menu allowing you to
+obtain annotation for the sequences currently selected.
+
+\parbox[l]{3.4in}{
+The {\sl Sequence Details
+\ldots} option will open a window containing the same text as would be shown in
+the tooltip window, including any web links associated with the sequence. The
+text is HTML, and options on the window allow the raw code to be copied and
+pasted into a web page.}
+\parbox[c]{3in}{
+\centerline{\includegraphics[width=2.2in]{images/seqdetailsreport.pdf}}}