1. Getting Started with Pre-trained Model on CIFAR10¶
CIFAR10 is a dataset of tiny (32x32) images with labels, collected by Alex Krizhevsky, Vinod Nair, and Geoffrey Hinton. It is widely used as benchmark in computer vision research.
In this tutorial, we will demonstrate how to load a pre-trained model from gluoncv-model-zoo and classify images from the Internet or your local disk.
Step by Step¶
Let’s first try out a pre-trained cifar model with a few lines of python code.
First, please follow the installation guide
GluonCV if you haven’t done so yet.
import matplotlib.pyplot as plt from mxnet import gluon, nd, image from mxnet.gluon.data.vision import transforms from gluoncv import utils from gluoncv.model_zoo import get_model
Then, we download and show the example image:
Downloading plane-draw.jpeg from https://raw.githubusercontent.com/dmlc/web-data/master/gluoncv/classification/plane-draw.jpeg... 0%| | 0/99 [00:00<?, ?KB/s] 100%|##########| 99/99 [00:00<00:00, 20849.37KB/s]
In case you don’t recognize it, the image is a poorly-drawn airplane :)
Now we define transformations for the image.
This transformation function does three things: resize and crop the image to 32x32 in size, transpose it to num_channels*height*width, and normalize with mean and standard deviation calculated across all CIFAR10 images.
What does the transformed image look like?
Can’t recognize anything? Don’t panic! Neither do I. The transformation makes it more “model-friendly”, instead of “human-friendly”.
Next, we load a pre-trained model.
net = get_model('cifar_resnet110_v1', classes=10, pretrained=True)
Downloading /root/.mxnet/models/cifar_resnet110_v1-a0e1f860.zip from https://apache-mxnet.s3-accelerate.dualstack.amazonaws.com/gluon/models/cifar_resnet110_v1-a0e1f860.zip... 0%| | 0/6335 [00:00<?, ?KB/s] 2%|1 | 104/6335 [00:00<00:07, 824.37KB/s] 8%|8 | 512/6335 [00:00<00:02, 2217.52KB/s] 35%|###4 | 2194/6335 [00:00<00:00, 7326.91KB/s] 6336KB [00:00, 13659.76KB/s]
Finally, we prepare the image and feed it to the model
pred = net(img.expand_dims(axis=0)) class_names = ['airplane', 'automobile', 'bird', 'cat', 'deer', 'dog', 'frog', 'horse', 'ship', 'truck'] ind = nd.argmax(pred, axis=1).astype('int') print('The input picture is classified as [%s], with probability %.3f.'% (class_names[ind.asscalar()], nd.softmax(pred)[ind].asscalar()))
The input picture is classified as [airplane], with probability 0.393.
Play with the scripts¶
Here is a script that does all the previous steps in one go.
Feed in your own image to see how well it does the job.
Keep in mind that
CIFAR10 is a small dataset with only 10
classes. Models trained on
CIFAR10 only recognize objects from those
10 classes. Thus, it may surprise you if we feed one image to the model
which doesn’t belong to any of the 10 classes
For instance we can test it with the following photo of Mt. Baker:
python demo_cifar10.py --model cifar_resnet110_v1 --input-pic mt_baker.jpg
The result is:
The input picture is classified to be [ship], with probability 0.949.
Congratulations! You’ve just finished reading the first tutorial. There are a lot more to help you learn GluonCV.
If you would like to dive deeper into training on
feel free to read the next tutorial on CIFAR10.
Or, if you would like to try a larger scale dataset with 1000 classes of common objects please read Getting Started with ImageNet Pre-trained Models.
Total running time of the script: ( 0 minutes 1.290 seconds)