Part 1. Apollo and ApolloRNA installation. TIMING 35 min (Windows), 40 min (Linux) or 45 min (MAC)
1| Download and install Apollo using option A, B or C depending on the operating system.
(A) For Windows
(i) In the directory 'My Documents', create the subdirectory 'Applications'.
(ii) In the directory 'Applications', create the subdirectory 'Apollo'.
(iii) Access the download Apollo page at "http://www.fruitfly.org/annot/apollo/install.html":http://www.fruitfly.org/annot/apollo/install.html.
(iv) In the line 'Windows', in the column 'includes Java VM', right-click the link 'Download'. In the menu, click 'Save link as...' and save the file in the directory 'Apollo'.
(v) Double-click the downloaded file 'install.exe' and follow instructions choosing the 'Apollo' directory as installation directory.
(B) For Linux
(i) Create the directory '~/Applications'.
(ii) In the directory 'Applications', create the subdirectory 'Apollo'.
(iii) Access the download Apollo page at "http://www.fruitfly.org/annot/apollo/install.html":http://www.fruitfly.org/annot/apollo/install.html.
(iv) In the line 'Linux', in the column 'includes Java VM', right-click the link 'Download'. In the menu, click 'Save link as...' and save the file in the directory 'Apollo'.
(v) Open a terminal window and move (with the command 'cd') to the directory 'Apollo'. Type: sh ./apolloinst.bin and follow instructions choosing 'Apollo' for installation directory.
(vi) Configure Apollo for Java. Open a terminal window, move to the directory 'Apollo' and type: pwd. The displayed line is the Apollo path, for instance '/home/dupont/Applications/Apollo'. In the subdirectory 'conf' of the directory 'Apollo', open the file 'apollo.cfg'. Add a line defining the JavaPath variable as the Apollo path extended with '/jre', for instance add the line:
JavaPath =="/home/dupont/Applications/Apollo/jre"==
(C) For Mac
(i) In your user directory, if the directory 'Applications' doesn't exist, create it.
(ii) In the directory 'Applications', create the subdirectory 'Apollo'.
(iii) Access the download Apollo page at "http://www.fruitfly.org/annot/apollo/install.html":http://www.fruitfly.org/annot/apollo/install.html.
(iv) In the line 'Mac OS X', in the column 'without Java VM', right-click the link 'Download'. In the menu, click 'Save link as...' and save the file in the directory 'Apollo'.
(v) Double-click the downloaded file 'install', and follow instructions choosing the 'Apollo' directory as installation directory.
(vi) To be sure Java 1.4 is on your computer, open a terminal window and type: java -version.
If the displayed message starts with 'java version 1.4', go directly to the step 2.
(vii) Access the download Java page at "http://www.apple.com/support/downloads/javaupdate142.html":http://www.apple.com/support/downloads/javaupdate142.html. Click the arrow on the Download line and save the file 'Java142Update2.dmg' in your directory 'Applications'. Double-click 'Java142Update2.dmg' and follow instructions.
(viii) Configure Apollo for Java. Open a terminal window and type: which java. The displayed line is the java executable location, for instance '/usr/bin/java'. In the subdirectory 'conf' of the directory 'Apollo', open the file 'apollo.cfg'. Add a line defining the 'JavaPath' variable to the path before 'bin/java', for example:
**JavaPath** =="/usr/"==
2| Download and install RNAfold (predict minimum energy secondary structures and pair probabilities) and RNAeval (evaluate energy of RNA secondary structures) of the Vienna RNA package2 (programs for RNA Secondary Structure prediction and comparison) using option A or B depending on the operating system.
(A) For Windows
(i) Access the download ViennaRNA package page at "http://www.tbi.univie.ac.at/ivo/RNA/windoze/":http://www.tbi.univie.ac.at/ivo/RNA/windoze/.
(ii) Below 'Download', right-click the 'RNAfold.exe' link and save the file in the directory 'Apollo'.
(iii) Repeat the step (ii) to save the file 'RNAeval.exe'.
(iv) In the taskbar, click 'Start' then chose 'Control Panel'. In the new window, double click on 'System' or if it does not exist on 'Performance and Maintenance' then on 'System'. In the 'System properties' window, click the 'Advanced' tab, click the 'Environment Variables' button to open the environment variables window (Figure 1a).
(v) If the user variable 'Path' exists, select the line of the 'Path' variable, click the 'Edit...' button and add ';' at the end of the value followed by the path of the 'Apollo' directory. For instance, if the path of the 'Apollo' directory is 'C:\dupont\Apollo', add text: ;C:\dupont\Apollo.
Else, if the user variable 'Path' does not exist, click the 'New...' button. A new window (Figure 1b) appears that allows to define a new variable named 'Path' with the path of the 'Apollo' directory for value. For instance, if the path of the 'Apollo' directory is 'C:\dupont\Apollo', the value to be typed is: C:\dupont\Apollo.
(B) For Linux or MAC. CRITICAL STEP with administrator privileges.
(i) Access the Vienna RNA package download page at "http://www.tbi.univie.ac.at/ivo/RNA/":http://www.tbi.univie.ac.at/ivo/RNA/. Click 'source distribution here' link and save the 'ViennaRNA.gz' file in the directory 'Applications'.
(ii) Open a terminal window and move (with the command 'cd') to the directory 'Applications'. To install the Vienna RNA package, type:
**tar xzvf ViennaRNA-1.6.2.tar.gz**
**cd ViennaRNA-1.6.2**
**./configure**
**make**
**make install**
3| Download and install ImageMagick (a software suite to create, edit, and compose bitmap images) using option A or B depending on the operating system. CRITICAL STEP with administrator privileges.
(A) For Windows
(i) Access the download ImageMagick page at "http://www.imagemagick.org/script/binary-releases.php#windows":http://www.imagemagick.org/script/binary-releases.php#windows.
(ii) In the first line, in the 'HTTP' column, right-click the link 'download'. In the menu, click 'Save link as...' and save the file in the directory 'Applications'.
(iii) Double-click the downloaded file 'ImageMagick-6.3.3-10-Q16-windows-dll.exe' and follow instructions.
(B) For Linux or MAC
(i) Access the download ImageMagick page at "http://www.imagemagick.org/script/install-source.php":http://www.imagemagick.org/script/install-source.php.
(ii) Right-click the link 'ImageMagick.tar.gz'. In the menu, click 'Save link as...' and save the file in the directory 'Applications'.
(iii) Open a terminal window and move to the directory 'Applications'. To install ImageMagick, type:
**tar xzvf ImageMagick.tar.gz**
**cd ImageMagick-6.3.1**
**./configure**
**make**
**make install**
4| Download and install GhostScript (an interpreter for the PostScript language and for PDF) using option A or B depending on the operating system. CRITICAL STEP with administrator privileges.
(A) For Windows
(i) In the taskbar, click 'Start' then choose 'Control Panel'. In the new window, click 'Add or Remove Programs'. Look for the program 'Ghostscript 8.56' in the list of programs. If the program belongs to the list, go directly to the step 5.
(ii) Access the download GhostScript page at "http://www.ghostscript.com/awki":http://www.ghostscript.com/awki. Click the link 'sourceforge.net'.
(iii) Right-click the link 'gs856w32.exe'. In the menu, click 'Save link as...' and save the file in the directory 'Applications'.
(iv) Double-click the downloaded file 'gs856w32.exe' and follow the instructions.
(B) For Linux or MAC
(i) Open a terminal window and type: gs -h. If the message 'Command not found' is not displayed, go directly to the step 5.
(ii) Access the download GhostScript page at "http://www.ghostscript.com/awki":http://www.ghostscript.com/awki. Click the link 'sourceforge.net'.
(iii) Right-click the link 'ghostscript-8.56.tar.gz'. In the menu, click 'Save link as...' and save the file in the directory 'Applications'.
(iv) Open a terminal window and move to the directory 'Applications'. To install GhostScript, type:
**tar xzvf ghostscript-8.56.tar.gz**
**cd ghostscript-8.56**
**./configure**
**make**
**make install**
5| Download and install ApolloRNA
(i) In the directory 'Apollo', rename 'apollo.jar' to 'apollo.jar.save'.
(ii) Access the ApolloRNA project page at "http://mulcyber.toulouse.inra.fr/frs/?group_id=47":http://mulcyber.toulouse.inra.fr/frs/?group_id=47. Right-click the link 'apollo.jar'. In the menu, click 'Save link as...' and save the file in the directory 'Apollo'.
[Alert! See author comment below. The correct link is: "http://mulcyber.toulouse.inra.fr/gf/project/apollorna/frs/":http://mulcyber.toulouse.inra.fr/gf/project/apollorna/frs/]
Part 2. Load and visualize data about Pyrococcus abyssi GE5 genome. TIMING 30 min
6| Download Pyrococcus abyssi GE5 GenBank annotations in GAME XML format
(i) Access the ftp NCBI page at "ftp://ftp.ncbi.nih.gov/genomes/Bacteria/Pyrococcus_abyssi":ftp://ftp.ncbi.nih.gov/genomes/Bacteria/Pyrococcus_abyssi. Click the link 'NC_000868.gbk' and copy the whole text.
(ii) Access to the ApolloRNA convert data page at "http://carlit.toulouse.inra.fr/ApolloRNA/convert.html":http://carlit.toulouse.inra.fr/ApolloRNA/convert.html and paste the data in the textarea. In the 'Input format' list, select 'Genbank' and in the 'Output format' list, select 'Game XML'. Click the 'Convert' button.
(iii) Copy the resulting text and paste it in a new file called 'NC_000868.xml'.
7| Download predicted transcription terminator in GAME XML format
(i) Access to the TransTermHP3 page at "http://transterm.cbcb.umd.edu/cgi-bin/transterm/predictions.pl":http://transterm.cbcb.umd.edu/cgi-bin/transterm/predictions.pl and click 'Pyrococcus abyssi GE5'. Copy all the displaying text, except the last part (terminators of the plasmid) starting by the line:
SEQUENCE gi|10954552|ref|NC_001773.1| Pyrococcus abyssi GE5 plasmid pGT5, complete sequence
(ii) Access to the ApolloRNA convert data page and paste the data in the textarea. In the 'Input format' list, select 'TransTermHP', and in the 'Output format' list, select 'Game XML'. In the 'Related genomic sequence coordinates' fields, enter 1 for the beginning and 1765118 for the end. Click the 'Convert' button.
(iii) Copy the resulting text and paste it in a new file called 'NC_000868_TransTermHP.xml'.
8| Visualizing both information
(i) Launch Apollo using option A or B depending on the operating system.
(A) For Windows: In the directory 'Apollo', click the Apollo icon.
(B) For Linux or MAC: Open a terminal window, move to the directory 'Apollo' and type: bin/Apollo.
The Apollo load data window (Figure 1c) appears.
(ii) In the list 'Choose data source', choose 'GAME XML format'. Click the 'Browse...' button: a window appears. Select the file 'NC_000868.xml' and click the 'Open' button. In the Apollo load data window, click the 'Ok' button. When Apollo has loaded data, the Apollo main window appears.
(iii) Open the 'File' menu and click the 'Layer more results or annotations...' item. In the 'Choose data source' list, choose 'GAME XML format'. Click the 'Browse...' button. Select the file 'NC_000868_TransTermHP.xml' and click the 'Open' button. In the Apollo load data window, click the 'Ok' button.
9| Visualizing a predicted secondary structure, example for a tRNA
(i) Click twice on the 'X10' zoom button. The main Apollo window displays both GenBank annotations (in the blue parts) and TransTermHP data (in the black parts) of Pyrococcus abyssi genome. Click the inorganic polyphosphate/ATP-NAD kinase protein annotation to display (Figure 1d) more information about the annotation.
(ii) Open the 'Edit' menu and click the 'Find...' item. A new 'Find' window opens. In the field 'Name', type: PABt04. Click the 'Find' button on the line. The Apollo main view zooms on the tRNA PABt04. Click the 'X.1' zoom button to change scale.
(iii) Open the 'RNA' menu and click the 'Secondary structure compute...' item. A new window (Figure 2a) opens that displays the predicted secondary structure of the tRNA and the associated free energy. Click the 'Close' button.
10| Visualizing possible RNA/RNA interactions, example for the interaction between a sno C/D RNA and the 16S rRNA
(i) In the opened 'Find' window, in the field 'Name', type now: PABsnRNA29. Click the 'Find' button on the line. The Apollo main view zooms on the sno C/D box RNA called 'PABsnRNA29'.
(ii) Now select the subsequence from 1403702 to 1403711 (a subpart of the snoRNA) that is known4 to interact with the 16S rRNA. That is, press the middle mouse button at the position 1403702 immediately above the axis, and drag the mouse to 1403711 surrounding the sequence 'TGTAGCGCGC' (Figure 2b). A window opens that shows the selected sequence. Close it.
(iii) Open the 'RNA' menu and click the 'Search RNA/RNA interaction' item. A window (Figure 2c) opens for configuring the interaction search.
(iv) In the top part of the window, type the genomic positions: 205039 to 206541 (the 16S rRNA positions). In the strand list, choose the strand +.
(v) In the bottom part, click the 'Search' button to launch the search of targets in the specified regions. After a few seconds, a new window (Figure 2d) opens that lists the predicted targets of the previously selected sequence. The first on the list is the good4 one.
(vi) Click the first interaction picture to visualize the interaction in a new window (Figure 2e). Click the 'Close' button and then click the 'Close' button on the previous window.
11| Visualizing graphs
(i) Go to the ApolloRNA page "http://carlit.toulouse.inra.fr/ApolloRNA/apollornauserguide.html":http://carlit.toulouse.inra.fr/ApolloRNA/apollornauserguide.html, click the link 'NC_000868_mfe150.txt' and save the file on your computer. This file contains the minimum free energy computed on a sliding window of 150 nucleotides.
(ii) Open the 'Analysis' menu and click the 'Show quantitative variable...' item. A new window (Figure 3a) opens.
(iii) In the first table of the window, in the first line, click the 'Load...' button. Select the file 'NC_000868_mfe150.txt' and click the 'Open' button. In the column 'Color', click the black rectangle, choose the red color and click the 'OK' button.
(iv) In the second table of the window, in the third line 'ComputeGC%': click the 'Show' checkbox, in the column 'Color', click the black rectangle and choose the blue color. Click the 'OK' button and then click the 'Close' button.
(v) In the yet opened 'Find' window, in the field 'Name', type now: 16S. Click the 'Find' button on the line. Click the 'X.1' zoom button to change scale. Move down the superior vertical scrollbar to see RNA annotations on the direct strand. The Apollo main window (Figure 3b) displays now two additional graphs that vary on the ribosomal RNAs region.