Skip to content

Installation

Jump to bottom Edit New page
Martin Asser Hansen edited this page Oct 1, 2015 · 13 revisions

New installer

A new experimental Biopieces installer have been released and can be found on the [Downloads] page.

Try it:

$ bash biopieces_installer.sh

... or continue the old fashioned way by carefully following the steps below:

Installing Biopieces

Before you install Biopieces you need a number of prerequisites in order for the Biopieces to work. Biopieces will only work on systems with a UNIX flavor. So far Biopieces have been tested successfully on MacOSX, Redhat/Linux, Ubuntu/Linux - so no Microsoft Windows - unless using Cygwin.

Overview

  1. Make sure Perl and required Perl modules are installed
  2. Make sure that Ruby and required Ruby gems are installed
  3. Make sure that Python is installed
  4. Install external tools
  5. Checkout Biopieces code from repository
  6. Checkout Biopieces wiki pages from repository
  7. Configure Biopieces
  8. Create required directories
  9. Run tests.

Prerequisites

The basic idea behind Biopieces is that they should work no matter the programming language. For now Biopieces are written in Perl, Ruby and Python.

Perl

Currently most Biopieces are written in Perl, and the framework is written in Perl, so Perl and a number of Perl modules are mandatory. You will need Perl version 5.8 or later.

http://www.perl.org/

You also need the below list of Perl modules. To check if you already have one of the modules you type perl -M<module name> on the command line and Perl will raise an error if the module was not found. To install modules try the following on the command line (you may need admin rights if you are installing modules on the system Perl - in which case you need to prefix with sudo):

$ cpan
cpan> install <module>
cpan> install <another modules>

etc ...

cpan> q
  • Module::Build
  • Bit::Vector
  • SVG
  • Term::ReadKey
  • Time::HiRes
  • DBI
  • XML::Parser
  • Carp::Clan
  • Class::Inspector
  • HTML::Parser
  • LWP
  • SOAP::Lite
  • URI
  • Inline
  • Parse::RecDescent
  • version
  • DB_File
  • DBD::mysql

Ruby

An increasing number of Biopieces are written in Ruby and Ruby 1.9 or later is required.

http://www.ruby-lang.org/en/

You also need the below list of Ruby gems:

  • gnuplot
  • narray
  • RubyInline
  • terminal-table

Ruby gems are installed simply by typing on the command line (if you use the system's Ruby you need admin rights, so prefix with sudo):

gem install <gem name>

Python

For now, only a few Biopieces are written in Python, but there will be more. Python 2.6 or later is required.

http://www.python.org/

External Tools

A number of Biopieces depends on external tools in order to work, and these tools you have to install yourself if you want to use them (unless they are already on your system).

After installation the location of the binaries should be added to the PATH environment variable.

Installing Biopieces from Subversion

Biopieces are installed by checking out the code from Subversion (you will need a Subversion client) [here].

Basically you can checkout a read-only version like this:

cd ~/ # or wherever you want the Biopiece source code tree rooted

svn checkout http://biopieces.googlecode.com/svn/trunk/ biopieces

After you have installed the source code tree, you need to install the wiki tree as well:

cd ~/biopieces

svn checkout http://biopieces.googlecode.com/svn/wiki bp_usage

If you are a recognized developer you simply add your username to the checkout command,

cd ~/  # or wherever you want the Biopiece source code tree rooted

svn checkout https://biopieces.googlecode.com/svn/trunk/ biopieces --username <username>

and when prompted you enter the password from

http://code.google.com/hosting/settings

And for the wiki pages:

cd ~/biopieces

svn checkout https://biopieces.googlecode.com/svn/wiki bp_usage --username <username>

Configuring Biopieces

Add the following section to your ~/.bashrc file and run source ~/.bashrc in order to enable biopieces in a bash environment. Other shells are currently not supported.

# >>>>>>>>>>>>>>>>>>>>>>> Enabling Biopieces if installed <<<<<<<<<<<<<<<<<<<<<<<

# Installation instructions:
# http://code.google.com/p/biopieces/wiki/Installation

# Modify the below paths according to your settings.
# If you have followed the installation instructions step-by-step
# the below should work just fine.

export BP_DIR="$HOME/biopieces"  # Directory where biopieces are installed
export BP_DATA="$HOME/BP_DATA"   # Contains genomic data etc.
export BP_TMP="$HOME/tmp"        # Required temporary directory.
export BP_LOG="$HOME/BP_LOG"     # Required log directory.

if [ -f "$BP_DIR/bp_conf/bashrc" ]; then
    source "$BP_DIR/bp_conf/bashrc"
fi  

# >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>><<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

Creating Directories

You need to create the directories $BP_DATA, $BP_TMP, and $BP_LOG if these don't exist already:

mkdir $BP_DATA $BP_TMP $BP_LOG

Testing Biopieces

Run the Biopieces testing suite using the following command:

bp_test

If the testing suite breaks and will not run you are probably missing some of the Perl modules mentioned in the prerequisites. If the tests do run and any of them are failing, you probably are missing some of the [external tools] such as BLAST - running bp_test should indicate these as warnings. Otherwise do report problems.

All done!

For important messages, questions, discussion, and suggestions join the Biopieces Google Group.

Once your installation works you might want to head over to the [Biopieces Introduction] for examples on how to get started analyzing data.

Add a custom footer

Featured

Clone this wiki locally