CS221 Homework Guidelines

Homeworks

Written assignments: Homeworks should be written up clearly and succinctly; you may lose points if your answers are unclear or unnecessarily complicated. Here's an example of what we are looking for. Written homework must be typeset using LaTeX, Microsoft Word, Pages for Mac, or an equivalent program, and submitted as a PDF. We strongly encourage you to use LaTeX: there are user-friendly web interfaces like Overleaf. See this getting started guide. Figures may be hand-drawn, so long as they are included in a typeset PDF. If you're not sure where to start with formatting your written solutions, we recommend using this template as a starting point. You can copy and paste its contents into an Overleaf project or upload it directly.
Programming assignments: The grader runs on Python 3.12, which is not guaranteed to work with alternative versions (e.g., Python 2.7). Please use Python 3.12 to develop your code.

The programming assignments are designed to be run in GNU/Linux environments. Most or all of the grading code may incidentally work on other systems such as MacOS or Windows, and students may optionally choose to do most of their development in one of these alternative environments. However, no technical support will be provided for issues that only arise on an alternative environment. Moreover, no matter what environment is used during development, students must confirm that their code (specifically, the student's submission.py) runs on Gradescope.

The submitted code will not be graded if it has one of the following issues:

Submission

Electronic Submission: All homework assignments are due at 11pm (23:00, not 23:59) Pacific time on the due date.
Refer to coursework for exam deadlines. Assignments are submitted through Gradescope. Do not submit your assignment via email. If anything goes wrong, please ask a question on Ed or contact a course assistant. You will be automatically enrolled in Gradescope using your @stanford.edu email address (email us if that doesn't happen!). You can submit as many times as you'd like until the deadline: we will only grade the last submission.

Submit early to make sure your submission runs properly on the Gradescope servers. Gradescope will run grader.py on the programming questions and give you feedback on non-hidden test cases. You are responsible for checking that your program runs properly on these cases. You will not get credit otherwise. If anything goes wrong, please ask a question on Ed or contact a course assistant. Do not email us your submission. Partial work is better than not submitting any work.

For assignments with a programming component, we will automatically sanity check your code in some basic test cases, but we will grade your code on additional test cases. Important: just because you pass the basic test cases, you are by no means guaranteed to get full credit on the other, hidden test cases, so you should test the program more thoroughly yourself!

Unless the assignment instructs otherwise, all of your code modifications should be in submission.py and all of your written answers in <assignment ID>.pdf. Upload the former to Gradescope under the "Programming" section, and the latter under the "Written" section.

For the project milestones, make sure that all members of your group submit. The submission should include a group.txt file which should contain the SUNetIDs of the entire group, one per line.
Late days: A homework is $\lceil d \rceil$ days late if it is turned in $d$ days past the due date (note that this means if you are $1$ second late, $\lceil d \rceil = 1$ and it is 1 day late). You have seven (7) late days in total that can be distributed among the homeworks without penalty. After that, the maximum possible grade is decreased by 25% each day (so the best you can do with $d = 1$ is 75%). As an example, if you are out of late days and submit one day late, a 90 will be capped at a 75, but a 72 will not be changed. Note that we will only allow a max of $d = 2$ late days per homework, though, so if $d > 2$ then we will not accept your submission. Gradescope is set up to accept written and programming submissions separately. Late days are calculated per-assignment, with the number of late days used depending on the later submission. So, if the programming part is $1$ day late and the written part is $2$ days late, then that will count as using $2$ late days.

If you choose to do the project, please note that a late submission will count against your number of remaining late days.

Regrades: If you believe that the course staff made an objective error in grading, then you may submit a regrade request for the written part of your homework or exam. Remember that even if the grading seems harsh to you, the same rubric was used for everyone for fairness, so this is not sufficient justification for a regrade.

It is also helpful to cross-check your answer against the released solutions. If you still choose to submit a regrade request, click the corresponding question on Gradescope, then click the "Request Regrade" button at the bottom.

Any requests submitted over email or in person will be ignored. Regrade requests for a particular assignment are due by Tuesday 11pm, one week after the grades are returned. Note that we may regrade your entire submission, so that depending on your submission you may actually lose more points than you gain.