Traversal
This is the main repository for the AnyDSL traversal code.
Requirements
The traversal code comes in two flavours:
- A CPU version, which requires an x86 processor with the AVX, AVX2 and FMA instruction sets.
- A GPU version, based on CUDA, which requires a Maxwell GPU or a higher model.
Building
git clone https://user@github.com/AnyDSL/traversal.git
cd traversal
mkdir build
cd build
cmake-gui ..
Running
The frontend benchmarks the traversal code and generates an output which contains the intersection parameters.
It takes as input the scene file (which contains the acceleration structure) and the ray distribution.
Run it with -h to get the list of options.
When runnning the traversal on the GPU, make sure to run the executables in the directory where the file containing the compiled kernels (e.g. traversal.nvvm for the NVVM backend) is located.
A sample BVH file and a primary ray distribution are provided for testing. You can use them with the frontend, like so (replace <version> with cpu or gpu, depending on which device the traversal runs):
cd build/src
./frontend_<version> -a ../../testing/sibenik.bvh -r ../../testing/sibenik01.rays -n 80 -d 20 -o output.fbuf
Then, check the results with the fbuf2png tool:
./fbuf2png output.fbuf image.png
You can also use the BVH file with the viewer utility:
cd build/src
./viewer_<version> -a ../../testing/sibenik.bvh
Tools
This repository also includes some tools to generate ray distributions for primary rays, and to convert the output
of the frontend into a PNG image. You need libpng installed to compile them. Run them with -h to get the list of options.