Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/andreal2000/project-ray-tracing

Project for the course of GPU Computing
https://github.com/andreal2000/project-ray-tracing

Last synced: 13 days ago
JSON representation

Project for the course of GPU Computing

Host: GitHub
URL: https://github.com/andreal2000/project-ray-tracing
Owner: Andreal2000
License: mit
Created: 2024-08-24T13:39:28.000Z (5 months ago)
Default Branch: main
Last Pushed: 2024-10-10T12:13:56.000Z (3 months ago)
Last Synced: 2024-11-09T09:48:38.438Z (2 months ago)
Language: C++
Homepage:
Size: 14.8 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Project: Ray Tracing

This project was developed as part of the "GPU Computing" course for the Master's degree in Computer Science at the University of Milan (Università degli Studi di Milano). It aims to compare the performance of a naive CPU-based ray tracing algorithm with a highly parallelized version implemented on a GPU using CUDA.

## Features

- **CPU Implementation**: A straightforward, sequential version of the ray tracing algorithm.
- **GPU Implementation**: A highly parallelized version that leverages thousands of GPU threads to accelerate computations.
- **Project Report**: For a detailed explanation of the implementation, results, and analysis, please refer to the [project report](./report/report.pdf).

## Requirements

To run this project, you will need the following:

- **NVIDIA GPU**: A compatible NVIDIA GPU is necessary to run the GPU version of the ray tracing algorithm.
- **NVIDIA CUDA Toolkit**: Ensure you have the NVIDIA CUDA Toolkit installed, which includes the `nvcc` compiler required to compile CUDA code. You can download it from the [official NVIDIA website](https://developer.nvidia.com/cuda-downloads).
- **Make**: A build automation tool like `make` is required to use the provided `Makefile` for building and running the project.

## Installation

1. Clone this repository to your local machine:

```bash
git clone https://github.com/Andreal2000/Project-Ray-Tracing.git
```

2. Navigate to the project directory:

```bash
cd Project-Ray-Tracing
```

3. Build and execute the project using make

## Usage

The project provides a `Makefile` to simplify the build and execution process. Below are the available commands and their descriptions:

- **Build CPU version**:
Compiles the CPU-based implementation of the ray tracing algorithm.

```bash
make cpu
```

- **Build GPU version**:
Compiles the CUDA-based implementation of the ray tracing algorithm.

```bash
make gpu
```

- **Run CPU version**:
Compiles and runs the CPU-based version.

```bash
make cpu-run
```

- **Run GPU version**:
Compiles and runs the CUDA-based version.

```bash
make gpu-run
```

- **Sanitize GPU version**:
Compiles and runs the GPU version with CUDA compute sanitizer to detect memory leaks and race conditions.

```bash
make gpu-sanitize
```

- **Clean build artifacts**:
Removes the compiled binaries and other generated files.

```bash
make clean
```

## Showcase

### Balls

![ballsAA](./images/balls/ballsAA.bmp)
![balls](./images/balls/balls.gif)

### Earth

![earthAA](./images/earth/earthAA.bmp)
![earth](./images/earth/earth.gif)

### Cornell Box

![cornell_box](./images/cornell_box/cornell_boxAA.bmp)

### Stanford Bunny

![bunny](./images/bunny/bunny.bmp)

### Spot

![spot](./images/spot/spotAA.bmp)

### Utah Teapot

![teapot](./images/teapot/teapot.bmp)

### Eight Ball

![eight_ballAA](./images/eight_ball/eight_ballAA.bmp)
![eight_ball](./images/eight_ball/eight_ball.gif)

### Crash Bandicoot

![crash_bandicootAA](./images/crash_bandicoot/crash_bandicootAA.bmp)
![crash_bandicoot](./images/crash_bandicoot/crash_bandicoot.gif)

### King

![king](./images/king/kingAA.bmp)

### Mario

![mario](./images/mario/marioAA.bmp)

### Obamium

![obamiumAA](./images/obamium/obamiumAA.bmp)
![obamium](./images/obamium/obamium.gif)