Homework Submission

GitHub Submission Guide

All homework assignments are submitted via GitHub through Gradescope.

Repository Structure

Important

Your repository must be private. Public repositories will not be graded.

Organize your repository with one directory per problem:

README.md
q1/
q2/
...

Each problem directory (q1/, q2/, etc.) should contain all relevant files for that problem, including:

  • Python scripts (.py) and notebooks (.ipynb)
  • Configuration files
  • Generated plots or results as specified by the assignment
Warning

Submissions without a README.md file will NOT be graded.

Important

Do not commit training data or model weights. Checkpoints, datasets, and downloaded files stay out of the repository — add them to .gitignore:

data/
checkpoints/
*.pth

Dependencies and requirements.txt

If your code requires packages beyond the standard course environment (PyTorch, torchvision, numpy, matplotlib), include a requirements.txt in the problem directory:

gymnasium==1.0.0

README Requirements

Your repository must include a README.md file at the root. This file should:

  • Your full name and student ID
  • Briefly describe the submission
  • List files in each problem directory
  • Note any dependencies beyond standard course requirements

The README should be concise. Do not pad with excessive commentary.

Example README

# EE 641 Homework 1
Author: Jane Doe
Student ID: 1234567890

## Contents
q1/
├── train.py
├── model.py
└── results.png
q2/
├── q2.ipynb
└── requirements.txt

You may include additional files (e.g., intermediate outputs, extra visualizations), but only files listed in the README will be reviewed and scored. TAs will not search or hunt for unlisted files.

See Syllabus for grading policies.

Submitting to Gradescope

  1. Push your completed work to your GitHub repository
  2. Open the assignment on Gradescope
  3. Select GitHub as the submission method
  4. Connect your GitHub account if prompted (first time only)
  5. Select your repository and branch
  6. Submit

You may resubmit multiple times before the deadline. Only your last submission will be graded.

Note

You must link your GitHub account directly on gradescope.com, not through Brightspace. If you have trouble connecting, log into Gradescope directly and try again.

See Gradescope: Submitting a Code Assignment for detailed instructions with screenshots.

TipTesting Your Submission

Before submitting, ensure:

  1. Notebooks run top-to-bottom (Runtime → Restart and run all)
  2. Scripts run without errors on a clean environment
  3. No absolute paths — code runs from the repository root
  4. No data or checkpoint files in the repository
  5. Your repository structure matches the assignment requirements