Note
These are my personal programming assignments at the third week after studying the course neural-networks-deep-learning and the copyright belongs to deeplearning.ai.
planar data classification with one hidden layer
1 Packages
Let’s first import all the packages that you will need during this assignment.
- numpy is the fundamental package for scientific computing with Python.
- sklearn provides simple and efficient tools for data mining and data analysis.
- matplotlib is a library for plotting graphs in Python.
- testCases_v2 provides some test examples to assess the correctness of your functions
- planar_utils provide various useful functions used in this assignment
1 | # Package imports |
You can get the support code from here.
2 Dataset
First, let’s get the dataset you will work on. The following code will load a “flower” 2-class dataset into variables X and Y.
1 | def load_planar_dataset(): #generate two random array X and Y |
Visualize the dataset using matplotlib. The data looks like a “flower” with some red (label y=0) and some blue (y=1) points. Your goal is to build a model to fit this data.
1 | X,Y = load_planar_dataset(); |
You have:
- a numpy-array (matrix) X that contains your features (x1, x2)
- a numpy-array (vector) Y that contains your labels (red:0, blue:1).
Lets first get a better sense of what our data is like.
Exercise: How many training examples do you have? In addition, what is the shape of the variables X and Y?
Hint: How do you get the shape of a numpy array? (help)
1 | ### START CODE HERE ### (≈ 3 lines of code) |
The shape of X is: (2, 400)
The shape of Y is: (1, 400)
I have m = 400 training examples!
3 Simple Logistic Regression
Before building a full neural network, lets first see how logistic regression performs on this problem. You can use sklearn’s built-in functions to do that. Run the code below to train a logistic regression classifier on the dataset.
1 | # Train the logistic regression classifier |
You can now plot the decision boundary of these models. Run the code below.
1 | # Plot the decision boundary for logistic regression |
Accuracy of logistic regression: 47 % (percentage of correctly labelled datapoints)
plot_decision_boundary:
1 | def plot_decision_boundary(model, X, y): |
4 Neural Network model
Logistic regression did not work well on the “flower dataset”. You are going to train a Neural Network with a single hidden layer.
Here is our model:
Mathematically:
For one example $x^{(i)}$:
$$z^{[1] (i)} = W^{[1]} x^{(i)} + b^{[1] (i)}\tag{1}$$
$$a^{[1] (i)} = \tanh(z^{[1] (i)})\tag{2}$$
$$z^{[2] (i)} = W^{[2]} a^{[1] (i)} + b^{[2] (i)}\tag{3}$$
$$\hat{y}^{(i)} = a^{[2] (i)} = \sigma(z^{ [2] (i)})\tag{4}$$
$$y^{(i)}_{prediction} = \begin{cases} 1 & \mbox{if } a^{[2](i)} > 0.5 \\ 0 & \mbox{otherwise } \end{cases}\tag{5}$$Given the predictions on all the examples, you can also compute the cost $J$ as follows:
$$J = - \frac{1}{m} \sum\limits_{i = 0}^{m} \large\left(\small y^{(i)}\log\left(a^{[2] (i)}\right) + (1-y^{(i)})\log\left(1- a^{[2] (i)}\right) \large \right) \small \tag{6}$$
Reminder:
The general methodology to build a Neural Network is to:
- Define the neural network structure ( # of input units, # of hidden units, etc).
- Initialize the model’s parameters
- Loop:
- Implement forward propagation
- Compute loss
- Implement backward propagation to get the gradients
- Update parameters (gradient descent)
You often build helper functions to compute steps 1-3 and then merge them into one function we call nn_model()
. Once you’ve built nn_model()
and learnt the right parameters, you can make predictions on new data.
4.1 Defining the neural network structure
Exercise: Define three variables:
- $n_x$ : the size of the input layer
- $n_h$ : the size of the hidden layer (set this to 4)
- $n_y$ : the size of the output layer
Hint: Use shapes of $X$ and $Y$ to find $n_x$ and $n_y$. Also, hard code the hidden layer size to be 4.
1 | # GRADED FUNCTION: layer_sizes |
1 | X_assess, Y_assess = layer_sizes_test_case(); |
The size of the input layer is: n_x = 5
The size of the hidden layer is: n_h = 4
The size of the output layer is: n_y = 2
4.2 Initialize the model’s parameters
Exercise: Implement the function initialize_parameters()
.
Instructions:
- Make sure your parameters’ sizes are right. Refer to the neural network figure above if needed.
- You will initialize the weights matrices with random values.
- Use:
np.random.randn(a,b) * 0.01
to randomly initialize a matrix of shape (a,b). - You will initialize the bias vectors as zeros.
- Use:
np.zeros((a,b))
to initialize a matrix of shape (a,b) with zeros.
1 | # GRADED FUNCTION: initialize_parameters |
1 | n_x, n_h, n_y = initialize_parameters_test_case(); |
W1 = [[0.00435995 0.00025926]
[0.00549662 0.00435322]
[0.00420368 0.00330335]
[0.00204649 0.00619271]]
b1 = [[0.]
[0.]
[0.]
[0.]]
W2 = [[0.00299655 0.00266827 0.00621134 0.00529142]]
b2 = [[0.]]
4.3 The Loop
Question: Implement forward_propagation()
.
Instructions:
- Look above at the mathematical representation of your classifier.
- You can use the function
sigmoid()
. It is built-in (imported) in the notebook. - You can use the function
np.tanh()
. It is part of the numpy library. - The steps you have to implement are:
- Retrieve each parameter from the dictionary “parameters” (which is the output of
initialize_parameters()
) by usingparameters[".."]
. - Implement Forward Propagation. Compute $Z^{[1]},A^{[1]},Z^{[2]}$ and $A^{[2]}$ (the vector of all your predictions on all the examples in the training set).
- Retrieve each parameter from the dictionary “parameters” (which is the output of
- Values needed in the backpropagation are stored in “cache“. The cache will be given as an input to the backpropagation function.
1 | # GRADED FUNCTION: forward_propagation |
1 | X_assess, parameters = forward_propagation_test_case(); |
0.26281864019752443 0.09199904522700109 -1.3076660128732143 0.21287768171914198
Exercise: Implement compute_cost()
to compute the value of the cost $J$.
Instructions:
- There are many ways to implement the cross-entropy loss. To help you, we give you how we would have implemented
- $\sum\limits_{i=0}^{m} y^{(i)}\log(a^{2})$
1 | logprobs = np.multiply(np.log(A2),Y); |
(you can use either np.multiply()
and then np.sum()
or directly np.dot()
).
1 | # GRADED FUNCTION: compute_cost |
1 | A2, Y_assess, parameters = compute_cost_test_case(); |
cost = 0.6930587610394646
Using the cache computed during forward propagation, you can now implement backward propagation.
Question: Implement the function backward_propagation()
.
Instructions:
Backpropagation is usually the hardest (most mathematical) part in deep learning. To help you, here again is the slide from the lecture on backpropagation. You’ll want to use the six equations on the right of this slide, since you are building a vectorized implementation.
Tips:
To compute $dZ_1$ you’ll need to compute $g’^{[1]}(Z^{[1]})$ .
Since $g^{[1]}(Z^{[1]})$ is the tanh activation function,
if $a=g^{[1]}(z)$ then $g’^{[1]}(z)=1−a^2$.
So you can compute $g’^{[1]}(Z^{[1]})$ using (1 - np.power(A1, 2))
.
1 | # GRADED FUNCTION: backward_propagation |
1 | parameters, cache, X_assess, Y_assess = backward_propagation_test_case() |
dW1 = [[ 0.00301023 -0.00747267]
[ 0.00257968 -0.00641288]
[-0.00156892 0.003893 ]
[-0.00652037 0.01618243]]
db1 = [[ 0.00176201]
[ 0.00150995]
[-0.00091736]
[-0.00381422]]
dW2 = [[ 0.00078841 0.01765429 -0.00084166 -0.01022527]]
db2 = [[-0.16655712]]
Question: Implement the update rule. Use gradient descent. You have to use (dW1, db1, dW2, db2) in order to update (W1, b1, W2, b2).
General gradient descent rule: $θ=θ−α\frac{∂J}{∂θ}$ where $α$ is the learning rate and $θ$ represents a parameter.
Illustration: The gradient descent algorithm with a good learning rate (converging) and a bad learning rate (diverging). Images courtesy of Adam Harley.
1 | # GRADED FUNCTION: update_parameters |
1 | parameters, grads = update_parameters_test_case(); |
W1 = [[-0.00643025 0.01936718]
[-0.02410458 0.03978052]
[-0.01653973 -0.02096177]
[ 0.01046864 -0.05990141]]
b1 = [[-1.02420756e-06]
[ 1.27373948e-05]
[ 8.32996807e-07]
[-3.20136836e-06]]
W2 = [[-0.01041081 -0.04463285 0.01758031 0.04747113]]
b2 = [[0.00010457]]
4.4 Integrate parts 4.1, 4.2 and 4.3 in nn_model()
Question: Build your neural network model in nn_model()
.
Instructions: The neural network model has to use the previous functions in the right order.
1 | # GRADED FUNCTION: nn_model |
1 | X_assess, Y_assess = nn_model_test_case(); |
Cost after iteration 0: 0.693175
Cost after iteration 1000: 0.000224
Cost after iteration 2000: 0.000109
Cost after iteration 3000: 0.000072
Cost after iteration 4000: 0.000054
Cost after iteration 5000: 0.000043
Cost after iteration 6000: 0.000036
Cost after iteration 7000: 0.000031
Cost after iteration 8000: 0.000027
Cost after iteration 9000: 0.000024
W1 = [[ 0.78668574 -1.44596408]
[ 0.61841465 -1.14797067]
[ 0.7941403 -1.45820079]
[ 0.54249425 -1.01738417]]
b1 = [[-0.38092208]
[-0.26640968]
[-0.38509848]
[-0.21499134]]
W2 = [[3.55445121 2.18356796 3.62513709 1.74485812]]
b2 = [[0.21512924]]
4.5 Predictions
Question: Use your model to predict by building predict()
.
Use forward propagation to predict results.
Reminder: predictions
$$ y_{prediction} =
\begin{equation}\begin{cases}
1 & \text{ if activation > 0.5 } \
0 & \text{ otherwise }
\end{cases}\end{equation}
$$
As an example, if you would like to set the entries of a matrix X to 0 and 1 based on a threshold you would do: X_new = (X > threshold)
1 | # GRADED FUNCTION: predict |
1 | parameters, X_assess = predict_test_case(); |
predictions mean = 0.6666666666666666
It is time to run the model and see how it performs on a planar dataset. Run the following code to test your model with a single hidden layer of n_h
hidden units.
1 | # Build a model with a n_h-dimensional hidden layer |
Cost after iteration 0: 0.693159
Cost after iteration 1000: 0.289308
Cost after iteration 2000: 0.273860
Cost after iteration 3000: 0.238116
Cost after iteration 4000: 0.228102
Cost after iteration 5000: 0.223318
Cost after iteration 6000: 0.220193
Cost after iteration 7000: 0.217870
Cost after iteration 8000: 0.216036
Cost after iteration 9000: 0.218642
1 | # Print accuracy |
Accuracy: 90 %
Accuracy is really high compared to Logistic Regression. The model has learnt the leaf patterns of the flower! Neural networks are able to learn even highly non-linear decision boundaries, unlike logistic regression.
Now, let’s try out several hidden layer sizes.
4.6 Tuning hidden layer size (optional/ungraded exercise)
Run the following code. It may take 1-2 minutes. You will observe different behaviors of the model for various hidden layer sizes.
1 | # This may take about 2 minutes to run |
Accuracy for 1 hidden units: 67.5 %
Accuracy for 2 hidden units: 67.25 %
Accuracy for 3 hidden units: 90.75 %
Accuracy for 4 hidden units: 90.75 %
Accuracy for 5 hidden units: 91.25 %
Accuracy for 20 hidden units: 90.25 %
Accuracy for 50 hidden units: 91.0 %
Interpretation:
- The larger models (with more hidden units) are able to fit the training set better, until eventually the largest models overfit the data.
- The best hidden layer size seems to be around
n_h = 5
. Indeed, a value around here seems to fits the data well without also incurring noticable overfitting. - You will also learn later about regularization, which lets you use very large models (such as n_h = 50) without much overfitting.
Optional questions:
Note: Remember to submit the assignment but clicking the blue “Submit Assignment” button at the upper-right.
Some optional/ungraded questions that you can explore if you wish:
- What happens when you change the tanh activation for a sigmoid activation or a ReLU activation?
- Play with the learning_rate. What happens?
- What if we change the dataset? (See part 5 below!)
You’ve learnt to:
- Build a complete neural network with a hidden layer
- Make a good use of a non-linear unit
- Implemented forward propagation and backpropagation, and trained a neural network
- See the impact of varying the hidden layer size, including overfitting.
Nice work!
5 Performance on other datasets
If you want, you can rerun the whole notebook (minus the dataset part) for each of the following datasets.
1 | def load_extra_datasets(): |
1 | # Datasets |
1 |
|
1 | ### START CODE HERE ### (choose your dataset) |
1 | ### START CODE HERE ### (choose your dataset) |