ResNet-101 Trained on ImageNet Competition Data

Identify the main object in an image

Released in 2015 by Microsoft Research Asia, the ResNet architecture (with its three realizations ResNet-50, ResNet-101 and ResNet-152) obtained very successful results in the ImageNet and MS-COCO competition. The core idea exploited in these models, residual connections, is found to greatly improve gradient flow, thus allowing training of much deeper models, with tens or even hundreds of layers. ImageNet classes are mapped to Wolfram Language Entities through their unique WordNet IDs.

Number of layers: 347 | Parameter count: 44,654,504 | Trained size: 180 MB |

Training Set Information

Performance

Examples

Resource retrieval

Get the pre-trained net:

In[1]:=
NetModel["ResNet-101 Trained on ImageNet Competition Data"]
Out[1]=

Basic usage

Classify an image:

In[2]:=
(* Evaluate this cell to get the example input *) CloudGet["https://www.wolframcloud.com/obj/495cfdc6-ef4a-40d6-804d-7a57d52b9a92"]
Out[2]=

The prediction is an Entity object, which can be queried:

In[3]:=
pred["Definition"]
Out[3]=

Get a list of available properties of the predicted Entity:

In[4]:=
pred["Properties"]
Out[4]=

Obtain the probabilities of the ten most likely entities predicted by the net:

In[5]:=
(* Evaluate this cell to get the example input *) CloudGet["https://www.wolframcloud.com/obj/f20346ee-6ae1-4263-a506-ffcfbd66c701"]
Out[5]=

An object outside the list of the ImageNet classes will be misidentified:

In[6]:=
(* Evaluate this cell to get the example input *) CloudGet["https://www.wolframcloud.com/obj/d5f7ecc6-b6de-4c1e-b590-e7993c3d083a"]
Out[6]=

Obtain the list of names of all available classes:

In[7]:=
EntityValue[
 NetExtract[
   NetModel["ResNet-101 Trained on ImageNet Competition Data"], "Output"][["Labels"]], "Name"]
Out[7]=

Feature extraction

Remove the last three layers of the trained net so that the net produces a vector representation of an image:

In[8]:=
extractor = Take[NetModel[
   "ResNet-101 Trained on ImageNet Competition Data"], {1, -4}]
Out[8]=

Get a set of images:

In[9]:=
(* Evaluate this cell to get the example input *) CloudGet["https://www.wolframcloud.com/obj/6129318d-101e-4314-9f2c-801282df67fe"]

Visualize the features of a set of images:

In[10]:=
FeatureSpacePlot[imgs, FeatureExtractor -> extractor, LabelingSize -> 100, ImageSize -> 800]
Out[10]=

Visualize convolutional weights

Extract the weights of the first convolutional layer in the trained net:

In[11]:=
weights = NetExtract[
   NetModel[
    "ResNet-101 Trained on ImageNet Competition Data"], {"conv1", "Weights"}];

Visualize the weights as a list of 64 images of size 7x7:

In[12]:=
ImageAdjust[Image[#, Interleaving -> False]] & /@ Normal[weights]
Out[12]=

Transfer learning

Use the pre-trained model to build a classifier for telling apart images of dogs and cats. Create a test set and a training set:

In[13]:=
(* Evaluate this cell to get the example input *) CloudGet["https://www.wolframcloud.com/obj/19d423e3-e04a-4d53-b9ee-bcced4b5561d"]
In[14]:=
(* Evaluate this cell to get the example input *) CloudGet["https://www.wolframcloud.com/obj/b16f50d2-03e4-4f43-a44a-345d857d6c06"]

Remove the linear layer from the pre-trained net:

In[15]:=
tempNet = Take[NetModel[
   "ResNet-101 Trained on ImageNet Competition Data"], {1, -4}]
Out[15]=

Create a new net composed of the pre-trained net followed by a linear layer and a softmax layer:

In[16]:=
newNet = NetChain[<|"pretrainedNet" -> tempNet, "linearNew" -> LinearLayer[], "softmax" -> SoftmaxLayer[]|>, "Output" -> NetDecoder[{"Class", {"cat", "dog"}}]]
Out[16]=

Train on the dataset, freezing all the weights except for those in the "linearNew" layer (use TargetDevice -> "GPU" for training on a GPU):

In[17]:=
trainedNet = NetTrain[newNet, trainSet, LearningRateMultipliers -> {"linearNew" -> 1, _ -> 0}]
Out[17]=

Perfect accuracy is obtained on the test set:

In[18]:=
ClassifierMeasurements[trainedNet, testSet, "Accuracy"]
Out[18]=

Net information

Inspect the number of parameters of all arrays in the net:

In[19]:=
NetInformation[
 NetModel["ResNet-101 Trained on ImageNet Competition Data"], \
"ArraysElementCounts"]
Out[19]=

Obtain the total number of parameters:

In[20]:=
NetInformation[
 NetModel["ResNet-101 Trained on ImageNet Competition Data"], \
"ArraysTotalElementCount"]
Out[20]=

Obtain the layer type counts:

In[21]:=
NetInformation[
 NetModel["ResNet-101 Trained on ImageNet Competition Data"], \
"LayerTypeCounts"]
Out[21]=

Display the summary graphic:

In[22]:=
NetInformation[
 NetModel["ResNet-101 Trained on ImageNet Competition Data"], \
"SummaryGraphic"]
Out[22]=

Export to MXNet

Export the net into a format that can be opened in MXNet:

In[23]:=
jsonPath = Export[FileNameJoin[{$TemporaryDirectory, "net.json"}], NetModel["ResNet-101 Trained on ImageNet Competition Data"], "MXNet"]
Out[23]=

Export also creates a net.params file containing parameters:

In[24]:=
paramPath = FileNameJoin[{DirectoryName[jsonPath], "net.params"}]
Out[24]=

Get the size of the parameter file:

In[25]:=
FileByteCount[paramPath]
Out[25]=

The size is similar to the byte count of the resource object:

In[26]:=
ResourceObject[
  "ResNet-101 Trained on ImageNet Competition Data"]["ByteCount"]
Out[26]=

Requirements

Wolfram Language 11.2 (September 2017) or above

Resource History

Reference