CS 5804: Homework Submission Instructions

Your homework assignments will each include a written problem set and a programming project. To help us grade your work faster and get you feedback quickly, we require you to follow the procedure detailed here for homework submission.

Directory structure

Save your homework in a directory with the name

PID-hw#

where you use your Virginia Tech PID in place of PID and the homework number (0 - 6) in place of the number sign (#). For example, if I am preparing a submission for homework 0, I would store my files in bhuang-hw0.

Place your written assignments directly in your submission directory. We prefer if you compile these into a single file such as a PDF, but if necessary, you can include multiple files.

For each of our programming projects, they will have a corresponding directory name for the download file. For example, the download file for homework 0 is an archived directory named tutorial, so if I am submitting homework 0, my directory structure would look contain

Updated: place a file in your main submission directory called "autograder_output.txt" that contains the output of the autograder when you run it on your machine. We will compare this to what we see to try to catch any issues. If our autograders disagree, we will know to take a closer look to figure out where the error is.

bhuang-hw0/written.pdf
bhuang-hw0/tutorial/

Archiving and compressing your directory

In a unix or linux environment, archive your directory by entering the following command

tar -czvf PID-hw#.tar.gz PID-hw#/

Again, if I am submitting homework 0, this command with the proper subsitutions would be

tar -czvf bhuang-hw0.tar.gz bhuang-hw0/

The flags here for the tar command do the following: c means we're creating an archive, z means we're compressing it, v means we're asking tar to be verbose and display every file it archives and compresses, and f means we're compressing the contents of a folder. This command should generate a single file that contains an archive of your submission directory.

Uploading to Scholar

You will archive and compress your submissions and upload them to scholar. Log into scholar at http://scholar.vt.edu using your PID and credentials, and find the Assignments section of the CS5804 course. Click on the assignment you are submitting, and upload your compressed archive.