-
Notifications
You must be signed in to change notification settings - Fork 7
GettingStarted Installation
The following instructions are tested on an Ubuntu 20.04 operating system.
For loading commonly used mesh/scene formats.
user@pc:~$ sudo apt install libassimp-dev
Rmagine provides an interface to integrate ray tracing libraries, we call backbones. All of these backbones are optional. So far we integrated Intel Embree and NVIDIA OptiX.
We support Embree in its latest version (test v4.0.1, v4.2.0):
user@pc:~$ git clone https://github.com/embree/embree.git
user@pc:~$ mkdir embree/build && cd embree/build
user@pc:~/embree/build$ cmake -DCMAKE_BUILD_TYPE=Release ..
user@pc:~/embree/build$ make -j`nproc`
user@pc:~/embree/build$ sudo make install
For older Embree versions we refer to this.
Rmagine supports NVIDIA OptiX versions of 7.2 or newer. The OptiX-Library is installed via the GPU driver. The OptiX-Headers can be downloaded here. The Headers require a specific GPU driver and CUDA version to be installed on your system:
OptiX Version | Minimum Driver Version |
---|---|
7.2 | 456.71 |
7.3 | 465.84 |
7.4 | 495.89 |
7.5 | 495.89 (untested) |
7.6 | 520.00 (untested) |
7.7 | 530.41 |
Download the Rmagine repository.
user@pc:~/rmagine$ mkdir build
user@pc:~/rmagine$ cd build
user@pc:~/rmagine/build$ cmake ..
user@pc:~/rmagine/build$ make
The path to OptiX-Headers should be specified with the CMake-Variable OptiX_INCLUDE_DIR
. This can be done using ccmake, for example.
Alternatively, cmake checks for the environment variable OPTIX_INCLUDE_DIR
to exist. After downloading the OptiX-SDK you can add the following command to your .bashrc
:
export OPTIX_INCLUDE_DIR=~/.../NVIDIA-OptiX-SDK-7.4.0-linux64-x86_64/include
After adding this path, the project should compile without changing the cmake flags.
You can check if everything went wrong by running the benchmark that was build besides the library:
user@pc:~/rmagine/build$ ./bin/rmagine_benchmark_cpu ../dat/sphere.ply
...
[ 100% - velos/s: 6261.9, mean: 6244.84]
Result: 6244.84 velos/s
or if the OptiX support was successfully build:
user@pc:~/rmagine/build$ ./bin/rmagine_benchmark_gpu ../dat/sphere.ply
...
[ 100% - velos/s: 383094, mean: 383457, rays/s: 5.52178e+09]
Result: 383457 velos/s
After compilation do
user@pc:~/rmagine/build$ sudo make install
You can check if everything went wrong by running the benchmark that was build besides the library:
user@pc:~$ rmagine_benchmark_cpu rmagine/dat/sphere.ply
...
[ 100% - velos/s: 6261.9, mean: 6244.84]
Result: 6244.84 velos/s
or if the OptiX support was successfully build:
user@pc:~$ rmagine_benchmark_gpu rmagine/dat/sphere.ply
...
[ 100% - velos/s: 383094, mean: 383457, rays/s: 5.52178e+09]
Result: 383457 velos/s
user@pc:~/rmagine/build$ sudo make uninstall
We are working on creating debian packages for easier installations.
$ sudo apt install libassimp-dev libeigen3-dev
Download latest Rmagine debian packages from Github releases page (v2.2.2). Install the core by calling
sudo apt install ./rmagine-core_2.2.2_amd64.deb
We support Embree in its latest version (tested: v4.0.1 - v4.3.0). Make sure you have Embree installed on your system.
sudo apt install ./rmagine-embree_2.2.2_amd64.deb
Make sure you have a current NVIDIA driver installed, then install rmagine-cuda and rmagine-optix by:
sudo apt install ./rmagine-cuda_2.2.2_amd64.deb
sudo apt install ./rmagine-optix_2.2.2_amd64.deb
To uninstall everything related to rmagine, call:
sudo apt-get remove rmagine-core
Getting Started
Library
Extra