How to use the VRP development kit

Clone the git repository containing the VRP development kit

git clone  --branch v0.1-TRISTAN  ssh://gitolite@ssh-codev-tuleap.intra.cea.fr:2044/epi/vrp-software-dev-env.git v0.1-TRISTAN

cd v0.1-TRISTAN

git submodule update --init --recursive

Compilation of external libraries used by the VRP development kit

This step may take a long time depending on the performance of your system (compilation of several software libraries)

cd external_libraries

bash ./install.sh

Compiling the VRP development kit

To compile the VRP development kit you have to run the build.sh script with the following options : --rebuild --all This version of the development kit supports only MPFR software emulation of variable precision.

bash ./build.sh --rebuild --all

Using the VRP development kit for a new program

To use the VRP development kit you need to update the content of several environment variables : PATH, LD_LIBRARY_PATH, PKG_CONFIG_PATH.

To simplify these modification it is possible to use the "module" tool for which we provide a set of configuration files in the "modules" directory

To do so you have to:

1. Indicate to the module tool where the configuration files are located (the "module" command must be run from the cloned directory root)

module use ./modules

2. Load the main module that sets the appropriate environment

The "module" tool manage dependencies, so you have to load only one module by hand, the other mandatory modules will be loaded automatically.

module load vrp/sdk/linux_x86_64/current-dev-linux_x86_64

Launch VRP development kit non-regression tests

There are some non-regression tests allowing to check that VRP development kit works properly. You can find them in the vp_sdk/vp_sdk_unit_tests/ directory. To run them you have to setup environment variables with the module command (previous step) and run the nonreg.sh script

./nonreg.sh --linux --exclude eigen --exclude vsqrt --exclude matrix

Create a new application using the VRP development kit

1. You shall build the environment as described in previous sections.

2. You shall setup environment variables (using the "module" command).

3. Create a Makefile to build your application. Use the following example as skeleton, it contains the pkg-config command example needed to compile and link your application with on the VRP development kit.

TARGETS=test
BUILD_DIR=$(shell readlink -f ./build)

CXXFLAGS=$(shell pkg-config --cflags vp_sdk_linux_x86_64 matrix_sdk_linux_x86_64) -ggdb -O0 -Wall
LDFLAGS=$(shell pkg-config