Correct a few typos.
authorSuzanne Duce <sduce@issues.jalview.org>
Fri, 3 Feb 2017 15:58:48 +0000 (15:58 +0000)
committerSuzanne Duce <sduce@issues.jalview.org>
Fri, 3 Feb 2017 15:58:48 +0000 (15:58 +0000)
TheJalviewTutorial.tex

index 24cf90a..d0e9457 100644 (file)
@@ -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