mmclassification/docs_zh-CN/tools/onnx2tensorrt.md

77 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# ONNX 转 TensorRT试验性的
<!-- TOC -->
- [ONNX 转 TensorRT试验性的](#onnx-tensorrt)
- [如何将模型从 ONNX 转换到 TensorRT](#id1)
- [准备工作](#id2)
- [使用方法](#id3)
- [支持转换至 TensorRT 的模型列表](#tensorrt)
- [提示](#id4)
- [常见问题](#id5)
<!-- TOC -->
## 如何将模型从 ONNX 转换到 TensorRT
### 准备工作
1. 请参照 [安装指南](https://mmclassification.readthedocs.io/zh_CN/latest/install.html#mmclassification) 从源码安装 MMClassification。
2. 使用我们的工具 [pytorch2onnx.md](./pytorch2onnx.md) 将 PyTorch 模型转换至 ONNX。
### 使用方法
```bash
python tools/deployment/onnx2tensorrt.py \
${MODEL} \
--trt-file ${TRT_FILE} \
--shape ${IMAGE_SHAPE} \
--workspace-size {WORKSPACE_SIZE} \
--show \
--verify \
```
所有参数的说明:
- `model` : ONNX 模型的路径。
- `--trt-file`: TensorRT 引擎文件的输出路径。如果没有指定,默认为当前脚本执行路径下的 `tmp.trt`
- `--shape`: 模型输入的高度和宽度。如果没有指定,默认为 `224 224`
- `--workspace-size` : 构建 TensorRT 引擎所需要的 GPU 空间大小,单位为 GiB。如果没有指定默认为 `1` GiB。
- `--show`: 是否展示模型的输出。如果没有指定,默认为 `False`
- `--verify`: 是否使用 ONNXRuntime 和 TensorRT 验证模型转换的正确性。如果没有指定,默认为`False`。
示例:
```bash
python tools/deployment/onnx2tensorrt.py \
checkpoints/resnet/resnet18_b16x8_cifar10.onnx \
--trt-file checkpoints/resnet/resnet18_b16x8_cifar10.trt \
--shape 224 224 \
--show \
--verify \
```
## 支持转换至 TensorRT 的模型列表
下表列出了保证可转换为 TensorRT 的模型。
| 模型 | 配置文件 | 状态 |
| :----------: | :--------------------------------------------------------------------------: | :----: |
| MobileNetV2 | `configs/mobilenet_v2/mobilenet-v2_8xb32_in1k.py` | Y |
| ResNet | `configs/resnet/resnet18_8xb16_cifar10.py` | Y |
| ResNeXt | `configs/resnext/resnext50-32x4d_8xb32_in1k.py` | Y |
| ShuffleNetV1 | `configs/shufflenet_v1/shufflenet-v1-1x_16xb64_in1k.py` | Y |
| ShuffleNetV2 | `configs/shufflenet_v2/shufflenet-v2-1x_16xb64_in1k.py` | Y |
注:
- *以上所有模型转换测试基于 Pytorch==1.6.0 和 TensorRT-7.2.1.6.Ubuntu-16.04.x86_64-gnu.cuda-10.2.cudnn8.0 进行*
## 提示
- 如果你在上述模型的转换中遇到问题,请在 GitHub 中创建一个 issue我们会尽快处理。未在上表中列出的模型由于资源限制我们可能无法提供很多帮助如果遇到问题请尝试自行解决。
## 常见问题
-