ART is an ancestral reconstruction tool . . .

NAVIGATE: overview | getting started | installation | contents | command-line syntax | projects | ART output

Installation Instructions

To install ART, follow these instructions:

1. Install MySQL

ART stores ancestral data in MySQL. You should install MySQL on the same machine as ART. Create a database named 'ancrecon'. That's it, ART will generate any necessary tables.

2. Install PERL

ART uses perl scripts and therefore requires a perl interpreter. We built ART with perl version 5.6.8, but other versions will probably be okay.

3. Install CodeML

ART uses codeML for maximum-likelihood analysis. CodeML should be installed on the same machine as ART, and codeML should be executable from the '.' path. (That is, codeML should be executable from anywhere on the system).

4. Unpackage ART

Deploy the ART package into a directory which you have read/write access. For example, '~/your username/acrecon' is a good place. Click here for more information about ART's directory structure. After you deploy the package (and if you followed steps 1-3), ART should be ready to use.

5. Setup your ART Environment

ART needs to know where to store your ART projects. Someday, we'll get a team of interns to build a fancy installation package and this step won't be necessary.

Option #1 (Easy for people in Joe's lab)

Copy this file into your home directory. (On a Mac, your home directory is '/Users/your-name'). Everytime you login, this script will set your personal ART directory as '/Users/your-name/myart'. If you want your personal ART directory to be something else, then don't be afraid to modify the script.

Option #2

Copy these lines into a startup script, such as .bashrc or .bash_profile.

#!
#
# ART points to where art.pl lives:
export ART=/common/share/art/

# ARTHOME points to your personal working directory:
export ARTHOME=~/myart

# This ensures that you can run the ART program:
export PATH=$PATH:$ART

6. That's it! Now you're ready to run ART.