Files
nvidia--tensorrt/quickstart/IntroNotebooks/2. Using PyTorch through ONNX.ipynb
T
wehub-resource-sync c8a779b1bb
Docker Image CI / build-ubuntu2004 (push) Waiting to run
chore: import upstream snapshot with attribution
2026-07-13 13:36:55 +08:00

666 lines
25 KiB
Plaintext

{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# Using PyTorch with TensorRT through ONNX:"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"TensorRT is a great way to take a trained PyTorch model and optimize it to run more efficiently during inference on an NVIDIA GPU.\n",
"\n",
"One approach to convert a PyTorch model to TensorRT is to export a PyTorch model to ONNX (an open format exchange for deep learning models) and then convert into a TensorRT engine. Essentially, we will follow this path to convert and deploy our model:\n",
"\n",
"![PyTorch+ONNX](./images/pytorch_onnx.png)\n",
"\n",
"Both PyTorch and TensorFlow models can be exported to ONNX, as well as many other frameworks. This allows models created using either framework to flow into common downstream pipelines.\n",
"\n",
"To get started, let's take a well-known computer vision model and follow five key steps to deploy it to the TensorRT Python runtime:\n",
"\n",
"1. __What format should I save my model in?__\n",
"2. __What batch size(s) am I running inference at?__\n",
"3. __What precision am I running inference at?__\n",
"4. __What TensorRT path am I using to convert my model?__\n",
"5. __What runtime am I targeting?__"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 1. What format should I save my model in?"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We are going to use ResNet50, a widely used CNN architecture first described in <a href=https://arxiv.org/abs/1512.03385>this paper</a>.\n",
"\n",
"Let's start by loading dependencies and downloading the model. We will also move our Resnet model onto the GPU and set it to evaluation mode."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"import torchvision.models as models\n",
"import torch\n",
"import torch.onnx\n",
"\n",
"# load the pretrained model\n",
"resnet50 = models.resnet50(pretrained=True, progress=False).eval()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"When saving a model to ONNX, PyTorch requires a test batch in proper shape and format. We pick a batch size:"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"BATCH_SIZE=32\n",
"\n",
"dummy_input=torch.randn(BATCH_SIZE, 3, 224, 224)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Next, we will export the model using the dummy input batch:"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"# export the model to ONNX\n",
"torch.onnx.export(resnet50, dummy_input, \"resnet50_pytorch.onnx\", verbose=False)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Note that we are picking a BATCH_SIZE of 32 in this example."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Now Test with a Real Image:"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Let's try a real image batch! For this example, we will simply repeat one open-source dog image from http://www.dog.ceo:"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"from skimage import io\n",
"from skimage.transform import resize\n",
"from matplotlib import pyplot as plt\n",
"import numpy as np\n",
"\n",
"url='https://images.dog.ceo/breeds/retriever-golden/n02099601_3004.jpg'\n",
"img = resize(io.imread(url), (224, 224))\n",
"img = np.expand_dims(np.array(img, dtype=np.float32), axis=0) # Expand image to have a batch dimension\n",
"input_batch = np.array(np.repeat(img, BATCH_SIZE, axis=0), dtype=np.float32) # Repeat across the batch dimension\n",
"\n",
"input_batch.shape"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"plt.imshow(input_batch[0].astype(np.float32))"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"resnet50_gpu = models.resnet50(pretrained=True, progress=False).to(\"cuda\").eval()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We need to move our batch onto GPU and properly format it to shape [32, 3, 224, 224]. "
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"input_batch_chw = torch.from_numpy(input_batch).transpose(1,3).transpose(2,3)\n",
"input_batch_gpu = input_batch_chw.to(\"cuda\")\n",
"\n",
"input_batch_gpu.shape"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We can run a prediction on a batch using .forward():"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"with torch.no_grad():\n",
" predictions = np.array(resnet50_gpu(input_batch_gpu).cpu())\n",
"\n",
"predictions.shape"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Verify Baseline Model Performance/Accuracy:"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"For a baseline, lets time our prediction in FP32:"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"%%timeit\n",
"\n",
"with torch.no_grad():\n",
" preds = np.array(resnet50_gpu(input_batch_gpu).cpu())"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We can also time FP16 precision performance:"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"resnet50_gpu_half = resnet50_gpu.half()\n",
"input_half = input_batch_gpu.half()\n",
"\n",
"with torch.no_grad():\n",
" preds = np.array(resnet50_gpu_half(input_half).cpu()) # Warm Up\n",
"\n",
"preds.shape"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"%%timeit\n",
"\n",
"with torch.no_grad():\n",
" preds = np.array(resnet50_gpu_half(input_half).cpu())"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Let's also make sure our results are accurate. We will look at the top 5 accuracy on a single image prediction. The image we are using is of a Golden Retriever, which is class 207 in the ImageNet dataset our model was trained on."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"indices = (-predictions[0]).argsort()[:5]\n",
"print(\"Class | Likelihood\")\n",
"list(zip(indices, predictions[0][indices]))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We have a model exported to ONNX and a baseline to compare against! Let's now take our ONNX model and convert it to a TensorRT inference engine."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 2. What batch size(s) am I running inference at?\n",
"\n",
"We are going to run with a fixed batch size of 32 for this example. Note that above we set BATCH_SIZE to 32 when saving our model to ONNX. We need to create another dummy batch of the same size (this time it will need to be in our target precision) to test out our engine.\n",
"\n",
"First, as before, we will set our BATCH_SIZE to 32. Note that our trtexec command above includes the '--explicitBatch' flag to signal to TensorRT that we will be using a fixed batch size at runtime."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"BATCH_SIZE = 32"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Importantly, by default TensorRT will use the input precision you give the runtime as the default precision for the rest of the network. So before we create our new dummy batch, we also need to choose a precision as in the next section:"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 3. What precision am I running inference at?\n",
"\n",
"Remember that lower precisions than FP32 tend to run faster. There are two common reduced precision modes - FP16 and INT8. Graphics cards that are designed to do inference well often have an affinity for one of these two types. This guide was developed on an NVIDIA V100, which favors FP16, so we will use that here by default. INT8 is a more complicated process that requires a calibration step.\n",
"\n",
"__NOTE__: Make sure you use the same precision (USE_FP16) here you saved your model in above!"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"import numpy as np\n",
"\n",
"USE_FP16 = True\n",
"target_dtype = np.float16 if USE_FP16 else np.float32"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
" To create a test batch, we will once again repeat one open-source dog image from http://www.dog.ceo:"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"from skimage import io\n",
"from skimage.transform import resize\n",
"from matplotlib import pyplot as plt\n",
"import numpy as np\n",
"\n",
"url='https://images.dog.ceo/breeds/retriever-golden/n02099601_3004.jpg'\n",
"img = resize(io.imread(url), (224, 224))\n",
"input_batch = np.array(np.repeat(np.expand_dims(np.array(img, dtype=np.float32), axis=0), BATCH_SIZE, axis=0), dtype=np.float32)\n",
"\n",
"input_batch.shape"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"plt.imshow(input_batch[0].astype(np.float32))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Preprocess Images:\n",
"\n",
"PyTorch has a normalization that it applies by default in all of its pretrained vision models - we can preprocess our images to match this normalization by the following, making sure our final result is in FP16 precision:"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"import torch\n",
"from torchvision.transforms import Normalize\n",
"\n",
"def preprocess_image(img):\n",
" norm = Normalize(mean=[0.485, 0.456, 0.406], std=[0.229, 0.224, 0.225])\n",
" result = norm(torch.from_numpy(img).transpose(0,2).transpose(1,2))\n",
" return np.array(result, dtype=np.float16)\n",
"\n",
"preprocessed_images = np.array([preprocess_image(image) for image in input_batch])"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 4. What TensorRT path am I using to convert my model?"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We can use trtexec, a command line tool for working with TensorRT, in order to convert an ONNX model originally from PyTorch to an engine file.\n",
"\n",
"Let's make sure we have TensorRT installed (this comes with trtexec):"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"import tensorrt"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"To convert the model we saved in the previous step, we need to point to the ONNX file, give trtexec a name to save the engine as, and last specify that we want to use a fixed batch size instead of a dynamic one."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"# step out of Python for a moment to convert the ONNX model to a TRT engine using trtexec\n",
"if USE_FP16:\n",
" !trtexec --onnx=resnet50_pytorch.onnx --saveEngine=resnet_engine_pytorch.trt --inputIOFormats=fp16:chw --outputIOFormats=fp16:chw --fp16\n",
"else:\n",
" !trtexec --onnx=resnet50_pytorch.onnx --saveEngine=resnet_engine_pytorch.trt"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"This will save our model as 'resnet_engine.trt'."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## 5. What TensorRT runtime am I targeting?\n",
"\n",
"Now, we have a converted our model to a TensorRT engine. Great! That means we are ready to load it into the native Python TensorRT runtime. This runtime strikes a balance between the ease of use of the high level Python APIs used in frameworks and the fast, low level C++ runtimes available in TensorRT."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"%%time\n",
"\n",
"import tensorrt as trt\n",
"from cuda.bindings import runtime as cudart\n",
"import numpy as np\n",
"\n",
"err, = cudart.cudaSetDevice(0)\n",
"assert err == cudart.cudaError_t.cudaSuccess\n",
"\n",
"f = open(\"resnet_engine_pytorch.trt\", \"rb\")\n",
"runtime = trt.Runtime(trt.Logger(trt.Logger.WARNING))\n",
"\n",
"engine = runtime.deserialize_cuda_engine(f.read())\n",
"context = engine.create_execution_context()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Now allocate input and output memory, give TRT pointers (bindings) to it:"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"import numpy as np\n",
"\n",
"# need to set input and output precisions to FP16 to fully enable it\n",
"output = np.empty([BATCH_SIZE, 1000], dtype = target_dtype)\n",
"\n",
"# allocate device memory\n",
"err, d_input = cudart.cudaMalloc(input_batch.nbytes)\n",
"assert err == cudart.cudaError_t.cudaSuccess\n",
"err, d_output = cudart.cudaMalloc(output.nbytes)\n",
"assert err == cudart.cudaError_t.cudaSuccess\n",
"\n",
"tensor_names = [engine.get_tensor_name(i) for i in range(engine.num_io_tensors)]\n",
"assert(len(tensor_names) == 2)\n",
"\n",
"context.set_tensor_address(tensor_names[0], d_input)\n",
"context.set_tensor_address(tensor_names[1], d_output)\n",
"\n",
"err, stream = cudart.cudaStreamCreate()\n",
"assert err == cudart.cudaError_t.cudaSuccess"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Next, set up the prediction function.\n",
"\n",
"This involves a copy from CPU RAM to GPU VRAM, executing the model, then copying the results back from GPU VRAM to CPU RAM:"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"def predict(batch): # result gets copied into output\n",
" # transfer input data to device\n",
" err, = cudart.cudaMemcpyAsync(d_input, batch.ctypes.data, batch.nbytes,\n",
" cudart.cudaMemcpyKind.cudaMemcpyHostToDevice, stream)\n",
" assert err == cudart.cudaError_t.cudaSuccess\n",
"\n",
" # execute model\n",
" context.execute_async_v3(stream)\n",
"\n",
" # transfer predictions back\n",
" err, = cudart.cudaMemcpyAsync(output.ctypes.data, d_output, output.nbytes,\n",
" cudart.cudaMemcpyKind.cudaMemcpyDeviceToHost, stream)\n",
" assert err == cudart.cudaError_t.cudaSuccess\n",
"\n",
" # synchronize stream\n",
" err, = cudart.cudaStreamSynchronize(stream)\n",
" assert err == cudart.cudaError_t.cudaSuccess\n",
"\n",
" return output"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Let's time the function!"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"print(\"Warming up...\")\n",
"\n",
"pred = predict(preprocessed_images)\n",
"\n",
"print(\"Done warming up!\")"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"%%timeit\n",
"\n",
"pred = predict(preprocessed_images)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Finally we should verify our TensorRT output is still accurate."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"indices = (-pred[0]).argsort()[:5]\n",
"print(\"Class | Probability (out of 1)\")\n",
"list(zip(indices, pred[0][indices]))"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"err, = cudart.cudaStreamDestroy(stream)\n",
"assert err == cudart.cudaError_t.cudaSuccess\n",
"err, = cudart.cudaFree(d_input)\n",
"assert err == cudart.cudaError_t.cudaSuccess\n",
"err, = cudart.cudaFree(d_output)\n",
"assert err == cudart.cudaError_t.cudaSuccess"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Look for ImageNet indices 150-275 above, where 207 is the ground truth correct class (Golden Retriever). Compare with the results of the original unoptimized model in the first section!"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Next Steps:"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"<h4> TRT Dev Docs </h4>\n",
"\n",
"Main documentation page for the ONNX, layer builder, C++, and legacy APIs\n",
"\n",
"You can find it here: https://docs.nvidia.com/deeplearning/tensorrt/developer-guide/index.html\n",
"\n",
"<h4> TRT OSS GitHub </h4>\n",
"\n",
"Contains OSS TRT components, sample applications, and plugin examples\n",
"\n",
"You can find it here: https://github.com/NVIDIA/TensorRT\n",
"\n",
"\n",
"#### TRT Supported Layers:\n",
"\n",
"https://docs.nvidia.com/deeplearning/tensorrt/support-matrix/index.html#layers-precision-matrix\n",
"\n",
"#### TRT ONNX Plugin Example:\n",
"\n",
"https://github.com/NVIDIA/TensorRT/tree/main/samples/sampleOnnxMnistCoordConvAC"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3 (ipykernel)",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.10.12"
}
},
"nbformat": 4,
"nbformat_minor": 5
}