2019 hw1 release

Author: Winnie Lin

assignments/2019/assignment1.md

@@ -0,0 +1,84 @@
+---
+layout: page
+mathjax: true
+permalink: /assignments2019/assignment1/
+---
+
+In this assignment you will practice putting together a simple image classification pipeline, based on the k-Nearest Neighbor or the SVM/Softmax classifier. The goals of this assignment are as follows:
+
+- understand the basic **Image Classification pipeline** and the data-driven approach (train/predict stages)
+- understand the train/val/test **splits** and the use of validation data for **hyperparameter tuning**.
+- develop proficiency in writing efficient **vectorized** code with numpy
+- implement and apply a k-Nearest Neighbor (**kNN**) classifier
+- implement and apply a Multiclass Support Vector Machine (**SVM**) classifier
+- implement and apply a **Softmax** classifier
+- implement and apply a **Two layer neural network** classifier
+- understand the differences and tradeoffs between these classifiers
+- get a basic understanding of performance improvements from using **higher-level representations** than raw pixels (e.g. color histograms, Histogram of Gradient (HOG) features)
+
+## Setup
+
+Get the code as a zip file [here](http://cs231n.github.io/assignments/2018/spring1819_assignment1.zip).
+
+You can follow the setup instructions [here](http://cs231n.github.io/setup-instructions/).
+
+### Download data:
+Once you have the starter code (regardless of which method you choose above), you will need to download the CIFAR-10 dataset.
+Run the following from the `assignment1` directory:
+
+```bash
+cd cs231n/datasets
+./get_datasets.sh
+```
+
+### Start IPython:
+After you have the CIFAR-10 data, you should start the IPython notebook server from the
+`assignment1` directory, with the `jupyter notebook` command. (See the [Google Cloud Tutorial](http://cs231n.github.io/gce-tutorial/) for any additional steps you may need to do for setting this up, if you are working remotely)
+
+If you are unfamiliar with IPython, you can also refer to our
+[IPython tutorial](/ipython-tutorial).
+
+### Some Notes
+**NOTE 1:** There are `# *****START OF YOUR CODE`/`# *****END OF YOUR CODE` tags denoting the start and end of code sections you should fill out. Take care to not delete or modify these tags, or your assignment may not be properly graded.
+
+**NOTE 2:** The submission process this year has **2 steps**, requiring you to 1. run a submission script and 2. download/upload an auto-generated pdf (details below.) We suggest **_making a test submission early on_** to make sure you are able to successfully submit your assignment on time (a maximum of 10 submissions can be made.)
+
+**NOTE 3:** This year, the `assignment1` code has been tested to be compatible with python version `3.7` (it may work with other versions of `3.x`, but we won't be officially supporting them). You will need to make sure that during your virtual environment setup that the correct version of `python` is used. You can confirm your python version by (1) activating your virtualenv and (2) running `which python`.
+
+**NOTE 4:** If you are working in a virtual environment on OSX, you may *potentially* encounter
+errors with matplotlib due to the [issues described here](http://matplotlib.org/faq/virtualenv_faq.html). In our testing, it seems that this issue is no longer present with the most recent version of matplotlib, but if you do end up running into this issue you may have to use the `start_ipython_osx.sh` script from the `assignment1` directory (instead of `jupyter notebook` above) to launch your IPython notebook server. Note that you may have to modify some variables within the script to match your version of python/installation directory. The script assumes that your virtual environment is named `.env`.
+
+### Q1: k-Nearest Neighbor classifier (20 points)
+
+The IPython Notebook **knn.ipynb** will walk you through implementing the kNN classifier.
+
+### Q2: Training a Support Vector Machine (25 points)
+
+The IPython Notebook **svm.ipynb** will walk you through implementing the SVM classifier.
+
+### Q3: Implement a Softmax classifier (20 points)
+
+The IPython Notebook **softmax.ipynb** will walk you through implementing the Softmax classifier.
+
+### Q4: Two-Layer Neural Network (25 points)
+The IPython Notebook **two\_layer\_net.ipynb** will walk you through the implementation of a two-layer neural network classifier.
+
+### Q5: Higher Level Representations: Image Features (10 points)
+
+The IPython Notebook **features.ipynb** will walk you through this exercise, in which you will examine the improvements gained by using higher-level representations as opposed to using raw pixel values.
+
+### Submitting your work
+
+**Important:** _Please make sure that the submitted notebooks have been run and the cell outputs are visible._
+
+There are **_two_** steps to submitting your assignment:
+
+**1.** Run the provided `collectSubmission.sh` script in the `assignment1` directory.
+
+You will be prompted for your SunetID (e.g. `jdoe`) and will need to provide your Stanford password. This script will generate a zip file of your code, submit your source code to Stanford AFS, and generate a pdf `a1.pdf` in a `cs231n-2019-assignment1/` folder in your AFS home directory. 
+
+If your submission for this step was successful, you should see a display message 
+
+`### Code submitted at [TIME], [N] submission attempts remaining. ###`
+
+**2.** Download the generated `a1.pdf` from AFS, then submit the pdf to [Gradescope](https://gradescope.com/courses/17367). If you are enrolled in the course, you should have already been automatically added to the course on Gradescope. 

assignments/2019/spring1819_assignment1.zip

@@ -13,6 +13,22 @@
 
 <div class="home">
   <div class="materials-wrap">
+    <div class="module-header">Spring 2019 Assignments</div>
+
+    <div class="materials-item">
+      <a href="assignments2019/assignment1/">
+        Assignment #1: Image Classification, kNN, SVM, Softmax, Neural Network
+      </a>
+    </div>
+
+    <div class="materials-item">
+        Assignment #2: TBA
+    </div>
+
+    <div class="materials-item">
+        Assignment #3: TBA
+    </div>
+    <!--
     <div class="module-header">Spring 2018 Assignments</div>
 
     <div class="materials-item">
@@ -27,13 +43,14 @@
         Convolutional Nets
       </a>
     </div>
-	  <!---->
+
     <div class="materials-item">
       <a href="assignments2018/assignment3/">
         Assignment #3: Image Captioning with Vanilla RNNs, Image Captioning 
 	with LSTMs, Network Visualization, Style Transfer, Generative Adversarial Networks
       </a>
     </div>
+    -->
 
     <!--
     <div class="module-header">Winter 2016 Assignments</div>

index.html

@@ -11,7 +11,7 @@ You can work on the assignment in one of two ways: locally on your own machine,
 
 **Note:** after following these instructions, make sure you go to **Download data** below (you can skip the **Working locally** section).
 
-As part of this course, you can use Google Cloud for your assignments. We recommend this route for anyone who is having trouble with installation set-up, or if you would like to use better CPU/GPU resources than you may have locally. Please see the set-up tutorial [here](http://cs231n.github.io/gce-tutorial/) for more details. :)
+As part of this course, you can use Google Cloud for your assignments. We recommend this route for anyone who is having trouble with installation set-up, or if you would like to use better CPU/GPU resources than you may have locally. Please see the set-up tutorial [here](https://github.com/cs231n/gcloud/) for more details. :)
 
 ### Working locally