Real-time collaboration for Jupyter Notebooks, Linux Terminals, LaTeX, VS Code, R IDE, and more,
all in one place. Commercial Alternative to JupyterHub.
Real-time collaboration for Jupyter Notebooks, Linux Terminals, LaTeX, VS Code, R IDE, and more,
all in one place. Commercial Alternative to JupyterHub.
Path: blob/master/C4 - Convolutional Neural Networks/Week 2/ResNets/Residual_Networks_v2a.ipynb
Views: 4818
Residual Networks
Welcome to the second assignment of this week! You will learn how to build very deep convolutional networks, using Residual Networks (ResNets). In theory, very deep networks can represent very complex functions; but in practice, they are hard to train. Residual Networks, introduced by He et al., allow you to train much deeper networks than were previously practically feasible.
In this assignment, you will:
Implement the basic building blocks of ResNets.
Put together these building blocks to implement and train a state-of-the-art neural network for image classification.
Updates
If you were working on the notebook before this update...
The current notebook is version "2a".
You can find your original work saved in the notebook with the previous version name ("v2")
To view the file directory, go to the menu "File->Open", and this will open a new tab that shows the file directory.
List of updates
For testing on an image, replaced
preprocess_input(x)
withx=x/255.0
to normalize the input image in the same way that the model's training data was normalized.Refers to "shallower" layers as those layers closer to the input, and "deeper" layers as those closer to the output (Using "shallower" layers instead of "lower" or "earlier").
Added/updated instructions.
This assignment will be done in Keras.
Before jumping into the problem, let's run the cell below to load the required packages.
1 - The problem of very deep neural networks
Last week, you built your first convolutional neural network. In recent years, neural networks have become deeper, with state-of-the-art networks going from just a few layers (e.g., AlexNet) to over a hundred layers.
The main benefit of a very deep network is that it can represent very complex functions. It can also learn features at many different levels of abstraction, from edges (at the shallower layers, closer to the input) to very complex features (at the deeper layers, closer to the output).
However, using a deeper network doesn't always help. A huge barrier to training them is vanishing gradients: very deep networks often have a gradient signal that goes to zero quickly, thus making gradient descent prohibitively slow.
More specifically, during gradient descent, as you backprop from the final layer back to the first layer, you are multiplying by the weight matrix on each step, and thus the gradient can decrease exponentially quickly to zero (or, in rare cases, grow exponentially quickly and "explode" to take very large values).
During training, you might therefore see the magnitude (or norm) of the gradient for the shallower layers decrease to zero very rapidly as training proceeds:

The speed of learning decreases very rapidly for the shallower layers as the network trains
You are now going to solve this problem by building a Residual Network!
2 - Building a Residual Network
In ResNets, a "shortcut" or a "skip connection" allows the model to skip layers:

The image on the left shows the "main path" through the network. The image on the right adds a shortcut to the main path. By stacking these ResNet blocks on top of each other, you can form a very deep network.
We also saw in lecture that having ResNet blocks with the shortcut also makes it very easy for one of the blocks to learn an identity function. This means that you can stack on additional ResNet blocks with little risk of harming training set performance.
(There is also some evidence that the ease of learning an identity function accounts for ResNets' remarkable performance even more so than skip connections helping with vanishing gradients).
Two main types of blocks are used in a ResNet, depending mainly on whether the input/output dimensions are same or different. You are going to implement both of them: the "identity block" and the "convolutional block."
2.1 - The identity block
The identity block is the standard block used in ResNets, and corresponds to the case where the input activation (say ) has the same dimension as the output activation (say ). To flesh out the different steps of what happens in a ResNet's identity block, here is an alternative diagram showing the individual steps:

The upper path is the "shortcut path." The lower path is the "main path." In this diagram, we have also made explicit the CONV2D and ReLU steps in each layer. To speed up training we have also added a BatchNorm step. Don't worry about this being complicated to implement--you'll see that BatchNorm is just one line of code in Keras!
In this exercise, you'll actually implement a slightly more powerful version of this identity block, in which the skip connection "skips over" 3 hidden layers rather than 2 layers. It looks like this:

Here are the individual steps.
First component of main path:
The first CONV2D has filters of shape (1,1) and a stride of (1,1). Its padding is "valid" and its name should be
conv_name_base + '2a'
. Use 0 as the seed for the random initialization.The first BatchNorm is normalizing the 'channels' axis. Its name should be
bn_name_base + '2a'
.Then apply the ReLU activation function. This has no name and no hyperparameters.
Second component of main path:
The second CONV2D has filters of shape and a stride of (1,1). Its padding is "same" and its name should be
conv_name_base + '2b'
. Use 0 as the seed for the random initialization.The second BatchNorm is normalizing the 'channels' axis. Its name should be
bn_name_base + '2b'
.Then apply the ReLU activation function. This has no name and no hyperparameters.
Third component of main path:
The third CONV2D has filters of shape (1,1) and a stride of (1,1). Its padding is "valid" and its name should be
conv_name_base + '2c'
. Use 0 as the seed for the random initialization.The third BatchNorm is normalizing the 'channels' axis. Its name should be
bn_name_base + '2c'
.Note that there is no ReLU activation function in this component.
Final step:
The
X_shortcut
and the output from the 3rd layerX
are added together.Hint: The syntax will look something like
Add()([var1,var2])
Then apply the ReLU activation function. This has no name and no hyperparameters.
Exercise: Implement the ResNet identity block. We have implemented the first component of the main path. Please read this carefully to make sure you understand what it is doing. You should implement the rest.
To implement the Conv2D step: Conv2D
To implement BatchNorm: BatchNormalization (axis: Integer, the axis that should be normalized (typically the 'channels' axis))
For the activation, use:
Activation('relu')(X)
To add the value passed forward by the shortcut: Add
Expected Output:
**out** | [ 0.94822985 0. 1.16101444 2.747859 0. 1.36677003] |
2.2 - The convolutional block
The ResNet "convolutional block" is the second block type. You can use this type of block when the input and output dimensions don't match up. The difference with the identity block is that there is a CONV2D layer in the shortcut path:

The CONV2D layer in the shortcut path is used to resize the input to a different dimension, so that the dimensions match up in the final addition needed to add the shortcut value back to the main path. (This plays a similar role as the matrix discussed in lecture.)
For example, to reduce the activation dimensions's height and width by a factor of 2, you can use a 1x1 convolution with a stride of 2.
The CONV2D layer on the shortcut path does not use any non-linear activation function. Its main role is to just apply a (learned) linear function that reduces the dimension of the input, so that the dimensions match up for the later addition step.
The details of the convolutional block are as follows.
First component of main path:
The first CONV2D has filters of shape (1,1) and a stride of (s,s). Its padding is "valid" and its name should be
conv_name_base + '2a'
. Use 0 as theglorot_uniform
seed.The first BatchNorm is normalizing the 'channels' axis. Its name should be
bn_name_base + '2a'
.Then apply the ReLU activation function. This has no name and no hyperparameters.
Second component of main path:
The second CONV2D has filters of shape (f,f) and a stride of (1,1). Its padding is "same" and it's name should be
conv_name_base + '2b'
. Use 0 as theglorot_uniform
seed.The second BatchNorm is normalizing the 'channels' axis. Its name should be
bn_name_base + '2b'
.Then apply the ReLU activation function. This has no name and no hyperparameters.
Third component of main path:
The third CONV2D has filters of shape (1,1) and a stride of (1,1). Its padding is "valid" and it's name should be
conv_name_base + '2c'
. Use 0 as theglorot_uniform
seed.The third BatchNorm is normalizing the 'channels' axis. Its name should be
bn_name_base + '2c'
. Note that there is no ReLU activation function in this component.
Shortcut path:
The CONV2D has filters of shape (1,1) and a stride of (s,s). Its padding is "valid" and its name should be
conv_name_base + '1'
. Use 0 as theglorot_uniform
seed.The BatchNorm is normalizing the 'channels' axis. Its name should be
bn_name_base + '1'
.
Final step:
The shortcut and the main path values are added together.
Then apply the ReLU activation function. This has no name and no hyperparameters.
Exercise: Implement the convolutional block. We have implemented the first component of the main path; you should implement the rest. As before, always use 0 as the seed for the random initialization, to ensure consistency with our grader.
BatchNormalization (axis: Integer, the axis that should be normalized (typically the features axis))
For the activation, use:
Activation('relu')(X)
Expected Output:
**out** | [ 0.09018463 1.23489773 0.46822017 0.0367176 0. 0.65516603] |
3 - Building your first ResNet model (50 layers)
You now have the necessary blocks to build a very deep ResNet. The following figure describes in detail the architecture of this neural network. "ID BLOCK" in the diagram stands for "Identity block," and "ID BLOCK x3" means you should stack 3 identity blocks together.

The details of this ResNet-50 model are:
Zero-padding pads the input with a pad of (3,3)
Stage 1:
The 2D Convolution has 64 filters of shape (7,7) and uses a stride of (2,2). Its name is "conv1".
BatchNorm is applied to the 'channels' axis of the input.
MaxPooling uses a (3,3) window and a (2,2) stride.
Stage 2:
The convolutional block uses three sets of filters of size [64,64,256], "f" is 3, "s" is 1 and the block is "a".
The 2 identity blocks use three sets of filters of size [64,64,256], "f" is 3 and the blocks are "b" and "c".
Stage 3:
The convolutional block uses three sets of filters of size [128,128,512], "f" is 3, "s" is 2 and the block is "a".
The 3 identity blocks use three sets of filters of size [128,128,512], "f" is 3 and the blocks are "b", "c" and "d".
Stage 4:
The convolutional block uses three sets of filters of size [256, 256, 1024], "f" is 3, "s" is 2 and the block is "a".
The 5 identity blocks use three sets of filters of size [256, 256, 1024], "f" is 3 and the blocks are "b", "c", "d", "e" and "f".
Stage 5:
The convolutional block uses three sets of filters of size [512, 512, 2048], "f" is 3, "s" is 2 and the block is "a".
The 2 identity blocks use three sets of filters of size [512, 512, 2048], "f" is 3 and the blocks are "b" and "c".
The 2D Average Pooling uses a window of shape (2,2) and its name is "avg_pool".
The 'flatten' layer doesn't have any hyperparameters or name.
The Fully Connected (Dense) layer reduces its input to the number of classes using a softmax activation. Its name should be
'fc' + str(classes)
.
Exercise: Implement the ResNet with 50 layers described in the figure above. We have implemented Stages 1 and 2. Please implement the rest. (The syntax for implementing Stages 3-5 should be quite similar to that of Stage 2.) Make sure you follow the naming convention in the text above.
You'll need to use this function:
Average pooling see reference
Here are some other functions we used in the code below:
Conv2D: See reference
BatchNorm: See reference (axis: Integer, the axis that should be normalized (typically the features axis))
Zero padding: See reference
Max pooling: See reference
Fully connected layer: See reference
Addition: See reference
Run the following code to build the model's graph. If your implementation is not correct you will know it by checking your accuracy when running model.fit(...)
below.
As seen in the Keras Tutorial Notebook, prior training a model, you need to configure the learning process by compiling the model.
The model is now ready to be trained. The only thing you need is a dataset.
Let's load the SIGNS Dataset.

Run the following cell to train your model on 2 epochs with a batch size of 32. On a CPU it should take you around 5min per epoch.
Expected Output:
** Epoch 1/2** | loss: between 1 and 5, acc: between 0.2 and 0.5, although your results can be different from ours. |
** Epoch 2/2** | loss: between 1 and 5, acc: between 0.2 and 0.5, you should see your loss decreasing and the accuracy increasing. |
Let's see how this model (trained on only two epochs) performs on the test set.
Expected Output:
**Test Accuracy** | between 0.16 and 0.25 |
For the purpose of this assignment, we've asked you to train the model for just two epochs. You can see that it achieves poor performances. Please go ahead and submit your assignment; to check correctness, the online grader will run your code only for a small number of epochs as well.
After you have finished this official (graded) part of this assignment, you can also optionally train the ResNet for more iterations, if you want. We get a lot better performance when we train for ~20 epochs, but this will take more than an hour when training on a CPU.
Using a GPU, we've trained our own ResNet50 model's weights on the SIGNS dataset. You can load and run our trained model on the test set in the cells below. It may take ≈1min to load the model.
ResNet50 is a powerful model for image classification when it is trained for an adequate number of iterations. We hope you can use what you've learnt and apply it to your own classification problem to perform state-of-the-art accuracy.
Congratulations on finishing this assignment! You've now implemented a state-of-the-art image classification system!
4 - Test on your own image (Optional/Ungraded)
If you wish, you can also take a picture of your own hand and see the output of the model. To do this: 1. Click on "File" in the upper bar of this notebook, then click "Open" to go on your Coursera Hub. 2. Add your image to this Jupyter Notebook's directory, in the "images" folder 3. Write your image's name in the following code 4. Run the code and check if the algorithm is right!
You can also print a summary of your model by running the following code.
Finally, run the code below to visualize your ResNet50. You can also download a .png picture of your model by going to "File -> Open...-> model.png".
What you should remember
Very deep "plain" networks don't work in practice because they are hard to train due to vanishing gradients.
The skip-connections help to address the Vanishing Gradient problem. They also make it easy for a ResNet block to learn an identity function.
There are two main types of blocks: The identity block and the convolutional block.
Very deep Residual Networks are built by stacking these blocks together.
References
This notebook presents the ResNet algorithm due to He et al. (2015). The implementation here also took significant inspiration and follows the structure given in the GitHub repository of Francois Chollet:
Kaiming He, Xiangyu Zhang, Shaoqing Ren, Jian Sun - Deep Residual Learning for Image Recognition (2015)
Francois Chollet's GitHub repository: https://github.com/fchollet/deep-learning-models/blob/master/resnet50.py