cbcrg/sara-coffee-vm

Name: sara-coffee-vm

Owner: Notredame Lab

Description: null

Created: 2013-10-02 15:35:22.0

Updated: 2016-04-27 14:17:59.0

Pushed: 2016-04-27 14:23:01.0

Homepage: null

Size: 13

Language: Shell

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

SARA-COFFEE

SARA-Coffee is a structure based multiple RNA aligner.

This is a new algorithm that joins the pairwise RNA structure alignments performed by SARA with the multiple sequence T-Coffee framework.

SARA-Coffee VM

Since setting up the SARA-Coffee dependencies can be tricky we provide a self-contained Vagrant VM, which downloads and configures all the required pieces of software for you.

Install or update virtual box from https://www.virtualbox.org/wiki/Downloads

Install or update vagrant from: http://www.vagrantup.com

Clone the sara-coffee virtual machine (this project) in a convenient location

$ git clone https://github.com/cbcrg/sara-coffee-vm.git

Enter the sara-coffee-vm folder and launch vagrant:

$ cd sara-coffee-vm/
$  vagrant up  

The first time you run it, it will automatically download the virtual machine and all the packages required by SARA-Coffee. It may take some minutes to complete, so be patient.

When it boots up and the configuration steps are terminated, login into the VM instance:

$ vagrant ssh 

You are now in the Sara-Coffee virtual machine. Now you can run SARA-Coffee as shown:

$ cd sara_coffee_package/
$ ./sara_coffee.sh <input file> <output file> 

The folder '/vagrant/' is shared between the Sara-Coffee virtual and your local machine. On your local machine, this fiolder is the one in which you started vagrant (i.e. sara-coffee-vm)

When finished, stop the VM using the command vagrant halt or vagrant destroy, depending if you want to temporary stop the execution or delete permanently the VM with all its files.

Docker image

SARA-Coffee is also distributed as a Docker container. This will allow you to run it without having to install and configure each single dependency packages.

If you have Docker installed simply pull the SARA-Coffee container by using the command:

docker pull cbcrg/saracoffee

To run SARA-Coffee use the following command line:

docker run -v $PWD:$PWD -w $PWD cbcrg/saracoffee <input> <output>

Note: this command assumes your input file is located in the working directory. If this is not the case, you will need to mount the input file path accordingly.

Dependencies
Links

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.