Using Autolab

This semester, you will use two different software systems for submitting your work.

1. Technical Assignments (“Assignments“) are submitted privately through Autolab. The only people who will see this work are you, the professors, and the course teaching assistants. Instructions for using Autolab are below.

2. Open-Ended Creative Assignments (“Projects“)  and “Looking Outwards” reports are submitted publicly, through this WordPress website. Instructions for submitting assignments in this way, using this WordPress site, are here.


Instructions for Using Autolab.

  1. If you need to submit any work electronically, create a zip file of the file(s) you wish to submit. Please be sure to create a .zip file and not a .gzip, .tar or .rar file. See below for instructions on creating a zip file.
  2. Go to the Autolab website (https://autolab.cs.cmu.edu/) . You must log in (authenticate) using your CMU Andrew ID and password. If you are registered for this course, you should be able to log in and see that you are registered in 15-104 (Fall 2015) or 60-212 in Autolab. IF YOU ARE REGISTERED BUT DO NOT SEE THIS COURSE, THEN EMAIL YOUR PROFESSOR IMMEDIATELY.
  3. You should see links for currently active assignments that you can hand in. Note that on most weeks, there will be multiple assignments. Click on the link for the assignment you want to hand in.
  4. Once you click on an assignment, you will see an Options menu. From here, you can download the assignment handout (i.e. starter code, if any), handin your .zip file, view your handin history or view the assignment/lab writeup instructions. To hand in, select “Handin your work”.
  5. You will see a text field to enter the filename you wish to submit. You can use the browse button to find the .zip file you want to submit. Once you select the correct file, click the Handin button to submit your work. You may submit as many times as you wish up until the deadline. WE WILL GRADE YOUR LAST SUBMISSION THAT WAS SUBMITTED ON TIME.

DO NOT HAND IN YOUR PROGRAM FILES VIA EMAIL TO YOUR INSTRUCTOR OR COURSE ASSISTANT. THESE WILL NOT BE GRADED! FILES SUBMITTED AFTER 11:59PM ON THE DUE DATE ARE CONSIDERED LATE. Please review the course late policy for more information.

Creating a zip file.

A zip file is a single file that contains copies of a collection of files in a compressed format. Since assignments often contain multiple files, a zip file is a way to transfer not just the content but the organization of the collection of files needed to run your programs. You can make zip files using command line tools or graphical desktop tools.

Note that in all cases, you should name or select the containing folder for all your project files rather than selecting individual files!

Mac Finder and Windows Explorer (probably)

Using the Mac Finder or Windows Explorer (the graphical desktop tool that lets you navigate through your files), first locate the directory you wish to put into a zip file:

Finder window with project directory.
Finder window with project directory selected.

Next, hold down the right mouse button (or on a Mac hold down the Control key, then use the mouse or trackpad button) to get a menu:

Pop-up menu.
The Compress item appears 4th in the pop-up right- or control-mouse menu.

Select the “Compress” menu item (Mac) or “Send To.. Compressed (zipped) folder” (Windows) to make a zip file. You should see the newly created zip file in the same parent directory (folder):

Folder in Finder.
After selecting the Compress menu item, your zip file will be created in the same directory as the source file or folder.

Note that on Windows, if you “open” the zip file, Windows will “look inside” the zip file as if it is an ordinary directory, but on Mac OS X, if you “open” the zip file, it will be decompressed and expanded back into a regular directory.

Mac command-line instructions

On a Mac, open a Terminal application. Here are some commands with annotations (do not type the colored annotations) to guide you:

~$   
— intially you are prompted for commands
~$ cd doc/class/104f15/p5js/  
— cd means change directory; change to the directory with your project
~/doc/class/104f15/p5js$ ls  
— ls means list directory; see what’s in your directory
spiral   template  
— I have these two sub-directories in my p5js directory
      — I want just the spiral directory in a zip file.

~/doc/class/104f15/p5js$ zip -r spiral.zip spiral  
— this command zips everything inside spiral to the zip file named spiral.zip
  adding: spiral/ (stored 0%)  — output from zip showing what it is copying
  adding: spiral/.DS_Store (deflated 96%)
  adding: spiral/index.html (deflated 57%)
  adding: spiral/libraries/ (stored 0%)
  adding: spiral/libraries/p5.dom.js (deflated 77%)
  adding: spiral/libraries/p5.js (deflated 77%)
  adding: spiral/libraries/p5.sound.js (deflated 78%)
  adding: spiral/sketch.js (deflated 44%)
~/doc/class/104f15/p5js$
ls  — now list what’s here; see if spiral.zip created
spiral     spiral.zip template  
— spiral.zip has been added
      — now let’s unzip the file and make sure it’s all OK.

~/doc/class/104f15/p5js$ mkdir tmp  
— make a directory named tmp
~/doc/class/104f15/p5js$ cd tmp  
— change current directory to tmp
~/doc/class/104f15/p5js/tmp$ unzip ../spiral.zip  
— unzip the file. “../spiral.zip” means look in the parent directory for spiral.zip, the file to unzip
Archive:  ../spiral.zip  — unzip tells us what it copies out of spiral.zip
   creating: spiral/
  inflating: spiral/.DS_Store
  inflating: spiral/index.html
   creating: spiral/libraries/
  inflating: spiral/libraries/p5.dom.js
  inflating: spiral/libraries/p5.js
  inflating: spiral/libraries/p5.sound.js
  inflating: spiral/sketch.js
~/doc/class/104f15/p5js/tmp$
 ls  — list the tmp directory
spiral  
— good, we confirmed that spiral is in the zip file
~/doc/class/104f15/p5js/tmp$ ls spiral  
— what is in spiral; did we get everything?
index.html libraries  sketch.js  
— contents of the spiral directory
~/doc/class/104f15/p5js/tmp$

Windows 7-Zip Utility

There are many programs for Windows that work with zip files, but none are built-in. A simple-to-use program is 7-zip, which you can download from http://www.7-zip.org/.

The 7-zip screen looks like this:

7-Zip starting screen.
7-Zip screen opened in Windows.

Navigate in the window to find your project directory, and select it:

Navigation in 7-Zip.
Navigate to your project and select it.

Click on the “Add” button to create a zip file:

Clicking the Add button.
Click on the Add button (upper left).

A dialog box will appear. Just click “OK”:

The add dialog box.
A dialog box opens in response to the “Add” button. Just click “OK”.

Your new zip file will appear in the 7-Zip window. (Your zip file will probably have a different icon.) The location of zip file will be the same location as your project directory:

The new zip file appears in the 7-Zip window.
The new zip file should appear in the 7-Zip window.