From bd1eda82917c9c886c7a104841fb2e203b1bb1d6 Mon Sep 17 00:00:00 2001 From: Suzanne Duce Date: Fri, 3 Feb 2017 15:58:48 +0000 Subject: [PATCH] Correct a few typos. --- TheJalviewTutorial.tex | 75 +++++++++++++++++++++++++++--------------------- 1 file changed, 43 insertions(+), 32 deletions(-) diff --git a/TheJalviewTutorial.tex b/TheJalviewTutorial.tex index 24cf90a..d0e9457 100644 --- a/TheJalviewTutorial.tex +++ b/TheJalviewTutorial.tex @@ -105,7 +105,7 @@ Manual Version 1.8 % post CLS lifesci course on 15th January % draft. Remaining items are AACon, RNA visualization/editing and Protein disorder analysis exercises. -8th December 2016 +3rd February 2017 \end{center} @@ -169,7 +169,13 @@ visualization of sequence alignments, and their interactive analysis. Tree building, principal components analysis, physico-chemical property conservation and sequence consensus analyses are built into the program. Web services enable Jalview to access online alignment and secondary structure prediction programs, -as well as to retrieve protein and nucleic acid sequences, alignments, protein structures and sequence annotation. Sequences, alignments, trees, structures, features and alignment annotation may also be exchanged with the local filesystem. Multiple visualizations of an alignment may be worked on simultaneously, and the user interface provides a comprehensive set of controls for colouring and layout. Alignment views are dynamically linked with Jmol structure displays, a tree viewer and spatial cluster display, facilitating interactive exploration of the alignment's structure. The application provides its own Jalview project file format in order to store the current state of an alignment and analysis windows. Jalview also provides WYSIWIG\footnote{WYSIWIG: What You See Is What You Get.} style figure generation capabilities for the preparation of alignments for publication. +as well as to retrieve protein and nucleic acid sequences, alignments, protein structures and sequence annotation. +Sequences, alignments, trees, structures, features and alignment annotation may also be exchanged with the local filesystem. +Multiple visualizations of an alignment may be worked on simultaneously, and the user interface provides a comprehensive set of controls for colouring and layout. +Alignment views are dynamically linked with Jmol and Chimera structure displays, +a tree viewer and spatial cluster display, facilitating interactive exploration of the alignment's structure. The application provides its own Jalview project file format in order +to store the current state of an alignment and analysis windows. Jalview also provides WYSIWIG\footnote{WYSIWIG: What You See Is What You Get.} style + figure generation capabilities for the preparation of alignments for publication. \begin{figure}[htbp] \begin{center} \includegraphics[width=5.8in]{images/jvcapabilities.pdf} @@ -209,7 +215,7 @@ Jalview Java alignment editor"} \newline Michele Clamp, James Cuff, Stephen M. S \subsection{About this Tutorial } This tutorial is written in a manual format with short exercises where -appropriate, typically at the end of each section. This chapter concerns the +appropriate, typically at the end of each section. This concerns the basic operation of Jalview and should be sufficient for those who want to launch Jalview (Section \ref{startingjv}), open an alignment (Section \ref{loadingseqs}), perform basic editing (Section @@ -218,12 +224,13 @@ publication and presentation quality graphical output (Section \ref{layoutandout In addition, the manual covers the additional visualization and analysis techniques available in Jalview. This includes working -with the embedded Jmol molecular structure viewer, building and viewing trees and PCA -plots, and using trees for sequence conservation analysis. An overview of +with the embedded Jmol molecular structure viewer and opening Chimera, building +and viewing trees and PCA plots, and using trees for sequence conservation analysis. An overview of the Jalview Desktop's webservices is given in Section \ref{jvwebservices}, and the alignment and secondary structure prediction services are described -in detail in Sections \ref{msaservices} and \ref{protsspredservices}. Section \ref{featannot} details the creation and visualization of sequence -and alignment annotation. Section \ref{workingwithnuc} discusses +in detail in Sections \ref{msaservices} and \ref{protsspredservices} +respectively. +Section \ref{featannot} details the creation and visualization of sequence and alignment annotation. Section \ref{workingwithnuc} discusses specific features of use when working with nucleic acid sequences, such as translation and linking to protein coding regions, and the display and analysis of RNA secondary structure. @@ -308,7 +315,7 @@ When Jalview starts it will automatically load an example alignment from the Jalview site. This behaviour can be switched off in the Jalview Desktop preferences dialog by unchecking the open file option. This alignment will look like the one in Figure \ref{startpage} (taken -from Jalview version 2.7). +from Jalview version 2.10.1). %[figure 3 ] \begin{figure}[htbp] @@ -419,7 +426,7 @@ The major features of the Jalview Desktop are illustrated in Figure \ref{anatomy where editing and navigation are performed using the keyboard. The {\bf F2 key} is used to switch between these two modes. With a Mac as the F2 is often assigned to screen brightness, one may often need to type {\bf function - [Fn] key with F2} function + [Fn] key with F2 key} [Fn]-F2. \begin{figure}[htb] @@ -488,7 +495,7 @@ the arrow keys ($\uparrow$, $\downarrow$, $\leftarrow$, $\rightarrow$). Rapid movement to specific positions is accomplished as listed below: \begin{list}{$\circ$}{} \item {\bf Jump to Sequence {\sl n}:} Type a number {\sl n} then press [S] to -move to sequence (row). {\sl n} +move to sequence (row) {\sl n}. \item {\bf Jump to Column {\sl n}:} Type a number {\sl n} then press [C] to move to column {\sl n} in the alignment. \item {\bf Jump to Residue {\sl n}:} Type a number {\sl n} then press [P] to move to residue number {\sl n} in the current sequence. \item {\bf Jump to column {\sl m} row {\sl n}:} Type the column number {\sl m}, a comma, the row number {\sl n} and press [RETURN]. @@ -614,7 +621,7 @@ do this. One is to right-click on the desktop background, and select the `Paste to new window' option in the menu that appears. The other is to select {\sl File $\Rightarrow$ Input Alignment $\Rightarrow$ From Textbox} from the main menu, paste the sequences into the text window that will appear, and select -{sl New Window} (Figure \ref{loadtext}). In both cases, presuming that they are +{\sl New Window} (Figure \ref{loadtext}). In both cases, presuming that they are in the right format, Jalview will happily read them into a new alignment window. %[fig 8] @@ -1002,8 +1009,8 @@ The current selection can be copied to the clipboard (in PFAM format). It can also be output to a textbox using the output functions in the pop-up menu obtained by right clicking the current selection. The textbox enables quick manual editing of the alignment prior to importing it into a new window (using -the [New Window] button) or saving to a file with the {\sl File $\Rightarrow$ -Save As } pulldown menu option from the text box. +the {\sl New Window} button) or saving to a file with the {\sl File +$\Rightarrow$ Save As } pulldown menu option from the text box. \section{Reordering an Alignment} Sequence reordering is simple. Highlight the sequences to be moved then press the up or down arrow keys as appropriate (Figure \ref{reorder}). If you wish to move a sequence up past several other sequences it is often quicker to select the group past which you want to move it and then move the group rather than the individual sequence. @@ -1773,8 +1780,8 @@ Conversely, sequence features are properties of the individual sequences, so the but are shown mapped on to specific residues within the alignment. Features and annotation can be interactively created, or retrieved from external -data sources. Webservices like JNet (see \ref{jpred} above) can be used to analyse a -given sequence or alignment and generate annotation for it. +data sources. Webservices like JPred (see \ref{jpred} above) can be used to +analyse a given sequence or alignment and generate annotation for it. \section{Conservation, Quality and Consensus Annotation} @@ -2020,8 +2027,8 @@ then you may be asked if you wish to retrieve Uniprot IDs for your sequence. Pre If a sequence is verified, then the start/end numbering will be adjusted to match the Uniprot record. \subsubsection{Rate of Feature Retrieval} -Feature retrieval can take some time if a large number of sources is selected and if the alignment -contains a large number of sequences. +Feature retrieval can take some time if a large number of sources are selected +and if the alignment contains a large number of sequences. As features are retrieved, they are immediately added to the current alignment view. The retrieved features are shown on the sequence and can be customised as described previously. @@ -2233,7 +2240,7 @@ Omega. Sievers F, Wilm A, Dineen DG, Gibson TJ, Karplus K, Li W, Lopez R, McWilliam H, Remmert M, Soding J, Thompson JD, Higgins DG (2011) {\sl Molecular Systems Biology} {\bf 7} 539 \href{http://dx.doi.org/10.1038/msb.2011.75}{doi:10.1038/msb.2011.75}} Of these, -T-COFFEE is slow but the accurate. ClustalW is historically +T-COFFEE is slow but accurate. ClustalW is historically the most widely used. Muscle is fast and probably best for smaller alignments. MAFFT is probably the best for large alignments, however Clustal Omega, released in 2011, is arguably the fastest and most @@ -2589,7 +2596,7 @@ region or the whole alignment, excluding any hidden regions. On calculating a tree, a new window opens (Figure \ref{trees1}) which contains the tree. Various display settings can be found in the tree window {\sl View} -menu, including font, scaling and label display options, and the {\sl File +menu, including font, scaling and label display options. The {\sl File $\Rightarrow$ Save As} submenu contains options for image and Newick file export. Newick format is a standard file format for trees which allows them to be exported to other programs. Jalview can also read in external trees in @@ -2930,7 +2937,7 @@ Databank (PDBe) using the Sequence Fetcher (see \ref{fetchseq}). \subsection{Configuring the default structure viewer} \label{configuring3dviewer} -To configure which one is used when creating a new +To configure which viewer is used when creating a new structure view, open the Structures preferences window {\sl via} {\sl Tools $\Rightarrow$ Preferences\ldots} and select either JMOL or CHIMERA as the default viewer. If you select Chimera, Jalview will search for the installed program, and if it cannot be found, @@ -2947,10 +2954,12 @@ Structure Chooser. When the structure chooser is first opened, if no database identifiers are available, Jalview will attempt to discover identifiers for the sequence and from there discover any associated PDB structures. This can take a few seconds for each sequence and -while be performed for all selected sequences. After this is done, you can see -added database references in a tool tip by mousing over the sequence ID. -\footnote{Tip: -The sequence ID tooltip can often become large for heavily cross referenced sequence IDs. Use the {\sl View $\Rightarrow$ Sequence ID Tooltip $\Rightarrow$ } submenu to disable the display of database cross references or non-positional features. } now shows the Uniprot ID and any associated PDB structures. +will be performed for all selected sequences. After this is done, you can see +the added database references in a tool tip by mousing over the sequence +ID\footnote{Tip: +The sequence ID tooltip can often become large for heavily cross referenced sequence IDs. Use the {\sl View $\Rightarrow$ Sequence ID Tooltip $\Rightarrow$ } +submenu to disable the display of database cross references or non-positional +features. }, now shows the Uniprot ID and any associated PDB structures. % % \begin{figure}[htbp] % \begin{center} @@ -3070,7 +3079,7 @@ alignment using the {\sl Colours $\Rightarrow$ By Sequence } option. The image in the structure viewer can be saved as an EPS or PNG with the {\sl File $\Rightarrow$ Save As $\Rightarrow$ \ldots} submenu, which also allows the raw data to be saved as PDB format. The mapping between the structure and the -sequence (How well and which parts of the structure relate to the sequence) can +sequence (how well and which parts of the structure relate to the sequence) can be viewed with the {\sl File $\Rightarrow$ View Mapping} menu option. \subsubsection{Using the Jmol Visualization Interface } @@ -3457,7 +3466,7 @@ prediction on the first sequence in the set (that is, the one that appears first Jpred is launched in the same way as the other web services. Select {\sl Web -Service $\Rightarrow$ Secondary Structure Prediction $\Rightarrow$ JNet +Service $\Rightarrow$ Secondary Structure Prediction $\Rightarrow$ JPred Secondary Structure Prediction}\footnote{JNet is the Neural Network based secondary structure prediction method that the JPred server uses.} from the alignment window menu (Figure \ref{jpred}). @@ -3487,15 +3496,17 @@ The Annotations dropdown menu on the alignment wndow also provides options for reording and hiding autocalculated and sequence associated annotation. } \exstep{ Open the alignment at \url{http://www.jalview.org/tutorial/alignment.fa}. Select the sequence {\sl FER\_MESCR} by -clicking on the sequence ID. Then select {\sl Web Service $\Rightarrow$ Secondary Structure Prediction $\Rightarrow$ JNet Secondary Structure Prediction} -from the alignment window menu. A status window will appear and after some time (about 2-4 min) a new window with the JPred prediction will appear. +clicking on the sequence ID. Then select {\sl Web Service $\Rightarrow$ +Secondary Structure Prediction $\Rightarrow$ JPred Secondary Structure +Prediction} from the alignment window menu. A status window will appear and after some time (about 2-4 min) a new window with the JPred prediction will appear. Note that the number of sequences in the results window is many more than in the original alignment as -JNet performs a PSI-BLAST search to expand the prediction dataset. The results -from the prediction are visible in the annotation panel. Jnet secondary +JPred performs a PSI-BLAST search to expand the prediction dataset. The results +from the prediction are visible in the annotation panel. JPred secondary structure prediction annotations are examples of sequence-associated alignment annotation. } % TODO: check how long this takes - about 2 mins once it gets on the cluster. \exstep{ -Select a different sequence and perform a JNet prediction in the same way. There will probably be minor differences in the predictions. +Select a different sequence and perform a JPred prediction in the same way. +There will probably be minor differences in the predictions. } \exstep{ Select the sequence used in the second sequence prediction by clicking on its @@ -3521,7 +3532,7 @@ sequences, then open the {\sl Sequence ID $\Rightarrow$ Selection } submenu by right clicking the mouse to open the context menu, and select the {\sl Add Reference Annotation} option. -{\bf All} the JNet predictions for the sequences will now be visible in the +{\bf All} the JPred predictions for the sequences will now be visible in the original alignment window.} {\bf Homework:} Go back to the last step of exercise \ref{annotatingalignex} and -- 1.7.10.2