.. raw:: html Getting started guide ===================== .. raw:: html If you have already installed Bifrost, look below to `Creating your first pipeline <#tutorial>`__ 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. Python dependencies ~~~~~~~~~~~~~~~~~~~ *Bifrost is compatible with both in Python 2.7. and Python 3.x.* `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`` `__ 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. 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``. C++ dependencies ~~~~~~~~~~~~~~~~ `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. 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`` 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.