0. Prerequisites
ADOPS needs T-Coffee, MrBayes and CodeML applications in order to work, so you will have to install them before start with this installation process.
You can find the installation files and instructions of this programs in their respective web pages:
1. Download
Download your ADOPS copy from here (9.6MB) and go to step 2.
Or you can download this Ubuntu 14.04 (64 bits) Virtual Machine (~1.8GB) with a copy of ADOPS, T-Coffee, MrBayes and PAML already installed and configured (also the BDBM software). Run the virtual machine (you will need Virtual Box) and go to step 4.
If you have some trouble installing the ADOPS VM, you can check our ADOPS VM - Quick Installation Guide.
2. Decompress
Figure 1. ADOPS file structure
Decompress the downloaded file (you will need a ZIP decompressor).
You can decompress and install ADOPS in any folder, although we recommend you to install it in a folder without spaces in its path due to some problems with the programs used by ADOPS. For example:
- /home/user/ADOPS [OK]
- C:\Programs\ADOPS [OK]
- /home/user/My Programs/ADOPS [Not recommended]
- C:\Documents and settings\ADOPS [Not recommended]
Once decompressed you should have a directory structure like seen in Figure 1.
3. Configure
Before start working with ADOPS you have to configure the paths to MrBayes and CodeML applications.
Open the system.conf configuration file and set the appropriate value to the following properties:
tcoffee.bin
- T-Coffee command. T-Coffee must be in the system path1
mrbayes.dir
- Path to the MrBayes installation directory. Independently of your OS use / as path separator (e.g. C:/Users/john/mrbayes/) [Required]
mrbayes.bin
- Name of the MrBayes executable file
codeml.dir
- Path to the CodeML installation directory. Independently of your OS use / as path separator (e.g. C:/Users/john/paml/) [Required]
codeml.bin
- Name of the CodeML executable file [Required]
System configuration file should look as follows:
input.sequences=
input.fasta=
input.names=
tcoffee.bin=<T-Coffee command>
tcoffee.params=
tcoffee.maxSeqs=3
tcoffee.alignMethod=CLUSTALW2
mrbayes.mpich=
mrbayes.dir=<Path to MrBayes>
mrbayes.bin=<MrBayes executable>
mrbayes.params=
mrbayes.ngen=500000
mrbayes.tburnin=1250
mrbayes.pburnin=1250
codeml.dir=<Path to CodeML>
codeml.bin=<CodeML executable>
codeml.params=
codeml.models=0 1 2 3 7 8
4. Launch!
Now you are ready to launch ADOPS.
In case you are under a Windows environment you have to execute the run.bat file. Otherwise, if you are under a Linux environment you have to execute the run.sh file.
If you want to test the application you can download this example files:
Note: Mac OS support comming soon...
2Data set taken from Expression and Trans-Specific Polymorphism of Self-Incompatibility RNases in Coffea (Rubiaceae). Nowak, M., Davis, A., Anthony, F., Yoder, A. PloS one 6(6) (2011)