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/
q3/
...

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

Warning

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

File Formats

Code

  • Python scripts: .py
  • Jupyter notebooks: .ipynb

Figures

  • PDF (preferred)
  • PNG, JPG

Analytical work

  • PDF only (scanned handwritten or typeset)

Data files

  • HDF5: .h5, .hdf5
  • NumPy: .npy, .npz

Dependencies and requirements.txt

If your code requires packages beyond the Python standard library, include a requirements.txt in the problem directory:

torch==2.1.0
matplotlib==3.8.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 541 Homework 1
Author: Jane Doe
Student ID: 1234567890

## Contents
q1/
└── q1.pdf
q2/
└── q2.pdf
q3/
└── q3.pdf
q4/
└── q4.pdf
q5/
├── coin_sim.py
└── q5.pdf           # figures and analysis
q6/
├── uniform_sum.py
└── q6.pdf           # figures and analysis

## Dependencies
- Python 3.10+
- matplotlib

A single PDF per problem containing all figures and analysis is preferred. 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.