Install YoGA¶

This page will guide you through the process of getting YoGA up and running on your machine

Why CUDA ?¶

Yoga is built on top of the CUDA toolkit which is NVIDIA proprietary software. It is however freely available from NVIDIA's website. CUDA has been receiving a lot of support from NVIDIA and the GPGPU community in general and provides a large collection of tools to perform scientific computing (cufft, cublas, curand). Moreover, several libraries like cudpp or MAGMA have been developed using CUDA and provide additional functionalities very useful for scientific computing. CUDA thus appeared to us as the best option to quickly deploy a general toolkit for a "GPU accelerated Yorick".

The drawback is Yoga being doomed to be used on computers equipped with NVIDIA GPU card. You'll find here the list of CUDA-capable video cards Yoga has been tested on a variety of platforms, from laptops to servers with various grades of GPU cards from mobile series to high-end scientific-grade cards.

Concerning the OS, Yoga has been tested on linux and Mac OS with success. The following instructions apply for both.

Install NVIDIA's devdriver, toolkit and SDK¶

Go to the nvidia cuda website and get the CUDA framework and driver installed, following the installation instruction for your operating system.

Install Yorick¶

You get can Yorick from here : http://dhmunro.github.com/yorick-doc/ . This webpage will help you as well : http://www.maumae.net/yorick/doc/index.php. The associated forum provides a lot of help.

Download & Install YoGA¶

Get the latest version on the SVN repository or if you do not have access, contact us.

The YoGA distribution is splitted into two parts corresponding to 2 levels of use the high-level and the low-level. The latter is the YoGA library and corresponding C++ API. The corresponding files are located in the trunk/libyoga directory. Once compiled, a libyoga.so file will be created that can be dynamically linked to your software. The high-level corresponds to the YoGA plugin for Yorick. The corresponding files are located in the trunk/yorick directory. Once compiled, a file yoga.so will be created and various files will be installed in your Yorick distribution so as to be able to load the yoga plugin in any of your Yorick session.

then go to the newly created Yoga directory and update the Makefile with a:

yorick -batch make.i

check the path to access the CUDA libs (by default : /usr/local/cuda).

To get the full flavor of Yoga, you need an additional CUDA library : cudpp. The following command will do everything from downloading the package to moving the proper files to the proper place for you :

make cudpp

then a standard :

make && make install

will get you up and running !

There are some check scripts available in check_yoga.i that allow you to check your installation.