Monday, July 2, 2012

MacQIIME BLAST installation error

As many microbiologists and other researchers working with high throughput sequencing I've decided to install and work with QIIME (a pipeline of different python scripts that makes our life a little easier).
I have to say beforehand I AM NOT A BIOINFORMATICIAN and I can be very clumsy with this kind of tools.
But I've learned that in microbiology we all have to learns or at least understand basic bioinformatics and programing notions if we want to have some edge and competitive performance.
So I jumped in the adventure of installing MacQiime
First I have to say that the installation in the Mac enviroment is less traumatic than my previuous experience in Ubuntu, I was running a virtual machine and when tried to update QIIME I got frustrating results with the VM and QIIME.
I recomend the Werner lab instructions  for MacQIIME installation they are very well writen and fairly easy to follow.
One of the most commons errors in the installation of macqiime seems to be during the installation of BLAST, a tool for taxonomy assignment during the OTU's picking, it seems that a lot of people, like me, fail in the PATH modification step where you basically add the BLAST package to your PATH environment.
So what the heck is the PATH? first let me remind you again that I am not a bioinformatician but a poor computer owner/operator that runs a lot for help to the IT people.

The PATH is basically an "environment" that contains all the variables that are called by the system when programs are run, it connects and allows to call your software files, data and more. For the technological virgin as me the PATH is a long string of "no Idea what the f is this" characters and names that looks like this

-bash: /Users/juangiarrizzo:/Users/juangiarrizzo/blast-2.2.26/bin:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:/usr/X11/bin: No such file or directory

Lets go back to adding Blast to your PATH, in the instructions yo will see that to do so (after placing the BLAST package in your home) you have to modified a file called .profile.
THINGS THAT THEY DONT TELL YOU AND YOU PROBABLY NEED TO KNOW
1) .profile is a file that ir read every time you run your shell (the window where you type your commands)
2) Every time you write something in .profile you are saying to the system to ignore and overwrite what you wrote before
3) And more important you have to restart your shell to make the PATH modifications to work!!!  this for the experts is a dah but from us mortals is not!! this measn you have to close and restart the terminal window so the modifications take place
4) Separate any new addings in the PATH with ":" otherwise you are just erasing the previous PATH statement.
Once you do a correct PATH addition for the BLAST package you should be able to locate the executable file "blastall" by typing: $ which blastal
If is not working this may be the causes:
1) You didn't restart the shell after modifying the PATH and adding the BLAST package (see instructions)
2) You overwrote the PATH by obsessively repeating the nano edit step (as I did)
3) Maybe you have the wrong name for the BLAST package in your $PATH, please note if you download the latest package the name is blast-2.2.26 and no blast-2.2.22 as it says in the instructions. Is OK to be a good instructions follower but reading is always advised.
I hope you find this helpful. You can also ask to to the QIIME forum if you run into other more complicated issue, you will find out that there are a lot of helpful and patience people waiting for you.

Cheers!!!


2 comments:

  1. Hello, Juan,
    I am also on my way of learning MacQIIME. It's been a year since you started this journey yourself and I wonder if you will be so kind to help me. I am going through the Werner's tutorial and strangely, once in a while, the osx's original Python is called (not the MacQIIMES) so the system prompts me to install X11 to get the original Python. Any idea how to solve this problem?

    ReplyDelete
    Replies
    1. Hi Olga,
      Thank you for reading!!!
      So the way I understand X11 allows you to generate and share graphical outputs obtained in your software being QIIME, R etc and visualize it in other machine, for more information you can read this (http://www.linuxjournal.com/article/4879).
      Now in the specific case of macQIIME you have to install X11 to generate and use graphic outputs (I am guessing that you got the error when tried to generate a graphic?).
      Since Apple is not supporting X11 platform anymore you can use any XQuartz version.
      There is an interesting threat in the QIIME forum that can relate to your problem (https://groups.google.com/forum/#!topic/qiime-forum/dFt1Uku3wmc)

      Additionally, if you are having problems specifically with Python libraries I would check if your macQIIME python libraries are correctly inserted in your PATH in the ./bin folder (I am guessing they are since it seems you got an specific request from the software to download X11.
      So, as for a first attempt for a solution: try to Download XQuartz and put it in your PATH, so is automatically executed, and run your command again.
      Good luck!!

      Delete