ONNX export in PyTorch - Model Pipeline Trace

Model Pipeline - ONNX export

This pipeline shows how a PyTorch model is trained and then exported to the ONNX format. ONNX allows the model to be used in different environments outside PyTorch.

Data Flow - 5 Stages

1Raw Data

1000 rows x 10 columns→Collect raw input features and labels→1000 rows x 10 columns

[[0.5, 1.2, ..., 0.3], label=1]

↓

2Preprocessing

1000 rows x 10 columns→Normalize features to zero mean and unit variance→1000 rows x 10 columns

[[0.0, 0.8, ..., -0.5], label=1]

↓

3Train/Test Split

1000 rows x 10 columns→Split data into training (80%) and testing (20%) sets→Train: 800 rows x 10 columns, Test: 200 rows x 10 columns

Train sample: [[0.1, -0.3, ..., 0.2], label=0]

↓

4Model Training

800 rows x 10 columns→Train a simple feedforward neural network→Trained model with input size 10 and output size 2

Model weights updated after each batch

↓

5ONNX Export

Single input tensor of shape [1, 10]→Export trained PyTorch model to ONNX format→ONNX model file with input shape [1, 10] and output shape [1, 2]

ONNX file saved as 'model.onnx'

Training Trace - Epoch by Epoch

Loss
0.7 |*       
0.6 | *      
0.5 |  *     
0.4 |   *    
0.3 |    *   
0.2 |     *  
0.1 |       
    +--------
     1 2 3 4 5 Epochs

Epoch	Loss ↓	Accuracy ↑	Observation
1	0.65	0.60	Loss starts high, accuracy is low but learning begins
2	0.48	0.75	Loss decreases, accuracy improves
3	0.35	0.82	Model continues to learn, better predictions
4	0.28	0.87	Loss decreases steadily, accuracy rises
5	0.22	0.90	Training converges with good accuracy

Prediction Trace - 3 Layers

Layer 1: Input Layer

Layer 2: Hidden Layer (ReLU)

Layer 3: Output Layer (Softmax)

Model Quiz - 3 Questions

What happens to the data shape after preprocessing?

A Shape stays the same but values are normalized

B Number of columns doubles

C Rows are reduced by half

D Data is converted to categorical

Key Insight

Exporting a trained PyTorch model to ONNX format allows the model to be used in many other tools and platforms, making it flexible and portable beyond PyTorch environments.

Practice

1. What is the main purpose of exporting a PyTorch model to ONNX format?

easy

A. To save the model in a universal format for sharing and deployment

B. To train the model faster on GPUs

C. To convert the model into a TensorFlow model automatically

D. To visualize the model architecture in PyTorch

Solution

1. Step 1: Understand ONNX export purpose

   ONNX is designed to save models in a format that can be used across different frameworks and platforms.

2. Step 2: Compare options

   Only To save the model in a universal format for sharing and deployment correctly describes the universal sharing and deployment purpose of ONNX export.

3. Final Answer:

   To save the model in a universal format for sharing and deployment -> Option A

4. Quick Check:

   ONNX export = universal format [OK]

Hint: ONNX = share and deploy models universally [OK]

Common Mistakes:

• Confusing ONNX export with training speedup
• Thinking ONNX converts models to TensorFlow automatically
• Assuming ONNX export is for visualization only

2. Which of the following is the correct way to prepare a PyTorch model for ONNX export?

easy

A. Call model.train() before export

B. Export without setting any input

C. Use a dummy input tensor matching the model input shape

D. Use model.eval() after export

Solution

1. Step 1: Identify preparation steps for ONNX export

   Model should be in evaluation mode and a dummy input tensor matching input shape is needed for tracing.

2. Step 2: Evaluate options

   Use a dummy input tensor matching the model input shape correctly states the use of a dummy input tensor. Call model.train() before export is wrong because model.train() is for training mode. Export without setting any input misses input, and Use model.eval() after export is incorrect order.

3. Final Answer:

   Use a dummy input tensor matching the model input shape -> Option C

4. Quick Check:

   Dummy input needed = Use a dummy input tensor matching the model input shape [OK]

Hint: Always use dummy input tensor before export [OK]

Common Mistakes:

• Forgetting to set model.eval() before export
• Not providing dummy input tensor
• Calling model.train() instead of eval()

3. Given the code below, what will be the output of print(onnx_model.graph.input[0].name) after export?

import torch
import torch.nn as nn

class SimpleModel(nn.Module):
    def forward(self, x):
        return x * 2

model = SimpleModel()
model.eval()
dummy_input = torch.randn(1, 3)
torch.onnx.export(model, dummy_input, "model.onnx", input_names=["input_tensor"])
import onnx
onnx_model = onnx.load("model.onnx")
print(onnx_model.graph.input[0].name)

medium

A. x

B. input_tensor

C. input0

D. data

Solution

1. Step 1: Check input_names parameter in export

   The export call sets input_names=["input_tensor"], so the input name in ONNX graph should be "input_tensor".

2. Step 2: Confirm printed input name

   Loading the ONNX model and printing the first input name will output "input_tensor" as set.

3. Final Answer:

   input_tensor -> Option B

4. Quick Check:

   input_names param = input_tensor [OK]

Hint: input_names param sets ONNX input name [OK]

Common Mistakes:

• Assuming default input name like 'input0'
• Confusing PyTorch variable name with ONNX input name
• Not setting input_names and expecting custom name

4. You try to export a PyTorch model to ONNX but get an error: RuntimeError: Input type (torch.cuda.FloatTensor) and weight type (torch.FloatTensor) should be the same. What is the best fix?

medium

A. Export without specifying input_names

B. Use model.train() instead of model.eval()

C. Remove dummy input tensor

D. Move both the model and the dummy input to CPU before export

Solution

1. Step 1: Understand the error cause

   The error means model weights are on CPU but input tensor is on GPU (cuda), causing type mismatch.

2. Step 2: Fix by aligning device

   Moving both the model and the dummy input to CPU ensures both are on the same device (CPU), fixing the mismatch.

3. Final Answer:

   Move both the model and the dummy input to CPU before export -> Option D

4. Quick Check:

   Device mismatch fix = move model and input to CPU [OK]

Hint: Ensure model and input are on same device before export [OK]

Common Mistakes:

• Ignoring device mismatch and exporting anyway
• Switching to train mode instead of fixing device
• Removing dummy input tensor causing other errors

5. You want to export a PyTorch model to ONNX with dynamic batch size support. Which argument should you add to torch.onnx.export to enable this?

hard

A. dynamic_axes={'input': {0: 'batch_size'}, 'output': {0: 'batch_size'}}

B. enable_dynamic_batch=True

C. set_dynamic=True

D. dynamic_batch=True

Solution

1. Step 1: Identify how to specify dynamic axes in ONNX export

   PyTorch ONNX export uses the dynamic_axes argument to mark dimensions as dynamic, e.g., batch size dimension 0.

2. Step 2: Check options for dynamic batch size

   Only dynamic_axes={'input': {0: 'batch_size'}, 'output': {0: 'batch_size'}} correctly uses dynamic_axes with dictionary specifying batch dimension 0 for input and output.

3. Final Answer:

   dynamic_axes={'input': {0: 'batch_size'}, 'output': {0: 'batch_size'}} -> Option A

4. Quick Check:

   Dynamic batch size = dynamic_axes param [OK]

Hint: Use dynamic_axes dict to set dynamic batch size [OK]

Common Mistakes:

• Using nonexistent parameters like enable_dynamic_batch
• Forgetting to specify dynamic axes for output
• Assuming batch size is dynamic by default