Shortcuts

Learn the Basics || Quickstart || Tensors || Datasets & DataLoaders || Transforms || Build Model || Autograd || Optimization || Save & Load Model

Save and Load the Model

In this section we will look at how to persist model state with saving, loading and running model predictions.

import torch
import torchvision.models as models

Saving and Loading Model Weights

PyTorch models store the learned parameters in an internal state dictionary, called state_dict. These can be persisted via the torch.save method:

model = models.vgg16(weights='IMAGENET1K_V1')
torch.save(model.state_dict(), 'model_weights.pth')
Downloading: "https://download.pytorch.org/models/vgg16-397923af.pth" to /var/lib/ci-user/.cache/torch/hub/checkpoints/vgg16-397923af.pth

  0%|          | 0.00/528M [00:00<?, ?B/s]
  3%|3         | 17.4M/528M [00:00<00:02, 182MB/s]
  7%|6         | 34.9M/528M [00:00<00:02, 182MB/s]
 10%|9         | 52.4M/528M [00:00<00:02, 183MB/s]
 13%|#3        | 69.9M/528M [00:00<00:02, 182MB/s]
 17%|#6        | 87.5M/528M [00:00<00:02, 183MB/s]
 20%|#9        | 105M/528M [00:00<00:02, 184MB/s]
 23%|##3       | 123M/528M [00:00<00:02, 184MB/s]
 27%|##6       | 141M/528M [00:00<00:02, 184MB/s]
 30%|##9       | 158M/528M [00:00<00:02, 184MB/s]
 33%|###3      | 176M/528M [00:01<00:02, 184MB/s]
 37%|###6      | 194M/528M [00:01<00:01, 183MB/s]
 40%|###9      | 211M/528M [00:01<00:01, 183MB/s]
 43%|####3     | 228M/528M [00:01<00:01, 182MB/s]
 47%|####6     | 246M/528M [00:01<00:01, 182MB/s]
 50%|####9     | 263M/528M [00:01<00:01, 182MB/s]
 53%|#####3    | 281M/528M [00:01<00:01, 182MB/s]
 57%|#####6    | 298M/528M [00:01<00:01, 182MB/s]
 60%|#####9    | 316M/528M [00:01<00:01, 183MB/s]
 63%|######3   | 333M/528M [00:01<00:01, 183MB/s]
 67%|######6   | 351M/528M [00:02<00:01, 183MB/s]
 70%|######9   | 368M/528M [00:02<00:00, 183MB/s]
 73%|#######3  | 386M/528M [00:02<00:00, 183MB/s]
 76%|#######6  | 404M/528M [00:02<00:00, 183MB/s]
 80%|#######9  | 421M/528M [00:02<00:00, 184MB/s]
 83%|########3 | 439M/528M [00:02<00:00, 183MB/s]
 86%|########6 | 456M/528M [00:02<00:00, 183MB/s]
 90%|########9 | 474M/528M [00:02<00:00, 183MB/s]
 93%|#########3| 491M/528M [00:02<00:00, 183MB/s]
 96%|#########6| 509M/528M [00:02<00:00, 183MB/s]
100%|#########9| 526M/528M [00:03<00:00, 183MB/s]
100%|##########| 528M/528M [00:03<00:00, 183MB/s]

To load model weights, you need to create an instance of the same model first, and then load the parameters using load_state_dict() method.

model = models.vgg16() # we do not specify ``weights``, i.e. create untrained model
model.load_state_dict(torch.load('model_weights.pth'))
model.eval()
VGG(
  (features): Sequential(
    (0): Conv2d(3, 64, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (1): ReLU(inplace=True)
    (2): Conv2d(64, 64, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (3): ReLU(inplace=True)
    (4): MaxPool2d(kernel_size=2, stride=2, padding=0, dilation=1, ceil_mode=False)
    (5): Conv2d(64, 128, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (6): ReLU(inplace=True)
    (7): Conv2d(128, 128, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (8): ReLU(inplace=True)
    (9): MaxPool2d(kernel_size=2, stride=2, padding=0, dilation=1, ceil_mode=False)
    (10): Conv2d(128, 256, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (11): ReLU(inplace=True)
    (12): Conv2d(256, 256, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (13): ReLU(inplace=True)
    (14): Conv2d(256, 256, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (15): ReLU(inplace=True)
    (16): MaxPool2d(kernel_size=2, stride=2, padding=0, dilation=1, ceil_mode=False)
    (17): Conv2d(256, 512, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (18): ReLU(inplace=True)
    (19): Conv2d(512, 512, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (20): ReLU(inplace=True)
    (21): Conv2d(512, 512, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (22): ReLU(inplace=True)
    (23): MaxPool2d(kernel_size=2, stride=2, padding=0, dilation=1, ceil_mode=False)
    (24): Conv2d(512, 512, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (25): ReLU(inplace=True)
    (26): Conv2d(512, 512, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (27): ReLU(inplace=True)
    (28): Conv2d(512, 512, kernel_size=(3, 3), stride=(1, 1), padding=(1, 1))
    (29): ReLU(inplace=True)
    (30): MaxPool2d(kernel_size=2, stride=2, padding=0, dilation=1, ceil_mode=False)
  )
  (avgpool): AdaptiveAvgPool2d(output_size=(7, 7))
  (classifier): Sequential(
    (0): Linear(in_features=25088, out_features=4096, bias=True)
    (1): ReLU(inplace=True)
    (2): Dropout(p=0.5, inplace=False)
    (3): Linear(in_features=4096, out_features=4096, bias=True)
    (4): ReLU(inplace=True)
    (5): Dropout(p=0.5, inplace=False)
    (6): Linear(in_features=4096, out_features=1000, bias=True)
  )
)

Note

be sure to call model.eval() method before inferencing to set the dropout and batch normalization layers to evaluation mode. Failing to do this will yield inconsistent inference results.

Saving and Loading Models with Shapes

When loading model weights, we needed to instantiate the model class first, because the class defines the structure of a network. We might want to save the structure of this class together with the model, in which case we can pass model (and not model.state_dict()) to the saving function:

torch.save(model, 'model.pth')

We can then load the model like this:

model = torch.load('model.pth')

Note

This approach uses Python pickle module when serializing the model, thus it relies on the actual class definition to be available when loading the model.

Docs

Access comprehensive developer documentation for PyTorch

View Docs

Tutorials

Get in-depth tutorials for beginners and advanced developers

View Tutorials

Resources

Find development resources and get your questions answered

View Resources