KIRMES Source Code

Welcome to KIRMES!

Quick Start

Run the example to see how it works:

python kirmes.py -e -v -p Example/positives.fasta -n Example/negatives.fasta -q Example/query.fasta -r Example/resume.pck

To see all available options, run:

python kirmes.py --help

Use your own FASTA files to run KIRMES!

Prerequisites

KIRMES consists of a series of object-oriented Python scripts. It requires several other programs to run, that are not included in any download package due to copyright and redistribution issues.

Operating System

A *nix-like shell will be necessary, we have tested Mac OS X and Ubuntu Linux. Feel free to try others.

Basics

KIRMES relies on these programs and Python modules that need to be installed and available in the (Python-)path for KIRMES to run:

Python Interpreter: you will need Python 2.5, which is probably already installed, with a couple of extras:

  • SciPy
  • NumPy
  • wxPython
  • matplotlib (pylab)

Third-party Software

  • For the SVMs to work, you will need the large-scale machine learning toolbox Shogun, available at http://www.shogun-toolbox.org Shogun has its own requirements that need to be met, e.g. the installation of SVMLight

Optional Software

  • For the Gibbs sampling programs supported by KIRMES, you need to download the ones you want to use (optional):
    • MotifSampler from the INCLUSive package by Gert Thijs et al.
    • A Gibbs Binary with an interface in the BioPERL project
    • Soon: Priority by Raluca Gordan et al.
  • KIRMES has a cool Galaxy interface, and you will need to install the Python-based Galaxy web service: instructions

Installation

  • First, install all the packages for Python.

  • Then install SVMLight.

  • Afterwards, you can download and compile the shogun source code. Be sure to use the latest version. Compile shogun with the option:

    --interface=python-modular
    

    which enables the python bindings that KIRMES requires.

  • The command-line version of KIRMES is now ready to use.

  • Then you can download and install Galaxy. It needs to be checked out via their mercurial (hg) versioning system.

  • Follow the instructions to set up the server and then create a directory in the tools subdirectory called KIRMES. Here, you can unzip the KIRMES files and afterwards add it as a tool to the tool_conf.xml in the root directory, e.g. with the following line:

    <section name="KIRMES" id="KIRMES">
       <tool file="mlb/kirmes/KExamplesInstructions.xml" />
       <tool file="mlb/kirmes/KKMC.xml" />
       <tool file="mlb/kirmes/KIMS.xml" />
       <tool file="mlb/kirmes/KIML.xml" />
       <tool file="mlb/kirmes/KTraining.xml" />
    </section>
    
  • Install the Gibbs samplers you wish to use and put them in your system's path variable, or directly into the KIRMES directory in the Galaxy instance.

  • Finally, you can start Galaxy by running:

    sh ./run.sh
    

    in the Galaxy directory. As soon as it is up and running, you can connect to it via http://localhost:8080 (if you didn't change the port during setup). You should see KIRMES as one of the tools in the left-hand pane.

First Steps in Galaxy

Start by uploading a FASTA file to Galaxy, or preferably two, with a positive and a negative set. You can first run the training part of KIRMES and afterwards test it on a third set of genes via the Classifier part.