home page - news - syllabus - topics - schedule - assignments - tutorials - tests - java - references - Mike Jacobson |
Instructions - Assignment 1 - Assignment 2 - Assignment 3 - Assignment 4 - Assignment 5 |
Instructions for Preparing and Submitting Assignments |
Please make sure to read both of the following documents before you spend time working on assignments for this course.
Note that both these documents include information about the kinds of discussions you can have about course work and about how reference material can be cited and used.
Electronic submission, via the course Blackboard page, will be used to submit all assignments in this course.
Provide Java source files as text files when you are asked to write Java programs to solve problems on assignments in this course.
Each program that you write should be
Well designed and implemented: Make sure to follow proper programming style when writing programs to solve problems in this course!
Thoroughly documented: Include preconditions, postconditions, and descriptions of all exceptions that can be thrown for every method that you include in your program.
You must also include both a loop invariant (written in simple English that includes mathematical statements as needed) and loop variants for each loop in your programs.
Any additional documentation that a reader would be expected to need, to understand why your program solves the problem it is supposed to, should be included as well.
It will generally be sufficient to include all this as inline documentation. However, you may also include additional documentation in a separate text document, provided that your source code includes a reference to this other document at the place where inline documentation would be expected.
Thoroughly tested: When a test suite is explicitly required, provide a test document for each program that discusses the methods you used to develop tests, lists that tests that you developed, and the information you learned when executing these tests. Your document should also describe the process you followed to find and correct errors if your tests “succeeded.”
Note: You will be assessed on the quality of your testing and documentation when programs are marked in this course.
Written solutions to other questions (that require proofs or analysis) should be typeset and provided as Microsoft Word (“.doc”), Postscript (“.ps”) or PDF (“.pdf”) files. No other file formats are allowed.
Note: You will be assessed on the quality of your writing when your answers for non-programming problems are marked in this course.
File names can be changed when files are submitted using Blackboard, and this can complicate things when you submit programs. Please submit a single file, using the following instructions, as your solution for each assignment in this course.
Move Your Files into a New Directory.
When you are ready to submit your solutions for an assignment create a new directory (preferably named after the assignment) and move all (and only) the files that you wish to submit into this directory.
Generate an Archive File.
Use the Unix “tar” command to produce a single compressed “tar file” that includes the contents of this directory.
You should do this by executing the command
tar –cvfz archive.tgz AssignmentDirectory
in the directory above the directory with your assignment files — that is, in the directory that contains your assignment directory — where archive.tgz is the name you wish to give to the compressed “tar file” that you wish to create, and where AssignmentDirectory is the name of the directory that stores your assignment files (which you have created already).
After you have done this, you should find that a new file called archive.tgz has been created, in the same directory as the one that contains the directory storing your assignment files.
For example, if I have a directory called “CPSC331” where I store all my files for this course, then I would probably create a new directory called “Assignment1” inside my “CPSC331” directory, and I would use the directory “Assignment1” to store my files for the first assignment in this course. Just before submitting material for the first assignment I would make sure that “Assignment1” includes the files I wish to submit. Then I would execute the command
tar –cvfz assignment1.tgz Assignment1
within my “CPSC331” directory in order to create a file called “assignment1.tgz” and this is the file that I would submit using the course Blackboard page.
Select Your Compressed File Using the File Selector in the Assignment Area, in Blackboard.
Go the the area for the assignment in the course blackboard page. You should see that this includes
The middle “Assignment Material” area includes a file selector that you should use to upload your solution.
Complete the Submission Process:
Press the “Submit” button when you are finished.
Note: To my knowledge it is only possible to submit material by pressing the “Submit” button once!
Furthermore, pressing “Save” does not submit your work for you, so that it will not be seen or graded if you select this instead of “Submit,” by mistake.
Please send email to the course instructor as soon as you can, if you discover that you wish to resubmit material (perhaps, in order to correct a mistake), or if you realize that you did not “submit” your material before an assignment was due.
This page last modified:
http://www.cpsc.ucalgary.ca/~jacobs/cpsc331/W07/assignments.html |