Code Setup

Code Setup#

Obtaining and Running the Code#

In the previous homework, we dealt with a streaming application that compressed only one picture. For this homework, we will use the same application, except that it will take a video stream instead of a single picture. You can run the walk-through on the host computer. But note that you need to run the code for homework submission on the Ultra96.

  • Clone the ese532_code repository using the following command:

    git clone https://github.com/icgrp/ese532_code.git

    If you already have it cloned, pull in the latest changes using:

    cd ese532_code/
git pull origin master

    The code you will use for homework submission is in the hw3 directory. The directory structure looks like this:

    hw3/
    assignment/
        Makefile
        Walkthrough.cpp
        common/
            App.h
            Constants.h
            Stopwatch.h
            Utilities.h
            Utilities.cpp
        baseline/
            App.cpp
            Compress.cpp
            Differentiate.cpp
            Filter.cpp
            Scale.cpp
        coarse_grain/
            ...
        pipeline_2_cores/
            ...
        cdc_parallel/
            ...
    data/
        Input.bin
        Golden.bin

  • There are four parts to the homework. You can build all of them by executing make all in the hw3/assignment directory. You can build separately by:

    • make base and run ./base to run the baseline project.

    • make coarse and run ./coarse to run the coarse-grain project.

    • make pipeline2 and run ./pipeline2 to run the pipeline project on 2 cores.

    • make cdc and run ./cdc to run the data-parallel CDC you will implement on 4 cores.

  • The data folder contains the input data, Input.bin, which has 100 frames of size \(960\) by \(540\) pixels, where each pixel is a byte. Golden.bin contains the expected output. base, coarse and pipeline2 uses this file to see if there is a mismatch between your program’s output and the expected output. cdc uses prince.txt from the data folder as an input. golden.txt has the expected output cdc will produce.

  • The assignment/common folder has header files and helper functions used by the four parts.

  • You will mostly be working with the code in the rest of the folders.

Contents