Main Content

resnet50

(Not recommended) ResNet-50 convolutional neural network

  • ResNet-50 architecture

resnet50 is not recommended. Use the imagePretrainedNetwork function instead and specify the "resnet50" model. For more information, see Version History.

Description

ResNet-50 is a convolutional neural network that is 50 layers deep. You can load a pretrained version of the neural network trained on more than a million images from the ImageNet database [1]. The pretrained neural network can classify images into 1000 object categories, such as keyboard, mouse, pencil, and many animals. As a result, the neural network has learned rich feature representations for a wide range of images. The neural network has an image input size of 224-by-224. For more pretrained neural networks in MATLAB®, see Pretrained Deep Neural Networks.

example

net = resnet50 returns a ResNet-50 neural network trained on the ImageNet data set.

This function requires the Deep Learning Toolbox™ Model for ResNet-50 Network support package. If this support package is not installed, then the function provides a download link.

net = resnet50('Weights','imagenet') returns a ResNet-50 neural network trained on the ImageNet data set. This syntax is equivalent to net = resnet50.

lgraph = resnet50('Weights','none') returns the untrained ResNet-50 neural network architecture. The untrained model does not require the support package.

Examples

collapse all

Download and install the Deep Learning Toolbox Model for ResNet-50 Network support package.

Type resnet50 at the command line.

resnet50

If the Deep Learning Toolbox Model for ResNet-50 Network support package is not installed, then the function provides a link to the required support package in the Add-On Explorer. To install the support package, click the link, and then click Install. Check that the installation is successful by typing resnet50 at the command line. If the required support package is installed, then the function returns a DAGNetwork object.

resnet50
ans = 

  DAGNetwork with properties:

         Layers: [177×1 nnet.cnn.layer.Layer]
    Connections: [192×2 table]

Visualize the neural network using Deep Network Designer.

deepNetworkDesigner(resnet50)

Explore other pretrained neural networks in Deep Network Designer by clicking New.

Deep Network Designer start page showing available pretrained neural networks

If you need to download a neural network, pause on the desired neural network and click Install to open the Add-On Explorer.

Output Arguments

collapse all

Pretrained ResNet-50 convolutional neural network, returned as a DAGNetwork object.

Untrained ResNet-50 convolutional neural network architecture, returned as a LayerGraph object.

References

[1] ImageNet. http://www.image-net.org.

[2] He, Kaiming, Xiangyu Zhang, Shaoqing Ren, and Jian Sun. "Deep residual learning for image recognition." In Proceedings of the IEEE conference on computer vision and pattern recognition, pp. 770-778. 2016.

Extended Capabilities

Version History

Introduced in R2017b

collapse all

R2024a: Not Recommended

resnet50 is not recommended. Use the imagePretrainedNetwork function instead and specify "resnet50" as the model.

There are no plans to remove support for the resnet50 function. However, the imagePretrainedNetwork function has additional functionality that helps with transfer learning workflows. For example, you can specify the number of classes in your data using the numClasses option, and the function returns a network that is ready for retraining without the need for modification.

The imagePretrainedNetwork function returns the network as a dlnetwork object, which does not store the class names, To get the class names of the pretrained network, use the second output argument of the imagePretrainedNetwork function.

This table shows some typical usages of the resnet50 function and how to update your code to use the imagePretrainedNetwork function instead.

Not RecommendedRecommended
net = resnet50;[net,classNames] = imagePretrainedNetwork("resnet50");
net = resnet50(Weights="none");net = imagePretrainedNetwork("resnet50",Weights="none");

The imagePretrainedNetwork returns a dlnetwork object, which also has these advantages:

  • dlnetwork objects are a unified data type that supports network building, prediction, built-in training, visualization, compression, verification, and custom training loops.

  • dlnetwork objects support a wider range of network architectures that you can create or import from external platforms.

  • The trainnet function supports dlnetwork objects, which enables you to easily specify loss functions. You can select from built-in loss functions or specify a custom loss function.

  • Training and prediction with dlnetwork objects is typically faster than LayerGraph and trainNetwork workflows.

To train a neural network specified as a dlnetwork object, use the trainnet function.