How to submit problem sets (PS)?

We will release LaTex files for each PS. Please submit a single pdf to gradescope (Entry Code: “BBV7VY”). We accept either LaTex pdfs or scanned documents as long as the location of each question is annotated properly.

How to submit assignments? (in general)

For each assignment, you will be required to submit two packages unless specified otherwise: your code and your webpage:

Submit code to Canvas

For every assignment you should create a main.py that can be used to run all your code for the assignment, and a README.md file that contains all required documentation. Place all source code used to generate your results, as well as any documentation required to use the code, in a folder named andrewid_code_projX where X is the hw number. Zip the whole folder and submit the zip to Canvas. Here is an example of what your folder structure should look like:

andrewid_code_proj1/
    main.py
    README.md
    utils.py
    ....
## zip the whole folder to andrewid_code_proj1.zip:

Submit your webpage to the class website

We will use Andrew File System(AFS) to store and display webpages. Here is a step by step tutorial for how to do this:

  1. Please make sure to remove all version control directories (e.g. .git) from your website folder, and make sure that the total size is reasonable (less than 20 mb)
  2. Please use one of the images here to indicate on your webpage the number of late days used.
  3. Place your website under folder projX and zip it. Please make sure that your main report page is called index.html so browsers open it automatically. X is the hw number.
  4. Remote Copy. Use WinSCP or your favorite scp/ftp tool to copy all your files to your Andrew home directory scp projX.zip username@linux.andrew.cmu.edu:/afs/andrew.cmu.edu/usr/andrew_id/.
  5. Log in to a Unix Andrew machine: ssh username@linux.andrew.cmu.edu
  6. File Transfer. Unzip your website and copy the folder to your project directory: cp -r projX/ /afs/andrew.cmu.edu/course/16/822/www/projects/andrew_id/projX. The folder structure should look like this:
     # suppose you are at /afs/andrew.cmu.edu/course/16/822/www/projects/andrew_id
     proj1/
         index.html
         data/...
     proj2/
         index.html
         data/...
    
  7. Publish. The course website needs to be refreshed with your updated files. Do that by going here, choosing web pages for a course, and inputing 16-822.
  8. Last step, test your page by visiting: http://www.andrew.cmu.edu/course/16-822/projects/andrew_id/projX/.

FAQs

  • Remember NOT to use any absolute links to images etc, as these will not work online. Only use relative links.
  • Do not try using WinSCP or similar to copy directly from your laptop to your class project directory as you don’t have the credentials to do so.
  • Afs gets unhappy if your quota is full. Run fs quota to see the percent used; if it’s close to 100 percent, delete things (java and matlab dumps, large tif’s…) before trying the copy again.
  • If you have problems with images not appearing on your page, check that 1) filenames match your html files (e.g. .JPG vs .jpeg). 2) relative path is used from the correct root directory.
  • Please contact a TA if there are problems.