Currently, this Birdsuite release only runs on 32- or 64-bit Linux systems, although it may be possible to make it work on other systems, particularly if you have Matlab for the target system.
Currently, Birdsuite metadata exists only for Affymetrix Genome-Wide Human SNP Array 6.0.
Some files are not distributed by Broad Institute, and must be obtained from other parties.
For 64-bit, copy (or symlink) the 64-bit version of apt-probeset-summarize from Affymetrix Power Tools into EXEDIR, with the name apt-probeset-summarize.64 . For 32-bit, copy or symlink the 32-bit version of apt-probeset-summarize into EXEDIR, with the name apt-probeset-summarize . Note that you may do both of the above to run on both 32- and 64-bit systems.
Run the following commands:
R CMD INSTALL -l EXEDIREXEDIR/broadgap.utils_<version>.tar.gz
R CMD INSTALL -l EXEDIREXEDIR/broadgap.cnputils_<version>.tar.gz
R CMD INSTALL -l EXEDIREXEDIR/broadgap.canary_<version>.tar.gz
Install Matlab compiled runtime:
For 64-bit:
Download MCRInstaller.75.glnxa64.bin.gz and decompress into temporary directory.
Run the following command: MCRInstaller.75.glnxa64.bin -console
When prompted for a directory into which to install MCR, reply with EXEDIR/MCR75_glnxa64
MCRInstaller.75.glnxa64.bin may be deleted after installation is complete.
For 32-bit:
Download MCRInstaller.75.glnx86.bin.gz and decompress into temporary directory.
Run the following command: MCRInstaller.75.glnx86.bin -console
When prompted for a directory into which to install MCR, reply with EXEDIR/MCR75_glnx86
MCRInstaller.75.glnx86.bin may be deleted after installation is complete.
Note that you may do both of the above to run on both 32- and 64-bit systems.
Create a directory where all the Birdsuite metadata will go. We'll call this METADATADIR.
Unpack birdsuite_metadata_<version>.tgz into METADATADIR.
Copy the following files from the Affymetrix library bundle (genomewidesnp6_libraryfile.zip) into METADATADIR: GenomeWideSNP_6.Full.cdf, GenomeWideSNP_6.specialSNPs. For 5.0 chip, copy the analogous files.
Edit EXEDIR/birdsuite.sh, and add the following arguments to the java command line: --exeDir=EXEDIR --metadataDir=METADATADIR
If you wish to use the birdsuite_qc.py script, which makes running mini-DM and gender calling easier, follow these additional installation steps.
Copy or symlink GenomeWideSNP_6.cdf into METADATADIR. For 5.0 chip, copy the analogous files.
Copy or symlink apt-geno-qc (from APT) into EXEDIR.
Testing
Create a directory (TESTDIR) and unpack birdsuite_inputs_<version>.tgz there.
Create a directory (EXPECTEDDIR) and unpack birdsuite_outputs_<version>.tgz there.
Compare the files test.birdseed_calls, test.birdseed_confs, test.canary_calls, test.canary_confs, test.larry_bird_calls, test.larry_bird_confs in EXPECTEDDIR and TESTDIR/output. They should be identical.