2. Getting started guide

If you have already installed Bifrost, look below to Creating your first pipeline

2.1. Installation

Bifrost requires several dependencies, depending on how you want to use it. If you don’t know what you are doing, assume that you want all the dependencies - we will walk you through this process.

You will need a relatively new gcc and CUDA - we have used Bifrost with gcc 4.8 and CUDA 8, but higher ones should also work.

2.1.1. Python dependencies

Bifrost is compatible with both in Python 2.7. and Python 3.x.

2.1.1.1. pip

pip is a package manager for other Python dependencies. Once you have pip, installing additional python dependencies should be straightforward. pip comes with setuptools, which is required for installing Bifrost. The detailed instructions for pip can be found here, but the basics are as follows:

  1. Download `get-pip.py <https://bootstrap.pypa.io/get-pip.py>`__

  2. Navigate to the download directory, and run python get-pip.py --user, which will install a local copy of pip.

  3. Check pip is working with pip list, which will give the versions of pip and setuptools.

2.1.1.2. numpy, matplotlib, contextlib2, simplejson, pint, graphviz, ctypesgen

If you have already installed pip, this step should be as simple as pip install --user numpy matplotlib contextlib2 simplejson pint graphviz ctypesgen==1.0.2.

2.1.2. C++ dependencies

2.1.2.1. CUDA

CUDA allows you to program your GPU from C and C++. You will need an NVIDIA GPU to do this. If this is your first time trying out Bifrost, and you don’t have CUDA yet, we recommend that you skip this step, and try out a CPU-only version of Bifrost. Then, once you have that first experience, you can come back here for a speedup.

If you are ready to work with a GPU, you will want to get the newest CUDA toolkit. Follow the operating system-specific instructions to install.

2.1.2.2. Other Dependencies

  • exuberant-ctags

  • Basic build tools (make, gcc, etc.)

On Ubuntu, the following command should grab everything you need:

sudo apt-get install build-essential software-properties-common exuberant-ctags

2.1.3. Bifrost install

Now you are ready to install Bifrost. Clone the GitHub master branch with

git clone https://github.com/ledatelescope/bifrost.

You will want to run configure to tailor Bifrost to you system. At the end of configure you will get a summary of how Bifrost will be built:

config.status: creating src/bifrost/config.h config.status: executing libtool commands

configure: cuda: yes - 50 52 configure: numa: yes configure: hwloc: yes configure: libvma: no configure: python bindings: yes configure: memory alignment: 4096 configure: logging directory: /dev/shm/bifrost configure: options: native

Bifrost is now ready to be compiled. Please run ‘make’ ```

Now you can call make, and make install to install Bifrost.

Trying to call import bifrost inside of a Python program will tell you if your install was successful or not.