ILRI Research Computing

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== Interactive Display for Evolutionary Analyses =====

IDEA (Interactive Display for Evolutionary Analyses) is a graphical interface for PAML (Yang, Z., 1997), a popular package for conducting molecular evolution analyses on phylogenies and associated sequences.

http://ideanalyses.sourceforge.net/

===== Installation =====

These notes were made when the HPC was running Rocks 4.1, so they may or may not work the same way after the cluster is upgraded to Rocks 5.2.  You may find want to make sure the pre-requisites are installed before going on.  The IDEA website has documentation but the installation literature is VERY limited!  The documentation for downloading and installing is on IDEA's sourceforge website [[http://ideanalyses.sourceforge.net/download_idea.html#sysreq|here]].

<note warning>For whatever reasons, the installer is a bit picky, so **don't run it as root**!  We "install" it in a regular user's home folder first, and then move it to another location where other users can use it.  Remember, don't use ''sudo'' to run the installer script!</note>

Unpack the archive into a new folder:
  * <code>$ mkdir idea
$ cd idea
$ tar zxf ../idea-2.4.4.tar.gz
$ ls
apache-batik                docs                      idea_gene_template_user_tree.xml        #install-idea.pl#  log4j.properties  source
CheckAvailableMemory.class  external-docs             idea_gene_template.xml                  install-idea.pl    Logger.pm         ss.convert-svg-files.pl
CheckAvailableMemory.java   idea                      idea_local_gene_template_user_tree.xml  jars               newickDraw        ss.make-idea-svg-graphs.pl
check-java-memory           idea-A-create-tree.pl     idea_local_gene_template.xml            jdic               pdfbox            verify-java
commons-io                  idea-B-run-paml.pl        idea_local_template.xml                 jdic-linux64       README            wf
DEFAULT-BASEML.ctl          idea-C-merge-runs.pl      idea_template.xml                       jdic_stub.jar      RST.pm            Workflow
DEFAULT-CODEML.ctl          idea_config_skeleton.ini  install-idea                            jruby              rubylib           xstream
delete-old-event-logs       idea-D-parse-output.pl    install-idea.bash                       LICENSE            SeqGraph</code>
Run the installer:
  * <code>$ ./install-idea 
Checking for required Perl modules...
Unpacking wf-3.1.1.tar.gz...
Using grid type sge!
Configuring Workflow...
Unpacking jruby-bin-1.0.0RC1.tar.gz...
Checking for required PHYLIP programs...
Checking for required PAML programs...
Checking for other required programs...
Unpacking PDFBox-0.7.2.zip...
Unpacking jdic-20060613-bin-cross-platform.zip...
Unpacking xstream-distribution-1.2.1-src.zip...
Configuring IDEA...
Compiling...
Congratulations!  You have successfully installed IDEA.
You may find it convenient to add /export/home/alan/idea to your path for easy access to IDEA.

SGE event logs will be stored in /export/home/alan/idea/wf/event-logs.
This directory should be cleaned out periodically.
The script delete-old-event-logs may be used for this purpose.

NOTICE TO SGE (SUN GRID ENGINE) USERS:
======================================
IDEA uses the Workflow process management system to manage grid submissions.
In order to work with SGE, Workflow requires the following set-up by a grid administrator:
The scripts /export/home/alan/idea/wf/bin/prolog_uninitialized and /export/home/alan/idea/wf/bin/epilog_uninitialized must be installed as prolog and epilog, respectively, on every queue on which Workflow jobs will be executed.

Grid submissions have been temporarily disabled.
You may still use IDEA, but all processes will be executed on the machine from which you launch IDEA.

Once an administrator has installed these scripts, rename /export/home/alan/idea/wf/bin/prolog_uninitialized to /export/home/alan/idea/wf/bin/prolog and /export/home/alan/idea/wf/bin/epilog_uninitialized to /export/home/alan/idea/wf/bin/epilog to enable grid submissions.

(If Workflow has already been installed on your grid, prolog and epilog do not need to be reinstalled.)</code>
The program has a funny installer, as the software package isn't really "installed" (it's more like "configured").  This has the unfortunate side effect of putting lots of static references to the user's home directory where it was "installed."

Replace all instances of "home/alan" with "paracel/biosoft" so that the program runs correctly when we move it to its new location.
  * <code>$ grep -rl home/alan * | xargs sed -i 's/home\/alan/paracel\/biosoft/g'</code>
Copy the directory to somewhere more appropriate (using ''sudo'' because it's outside of our home):
  * <code>$ cd ..
$ sudo cp -R idea /export/paracel/biosoft/</code>
Change everything to 777 permissions, this allows idea to run just fine, but is very insecure:
<code>$ sudo chmod -R 777 /export/paracel/biosoft/</code>
Add the installed directory to your shell's path so you can test it:
  * <code>$ export PATH=/export/paracel/biosoft/idea:${PATH}</code>