{"id":87,"date":"2016-07-29T02:58:10","date_gmt":"2016-07-29T02:58:10","guid":{"rendered":"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/?page_id=87"},"modified":"2021-08-30T22:28:06","modified_gmt":"2021-08-31T02:28:06","slug":"using-autolab","status":"publish","type":"page","link":"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/using-autolab\/","title":{"rendered":"Using Autolab"},"content":{"rendered":"<!DOCTYPE html PUBLIC \"-\/\/W3C\/\/DTD HTML 4.0 Transitional\/\/EN\" \"http:\/\/www.w3.org\/TR\/REC-html40\/loose.dtd\">\n<html><body><p>This semester, you will use two different software systems for submitting your work.<\/p>\n<p>1. Technical Assignments (&ldquo;<strong>Assignments<\/strong>&ldquo;) are submitted privately through <strong><a href=\"https:\/\/autolab.andrew.cmu.edu\/\">Autolab<\/a><\/strong>. (Be sure to sign in by clicking <strong>Sign in with your CMU account<\/strong>, <em><span style=\"color: #ff0000;\">not<\/span><\/em> the <span style=\"color: #ff0000;\">big red sign-in button<\/span>! The only people who will see this work are you, the professor, and the course teaching assistants. Instructions for using Autolab are <strong>below<\/strong>.<\/p>\n<p>2. Open-Ended Creative Assignments (&ldquo;<strong>Projects<\/strong>&ldquo;) and &ldquo;Looking Outwards&rdquo; reports are submitted publicly, through this WordPress website. Instructions for submitting assignments in this way, using this WordPress site, are <a href=\"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/authoring-on-this-site\/\">here<\/a>.<\/p>\n<hr><h2>Instructions for Using Autolab.<\/h2>\n<ol><li>If you need to submit any work electronically, create a zip file of the file(s) you wish to submit. <em>Please be sure to create a .zip file and not a .gzip, .tar or .rar file<\/em>. See below for <a href=\"#zip\">instructions on creating a zip file<\/a>.<\/li>\n<li>Go to the <strong><a href=\"https:\/\/autolab.andrew.cmu.edu\/\">Autolab<\/a><\/strong> website (<a href=\"https:\/\/autolab.andrew.cmu.edu\/\" target=\"_blank\" rel=\"noopener noreferrer\">https:\/\/autolab.andrew.cmu.edu\/<\/a>) . 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 2021) in Autolab. <em>IF YOU ARE REGISTERED BUT DO NOT SEE THIS COURSE, THEN EMAIL YOUR PROFESSOR IMMEDIATELY.<\/em><\/li>\n<li>You should see links for currently active assignment(s) that you can hand in. There may be a few instances where more than one assignment is open at the same time, so be careful to select the correct one.<\/li>\n<li>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 &ldquo;Handin your work&rdquo;.<\/li>\n<li>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 (see below). 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 ONLY GRADE YOUR LAST SUBMISSION THAT IS SUBMITTED.<\/li>\n<\/ol><p><b> DO NOT HAND IN YOUR PROGRAM FILES VIA EMAIL TO YOUR INSTRUCTOR OR TEACHING ASSISTANT. THESE WILL NOT BE GRADED! FILES SUBMITTED AFTER 11:59PM ON THE DUE DATE ARE CONSIDERED LATE. <\/b><em>Please review the course late policy for more information.<\/em><\/p>\n<h2><a name=\"zip\"><\/a>Creating a zip file.<\/h2>\n<p>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.<\/p>\n<p><span style=\"color: #ff0000;\"><em>Note that in all cases, you should name or select the<\/em> containing folder<em> for all your project files rather than selecting individual files!<\/em><\/span><\/p>\n<p>In general, you will hand in multiple assignments and projects for the week in a single zip file. The organization of your work is important. The directory\/folder hierarchy should look like this:<\/p>\n<pre class=\"toolbar:2 show-lang:2 nums:false show-plain:3 show-plain-default:true lang:sh decode:true\" title=\"Directory hierarchy for Autolab submissions.\">handin-02\n    acarnegie-02-a\n        index.html\n        sketch.js\n    acarnegie-02-LO\n        blog.txt\n    acarnegie-02-project\n        index.html\n        sketch.js<\/pre>\n<p>Checklist for submission directory:<\/p>\n<ol><li>The top-level directory\/folder name (<code>handin-02<\/code>) is not critical. This is the all-encompassing directory\/folder you will &ldquo;zip&rdquo; into a submission file. It will help to be consistent in&nbsp; your naming so you don&rsquo;t get confused with all of the files on your computer.<\/li>\n<li>In this example, there are two technical assignments. Name these according to instructions &ndash; typically the form is AndrewID-WeekNumber-AorBorCetc. This example is for Week 2 and the user ID is <code>acarnegie<\/code>.<\/li>\n<li>Clean out extraneous files before you submit your work. Making backup versions and tests is great for development, but do not confuse your grader by submitting unnecessary files. SUBMIT ONLY WHAT IS NECESSARY FOR GRADING PURPOSES.<\/li>\n<li>Normally, you will provide additional information (your name, section, goals, how to run your code, features) in comments. In this case, student <em>acarnegie<\/em> provided extra information for Assignment-02-B in <code>README.txt<\/code>.<\/li>\n<li>Before you create a zip file of the assignment directory\/folder, look at the folder and its contents to make sure your organization is correct.<\/li>\n<\/ol><h3>Mac Finder and Windows Explorer (probably)<\/h3>\n<p>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:<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-307\" src=\"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-content\/uploads\/2016\/07\/find-project.png\" alt=\"find-project\" width=\"455\" height=\"322\"><\/p>\n<p>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:<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-308\" src=\"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-content\/uploads\/2016\/07\/compress-menu-item.png\" alt=\"compress-menu-item\" width=\"321\" height=\"333\"><\/p>\n<p>Select the &ldquo;Compress&rdquo; menu item (Mac) or &ldquo;Send To.. Compressed (zipped) folder&rdquo; (Windows) to make a zip file. You should see the newly created zip file in the same parent directory (folder):<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-309\" src=\"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-content\/uploads\/2016\/07\/folder-with-zip.png\" alt=\"folder-with-zip\" width=\"450\" height=\"321\"><\/p>\n<p>Note that on Windows, if you &ldquo;open&rdquo; the zip file, Windows will &ldquo;look inside&rdquo; the zip file as if it is an ordinary directory, but on Mac OS X, if you &ldquo;open&rdquo; the zip file, it will be decompressed and expanded back into a regular directory.<\/p>\n<h3>Mac command-line instructions<\/h3>\n<p>On a Mac, open a Terminal application. Here are some commands that you would type in shown in <span style=\"color: #ff0000;\">red<\/span> with annotations (do not type the orange colored annotations) to guide you, assuming you have a <em>Documents<\/em> folder with a class folder inside of that with a <em>15104-f20<\/em> folder inside of that and a <em>p5js<\/em> folder inside of that:<br><code><br><span style=\"color: green;\">~$<\/span> <\/code><br><span style=\"color: #ff6600;\"><em>&mdash; initially you are prompted for commands (the $ means the computer is waiting)<br>\n&mdash; the computer starts you in your home directory represented by the tilde (~)&nbsp;<\/em><\/span><code><br><span style=\"color: green;\">~$<\/span> <span style=\"color: #ff0000;\"><b>cd Documents\/class\/15104-f20\/p5js\/<\/b> <\/span><\/code><br><span style=\"color: #ff6600;\"><em>&mdash; cd means change directory; change to the directory with your project<br>\n&mdash; note that the computer always tells you what subdirectory you&rsquo;re in (shown in green here)<\/em><\/span><code><br><span style=\"color: green;\">~\/Documents\/class\/15104-f20\/p5js$<\/span> <span style=\"color: #ff0000;\"><b>ls<\/b> <\/span><\/code><br><span style=\"color: #ff6600;\"><em>&mdash; ls means list directory; see what&rsquo;s in your directory<\/em><\/span><code><br><span style=\"color: #000000;\">spiral template <\/span><\/code><br><span style=\"color: #ff6600;\"><em>&mdash; I have these two sub-directories representing two assignments in my p5js directory. I want just the spiral directory in a zip file.<\/em><\/span><code><br><span style=\"color: green;\">~\/Documents\/class\/15104-f20\/p5js$<\/span> <span style=\"color: #ff0000;\"><b>zip -r spiral.zip spiral<\/b><\/span><br><\/code><span style=\"color: #ff6600;\"><em>&mdash; this command zips everything inside spiral to the zip file named spiral.zip<br>\n&mdash; output from zip showing what it is copying:<\/em><\/span><br><span style=\"color: green;\"><code>adding: spiral\/ (stored 0%) <\/code><\/span><code><br>\nadding: spiral\/.DS_Store (deflated 96%)<br>\nadding: spiral\/index.html (deflated 57%)<br>\nadding: spiral\/libraries\/ (stored 0%)<br>\nadding: spiral\/libraries\/p5.dom.js (deflated 77%)<br>\nadding: spiral\/libraries\/p5.js (deflated 77%)<br>\nadding: spiral\/libraries\/p5.sound.js (deflated 78%)<br>\nadding: spiral\/sketch.js (deflated 44%)<\/code><span style=\"color: green;\"><code><br><span style=\"color: #339966;\">~\/Documents\/class\/15104-f20\/p5js$<\/span><\/code><\/span><span style=\"color: #ff0000;\"><code><b><span style=\"color: #ff0000;\">ls<\/span><\/b><\/code><\/span><br><span style=\"color: #ff6600;\"><em>&mdash; now list what&rsquo;s here; see if spiral.zip created<\/em><\/span><code><br><span style=\"color: green;\"><span style=\"color: #000000;\">spiral spiral.zip template<\/span> <\/span><\/code><br><span style=\"color: #ff6600;\"><em>&mdash; spiral.zip has been added<br>\n&mdash; now let&rsquo;s unzip the file and make sure it&rsquo;s all OK (you won&rsquo;t have to do this later on once you get comfortable with this process, but it doesn&rsquo;t hurt)<\/em><\/span><code><br><span style=\"color: green;\">~\/Documents\/class\/15104-f20\/p5js$<\/span> <span style=\"color: #ff0000;\"><b>mkdir tmp<\/b> <\/span><\/code><br><em><span style=\"color: green;\"><span style=\"color: #ff6600;\">&mdash; make a directory named tmp in the current directory shown<\/span><br><code><span style=\"color: #339966;\">~\/Documents\/class\/15104-f20\/p5js$<\/span> <span style=\"color: #ff0000;\"><b>ls<\/b> <\/span><\/code><br><span style=\"color: #ff6600;\">&mdash; list to see what&rsquo;s in your main project directory<\/span><br><code>spiral spiral.zip template tmp<\/code><br><span style=\"color: #ff6600;\">&mdash; the tmp directory has been added&nbsp;<\/span><\/span><\/em><code><br><span style=\"color: green;\">~\/Documents\/class\/15104-f20\/p5js$<\/span> <span style=\"color: #ff0000;\"><b>cd tmp<\/b> <\/span><\/code><br><span style=\"color: #ff6600;\"><em>&mdash; change current directory to tmp<\/em><\/span><code><br><span style=\"color: green;\">~\/Documents\/class\/15104-f20\/p5js\/tmp$<\/span> <span style=\"color: #ff0000;\"><b>unzip ..\/spiral.zip<\/b> <\/span><\/code><br><em><span style=\"color: green;\"><span style=\"color: #ff6600;\">&mdash; unzip the file. &ldquo;..\/spiral.zip&rdquo; means look in the parent directory (&ldquo;..&rdquo;) for spiral.zip, the file to unzip. The unzip utility tells us what it copies out of spiral.zip<\/span><br><\/span><\/em><span style=\"color: #0000ff;\"><code>Archive: ..\/spiral.zip <\/code><\/span><br><span style=\"color: #0000ff;\"><code>creating: spiral\/<br>\ninflating: spiral\/.DS_Store<br>\ninflating: spiral\/index.html<br>\ncreating: spiral\/libraries\/<br>\ninflating: spiral\/libraries\/p5.dom.js<br>\ninflating: spiral\/libraries\/p5.js<br>\ninflating: spiral\/libraries\/p5.sound.js<\/code><code><br>\ninflating: spiral\/sketch.js<\/code><\/span><span style=\"color: green;\"><code><br><span style=\"color: #339966;\">~\/Documents\/class\/15104-f20\/p5js\/tmp$<\/span><\/code><\/span><span style=\"color: #ff0000;\"><code><b><span style=\"color: #ff0000;\">ls<\/span><\/b><\/code><\/span><br><span style=\"color: #ff6600;\"><em>&mdash; list the tmp directory<\/em><\/span><code><br><span style=\"color: #000000;\">spiral <\/span><\/code><br><span style=\"color: #ff6600;\"><em>&mdash; good, we confirmed that spiral is in the zip file<\/em><\/span><code><br><span style=\"color: green;\">~\/Documents\/class\/15104-f20\/p5js\/tmp$<\/span> <span style=\"color: #ff0000;\"><b>ls spiral<\/b> <\/span><\/code><br><span style=\"color: #ff6600;\"><em>&mdash; what is in spiral; did we get everything?<\/em><\/span><code><br><span style=\"color: green;\"><span style=\"color: #000000;\"> index.html libraries sketch.js<\/span> <\/span><\/code><br><span style=\"color: #ff6600;\"><em>&mdash; contents of the spiral directory<\/em><\/span><code><\/code><\/p>\n<h3>Windows 7-Zip Utility<\/h3>\n<p>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 <a href=\"http:\/\/www.7-zip.org\/\">http:\/\/www.7-zip.org\/<\/a>.<\/p>\n<p>The 7-zip screen looks like this:<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-310\" src=\"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-content\/uploads\/2016\/07\/1_7-zip-app.png\" alt=\"1_7-zip-app\" width=\"371\" height=\"334\"><br>\nNavigate in the window to find your project directory, and select it:<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-311\" src=\"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-content\/uploads\/2016\/07\/2_select-project.png\" alt=\"2_select-project\" width=\"371\" height=\"334\"><br>\nClick on the &ldquo;Add&rdquo; button to create a zip file:<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-312\" src=\"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-content\/uploads\/2016\/07\/3_add-project.png\" alt=\"3_add-project\" width=\"372\" height=\"334\"><br>\nA dialog box will appear. Just click &ldquo;OK&rdquo;:<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-313\" src=\"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-content\/uploads\/2016\/07\/4_add-dialog-552x480.png\" alt=\"4_add-dialog-552x480\" width=\"552\" height=\"480\"><br>\nYour 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:<\/p>\n<p><img loading=\"lazy\" class=\"alignnone size-full wp-image-314\" src=\"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-content\/uploads\/2016\/07\/5_7-zip-result.png\" alt=\"5_7-zip-result\" width=\"372\" height=\"334\"><\/p><\/body><\/html>\n","protected":false},"excerpt":{"rendered":"<p>This semester, you will use two different software systems for submitting your work. 1. Technical Assignments (&ldquo;Assignments&ldquo;) are submitted privately through Autolab. (Be sure to sign in by clicking Sign in with your CMU account, not the big red sign-in button! The only people who will see this work are you, the professor, and the &hellip; <a href=\"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/using-autolab\/\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;Using Autolab&#8221;<\/span><\/a><\/p>\n","protected":false},"author":535,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-json\/wp\/v2\/pages\/87"}],"collection":[{"href":"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-json\/wp\/v2\/users\/535"}],"replies":[{"embeddable":true,"href":"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-json\/wp\/v2\/comments?post=87"}],"version-history":[{"count":17,"href":"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-json\/wp\/v2\/pages\/87\/revisions"}],"predecessor-version":[{"id":64680,"href":"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-json\/wp\/v2\/pages\/87\/revisions\/64680"}],"wp:attachment":[{"href":"https:\/\/courses.ideate.cmu.edu\/15-104\/f2022\/wp-json\/wp\/v2\/media?parent=87"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}