Assignment V: CUDA Programming

The purpose of this assignment is to familiarize yourself with CUDA programming.

Get the source code:

$ cd <your_workplace>
$ wget https://nctu-sslab.github.io/PP-s21/HW5/HW5.zip
$ unzip HW5.zip -d HW5

Modify your ~/.bashrc by adding the following configurations.

export PATH=$PATH:/usr/local/cuda/bin
export CUDADIR=/usr/local/cuda

1. Problem Statement: Paralleling Fractal Generation with CUDA

Following part 2 of HW2, we are going to parallelize fractal generation by using CUDA.

Build and run the code in the HW5 directory of the code base. (Type make to build, and ./mandelbrot to run it. ./mandelbrot --help displays the usage information.)

The following paragraphs are quoted from part 2 of HW2.

This program produces the image file mandelbrot-test.ppm, which is a visualization of a famous set of complex numbers called the Mandelbrot set. [Most platforms have a .ppm viewer. For example, to view the resulting images, use tiv command (already installed) to display them on the terminal.]

As you can see in the images below, the result is a familiar and beautiful fractal. Each pixel in the image corresponds to a value in the complex plane, and the brightness of each pixel is proportional to the computational cost of determining whether the value is contained in the Mandelbrot set. To get image 2, use the command option --view 2. You can learn more about the definition of the Mandelbrot set.

Mandelbrot Set

Your job is to parallelize the computation of the images using CUDA. A starter code that spawns CUDA threads is provided in function hostFE(), which is located in kernel.cu. This function is the host front-end function that allocates the memory and launches a GPU kernel.

Currently hostFE() does not do any computation and returns immediately. You should add code to hostFE() function and finish mandelKernel() to accomplish this task.

The kernel will be implemented, of course, based on mandel() in mandelbrotSerial.cpp, which is shown below. You may want to customized it for your kernel implementation.

int mandel(float c_re, float c_im, int maxIteration)
{
  float z_re = c_re, z_im = c_im;
  int i;
  for (i = 0; i < maxIteration; ++i)
  {

    if (z_re * z_re + z_im * z_im > 4.f)
      break;

    float new_re = z_re * z_re - z_im * z_im;
    float new_im = 2.f * z_re * z_im;
    z_re = c_re + new_re;
    z_im = c_im + new_im;
  }

  return i;
}

2. Requirements

  1. You will modify only kernel.cu, and use it as the template.
  2. You need to implement three approaches to solve the questions:
    1. Method 1: Each CUDA thread processes one pixel. Use malloc to allocate the host memory, and use cudaMalloc to allocate GPU memory. Name the file kernel1.cu. (Note that you are not allowed to use the image input as the host memory directly)
    2. Method 2: Each CUDA thread processes one pixel. Use cudaHostAlloc to allocate the host memory, and use cudaMallocPitch to allocate GPU memory. Name the file kernel2.cu.
    3. Method 3: Each CUDA thread processes a group of pixels. Use cudaHostAlloc to allocate the host memory, and use cudaMallocPitch to allocate GPU memory. You can try different size of the group. Name the file kernel3.cu.

3. Grading Policies

NO CHEATING!! You will receive no credit if you are found cheating.

Total of 100%: Implementation correctness.

4. Evaluation Platform

Your program should be able to run on UNIX-like OS platforms. We will evaluate your programs on the workstations dedicated for this course. You can access these workstations by ssh with the following information.

The workstations are based on Ubuntu 18.04 with Intel(R) Core(TM) i5-7500 CPU @ 3.40GHz processors and GTX 1060 6GB. g++-10, clang++-11, and cuda10.2 have been installed.

IP Port User Name Password
140.113.215.195 37076 ~ 37080, 37091~37093 {student_id} {Provided by TA}

Note: No 37094 this time

ATTENTION: Never touch 37095. It is for NIS and NFS.

Login example:

$ ssh <student_id>@140.113.215.195 -p <port>

You can use the testing script test_hw5 to check your answer for reference only. Run test_hw5 in a dictionary that contains your HW5_XXXXXXX.zip file on the workstation.

5. Submission

All your files should be organized in the following hierarchy and zipped into a .zip file, named HW5_xxxxxxx.zip, where xxxxxxx is your student ID.

Directory structure inside the zipped file:

Zip the file:

$ zip HW5_xxxxxxx.zip kernel1.cu kernel2.cu kernel3.cu

Be sure to upload your zipped file to new E3 e-Campus system by the due date.

You will get NO POINT if your ZIP’s name is wrong or the ZIP hierarchy is incorrect.

Due Date: 2021/05/22 00:00

6. References

  1. CUDA C++ Programming Guide
  2. cudaMallocPitch API Document
  3. CUDA 開發環境設定與簡易程式範例
  4. CPU 與 GPU 計算浮點數的差異