DeathRay

This project was created as part of the course  parallel computing for medical imaging and simulation

It implements dose calculation and real-time volumetric rendering using CT scans.

Getting the source

The easies way to get the code, is to download the tarball from  http://www.daimi.au.dk/∼u052178/dr.tar.gz

Otherwise, I you are familiar with openengine, it can be installed using dist.py

./dist.py install proj:DeathRay

Compiling

Compiling is a bit tricky, and it might be better just to run the precompiles 32-bit ubuntu (9.10) binary in the tarball.

If you want to compile yourself, please install the dependencies in the following section, and follow the instructions on BuildDebianUbuntu (Skip the part about getting the source and openengine, both are part of the tarball)

Running

The absolute easies way to run the code, it to step by cpvc's office, there the application is already installed and compiled.

To run, the following dependencies are needed CUDA GPU SDK 2.3 of cause and the following ubuntu packages: libsdl-image1.2-dev libboost-1.40-all-dev libsdl-ttf2.0-dev, and maybe more.

To install the dependencies type your terminal:

sudo aptitude install libsdl-image1.2-dev libboost-1.40-all-dev libsdl-ttf2.0-dev 

Assuming you have installed CUDA 2.3 toolkit and the driver in the default paths:

Before running the executable type:

export LD_LIBRARY_PATH=/usr/local/cuda/lib

Then go to the dr folder and type:

./build/DeathRay/Deathray

Usage

If you manage to get the application running, here are some usage instructions:

Screen

When succesfully running the program one should see a split screen window displaying a sample voxel map.

On the left screen the voxel map is visualized by rendering a slice in each of the three axis-aligned planes. Each of the plane slices can be moved using the sliders named X, Y and Z.

View mode

Press the Beam View button in order to align the camera with the beam angle. Rotate the beam around the volume by pulling the slider named beam angle.

When not in beam view, holding space and (left,middel,right)-mousebutton down will move and rotate the camera.

Dose Calculation

Push the calculate dose button in order to initiate the dose calculations using the current beam configuration. On the right screen the resulting dose is visualized.

Visualization

Press the Threshold button to view a 3d rendering of the volume. Press the Slice button to render a slice of the volume.

When in Threshold mode use the sliders named MAX and MIN controls the maximum and minimum rendered intensities respectively.

When in Slice mode the slider named MAX controls the where to place the slice to be rendered. In both modes the slider named Color Scale scales the dose deposition values to be rendered.

Help

If all fail, write an e-mail to {ptx,papaboo OR salomon} AT cs.au.dk