The bioBakery Homebrew packages are no longer supported. We now provide Conda packages and Docker images. Please see the bioBakery documentation for information about how to install the tools with these two new methods.
Biobakery formulae for the Homebrew package manager.
To get started, install HomeBrew for MacOS or LinuxBrew for Linux platforms.
Install the full biobakery tool suite plus biobakery demos
Install dependencies Java Runtime Environment, USEARCH, and freetype/lapack/blas (required by matplotlib; available through brew depending on your operating system (ie "brew install freetype"))
Install the tool suite
$ brew tap biobakery/biobakery
$ brew install biobakery_tool_suite
Test the install
$ biobakery_demos --tool all --mode test
Testing all tools takes about 45 minutes.
If you have any issues installing dependencies of the tool suite and you have root permissions, install the bioBakery Docker images.
Install individual biobakery tools
If you do not want to install the full tool suite, you can select individual tools to install.
Tap the biobakery homebrew repository
$ brew tap biobakery/biobakery
Install the individual tools needed
HUMAnN2
$ brew install humann2
Add the option --with-python3 to install with python3 (by default it is installed with python2).
Demo databases are included with the install. To install the full databases, see the humann2 documentation.
Add the option --with-python3 to install with python3 (by default it is installed with python2).
Hclust2
$ brew install hclust2
PanPhlAn
$ brew install panphlan
Add the option --with-python3 to install with python3 (by default it is installed with python2).
bioBakery workflows
$ brew install workflows
Install Pandoc (only required for the visualization workflows)
Install LaTeX package with pdflatex, like TeXLive (only required for the visualization workflows)
Add the following to your PYTHONPATH to use this tool as a python library (export HOMBREW_PREFIX=$(brew --prefix))
$HOMEBREW_PREFIX/lib/python2.7/site-packages
$HOMEBREW_PREFIX/lib/python2.7/dist-packages
$HOMEBREW_PREFIX/lib64/python2.7/site-packages
Add the following to your R_LIBS to use this tool as a python library (if you require auto-doc features)
$HOMEBREW_PREFIX/R/library
Test the individual installs
Install biobakery_demos
$ brew install biobakery_demos
Test an individual tool install
$ biobakery_demos --tool humann2 --mode test
You can also view the commands for each demo run
$ biobakery_demos --tool humann2 --mode view
And you can run a demo and view the output files created
$ biobakery_demos --tool humann2 --mode run --output humann2_demo_output
FAQs
How do I get the latest formulas?
To get the latest formulas run, $ brew update.
I have installed a lot of tools and my brew install folder takes up a lot of space. How can I free up space?
Downloads for formulas are automatically installed in the brew cache. This way you only have to download something once but
it also can use up disk space. To remove the cache run, $ rm -rf $(brew --cache).
How do I list the names of the brew tools and versions installed?
Run the following command to list all of the tools and their versions, $ brew list --versions.
What should I do if I see an error during install that freetype is not installed but I have already installed freetype?
Matplotlib is required by some of the tools and it depends on freetype. Matplotlib expects a specific freetype header to be installed
in a specific folder and brew (and other package managers) don't always install the headers in this folder. If you are seeing
this issue run the command $ locate freetype | grep ft2build.h to find where the header file is located. Then run the
command $ ln -s /usr/include/freetype2/ft2build.h /usr/include/ (replacing the initial location with the one from
the first command) to link this file to the location where matplotlib expects it. This should resolve the issue.
What should I do if I see errors about python2?
The tools by default are installed with the python2 executable. For most environments on Linux and MacOS, you should have a
python2 executable. If you run $ which python2 and python2 is not found you are likely in a python3 conda environment.
If this is the case, then search for python3. If python3 is found add the option --with-python3 to install the tool
with python3. The python3 install is available for all tools that are python2/3 compatible.
What should I do if I am seeing errors installing dependencies?
The tools install some dependencies (like numpy/scipy/matplotlib) from source to get the exact version the tool
has been developed and tested with. If you have issues, you can try installing the formula without the dependency. For example,
tools with numpy as a dependency have the option --without-numpy which will allow you to bypass the numpy
install step. Options exist to bypass installing may specific dependencies. For a complete list of options, run
$ brew info FORMLUA, replacing FORMULA with that for which you would like to know the available options.
Alternatively, you can choose to not install all of the python packages by using the flag
--without-python-packages. If you do not install these dependencies, please install them with a different
package manager like pip or apt-get depending on your platform. A flag also exists to bypass installing
the R packages for those formulas that have R dependencies (--bypass-r-packages).
请发表评论