| --- |
| library_name: pytorch |
| license: other |
| tags: |
| - backbone |
| - android |
| pipeline_tag: video-classification |
|
|
| --- |
| |
|  |
|
|
| # ResNet-Mixed-Convolution: Optimized for Mobile Deployment |
| ## Sports and human action recognition in videos |
|
|
|
|
| ResNet Mixed Convolutions is a network with a mixture of 2D and 3D convolutions used for video understanding. |
|
|
| This model is an implementation of ResNet-Mixed-Convolution found [here](https://github.com/pytorch/vision/blob/main/torchvision/models/video/resnet.py). |
|
|
|
|
| This repository provides scripts to run ResNet-Mixed-Convolution on Qualcomm® devices. |
| More details on model performance across various devices, can be found |
| [here](https://aihub.qualcomm.com/models/resnet_mixed). |
|
|
|
|
|
|
| ### Model Details |
|
|
| - **Model Type:** Model_use_case.video_classification |
| - **Model Stats:** |
| - Model checkpoint: Kinetics-400 |
| - Input resolution: 112x112 |
| - Number of parameters: 11.7M |
| - Model size (float): 44.6 MB |
| - Model size (w8a16): 11.5 MB |
| |
| | Model | Precision | Device | Chipset | Target Runtime | Inference Time (ms) | Peak Memory Range (MB) | Primary Compute Unit | Target Model |
| |---|---|---|---|---|---|---|---|---| |
| | ResNet-Mixed-Convolution | float | QCS8275 (Proxy) | Qualcomm® QCS8275 (Proxy) | TFLITE | 601.115 ms | 0 - 210 MB | NPU | [ResNet-Mixed-Convolution.tflite](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.tflite) | |
| | ResNet-Mixed-Convolution | float | QCS8275 (Proxy) | Qualcomm® QCS8275 (Proxy) | QNN_DLC | 97.227 ms | 2 - 188 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | QCS8450 (Proxy) | Qualcomm® QCS8450 (Proxy) | TFLITE | 345.7 ms | 0 - 243 MB | NPU | [ResNet-Mixed-Convolution.tflite](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.tflite) | |
| | ResNet-Mixed-Convolution | float | QCS8450 (Proxy) | Qualcomm® QCS8450 (Proxy) | QNN_DLC | 27.537 ms | 2 - 216 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | QCS8550 (Proxy) | Qualcomm® QCS8550 (Proxy) | TFLITE | 315.577 ms | 0 - 3 MB | NPU | [ResNet-Mixed-Convolution.tflite](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.tflite) | |
| | ResNet-Mixed-Convolution | float | QCS8550 (Proxy) | Qualcomm® QCS8550 (Proxy) | QNN_DLC | 13.387 ms | 2 - 5 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | QCS8550 (Proxy) | Qualcomm® QCS8550 (Proxy) | ONNX | 13.858 ms | 0 - 29 MB | NPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.onnx.zip) | |
| | ResNet-Mixed-Convolution | float | QCS9075 (Proxy) | Qualcomm® QCS9075 (Proxy) | TFLITE | 301.681 ms | 0 - 210 MB | NPU | [ResNet-Mixed-Convolution.tflite](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.tflite) | |
| | ResNet-Mixed-Convolution | float | QCS9075 (Proxy) | Qualcomm® QCS9075 (Proxy) | QNN_DLC | 115.982 ms | 2 - 188 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | SA7255P ADP | Qualcomm® SA7255P | TFLITE | 601.115 ms | 0 - 210 MB | NPU | [ResNet-Mixed-Convolution.tflite](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.tflite) | |
| | ResNet-Mixed-Convolution | float | SA7255P ADP | Qualcomm® SA7255P | QNN_DLC | 97.227 ms | 2 - 188 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | SA8255 (Proxy) | Qualcomm® SA8255P (Proxy) | TFLITE | 317.928 ms | 0 - 2 MB | NPU | [ResNet-Mixed-Convolution.tflite](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.tflite) | |
| | ResNet-Mixed-Convolution | float | SA8255 (Proxy) | Qualcomm® SA8255P (Proxy) | QNN_DLC | 13.38 ms | 2 - 5 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | SA8295P ADP | Qualcomm® SA8295P | TFLITE | 366.039 ms | 0 - 197 MB | NPU | [ResNet-Mixed-Convolution.tflite](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.tflite) | |
| | ResNet-Mixed-Convolution | float | SA8295P ADP | Qualcomm® SA8295P | QNN_DLC | 26.694 ms | 0 - 164 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | SA8650 (Proxy) | Qualcomm® SA8650P (Proxy) | TFLITE | 309.437 ms | 0 - 3 MB | NPU | [ResNet-Mixed-Convolution.tflite](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.tflite) | |
| | ResNet-Mixed-Convolution | float | SA8650 (Proxy) | Qualcomm® SA8650P (Proxy) | QNN_DLC | 13.445 ms | 2 - 5 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | SA8775P ADP | Qualcomm® SA8775P | TFLITE | 301.681 ms | 0 - 210 MB | NPU | [ResNet-Mixed-Convolution.tflite](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.tflite) | |
| | ResNet-Mixed-Convolution | float | SA8775P ADP | Qualcomm® SA8775P | QNN_DLC | 115.982 ms | 2 - 188 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | Samsung Galaxy S24 | Snapdragon® 8 Gen 3 Mobile | TFLITE | 238.039 ms | 2 - 271 MB | NPU | [ResNet-Mixed-Convolution.tflite](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.tflite) | |
| | ResNet-Mixed-Convolution | float | Samsung Galaxy S24 | Snapdragon® 8 Gen 3 Mobile | QNN_DLC | 9.634 ms | 2 - 252 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | Samsung Galaxy S24 | Snapdragon® 8 Gen 3 Mobile | ONNX | 9.981 ms | 2 - 233 MB | NPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.onnx.zip) | |
| | ResNet-Mixed-Convolution | float | Samsung Galaxy S25 | Snapdragon® 8 Elite For Galaxy Mobile | TFLITE | 200.143 ms | 0 - 210 MB | NPU | [ResNet-Mixed-Convolution.tflite](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.tflite) | |
| | ResNet-Mixed-Convolution | float | Samsung Galaxy S25 | Snapdragon® 8 Elite For Galaxy Mobile | QNN_DLC | 7.716 ms | 2 - 191 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | Samsung Galaxy S25 | Snapdragon® 8 Elite For Galaxy Mobile | ONNX | 8.166 ms | 1 - 162 MB | NPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.onnx.zip) | |
| | ResNet-Mixed-Convolution | float | Snapdragon 8 Elite Gen 5 QRD | Snapdragon® 8 Elite Gen5 Mobile | TFLITE | 198.24 ms | 0 - 209 MB | NPU | [ResNet-Mixed-Convolution.tflite](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.tflite) | |
| | ResNet-Mixed-Convolution | float | Snapdragon 8 Elite Gen 5 QRD | Snapdragon® 8 Elite Gen5 Mobile | QNN_DLC | 5.668 ms | 2 - 195 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | Snapdragon 8 Elite Gen 5 QRD | Snapdragon® 8 Elite Gen5 Mobile | ONNX | 5.841 ms | 2 - 166 MB | NPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.onnx.zip) | |
| | ResNet-Mixed-Convolution | float | Snapdragon X Elite CRD | Snapdragon® X Elite | QNN_DLC | 14.062 ms | 2 - 2 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.dlc) | |
| | ResNet-Mixed-Convolution | float | Snapdragon X Elite CRD | Snapdragon® X Elite | ONNX | 14.079 ms | 22 - 22 MB | NPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution.onnx.zip) | |
| | ResNet-Mixed-Convolution | w8a16 | Dragonwing Q-6690 MTP | Qualcomm® Qcm6690 | QNN_DLC | 168.996 ms | 1 - 183 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | Dragonwing Q-6690 MTP | Qualcomm® Qcm6690 | ONNX | 902.51 ms | 100 - 114 MB | CPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.onnx.zip) | |
| | ResNet-Mixed-Convolution | w8a16 | Dragonwing RB3 Gen 2 Vision Kit | Qualcomm® QCS6490 | QNN_DLC | 36.025 ms | 1 - 3 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | Dragonwing RB3 Gen 2 Vision Kit | Qualcomm® QCS6490 | ONNX | 1730.135 ms | 44 - 62 MB | CPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.onnx.zip) | |
| | ResNet-Mixed-Convolution | w8a16 | QCS8275 (Proxy) | Qualcomm® QCS8275 (Proxy) | QNN_DLC | 29.645 ms | 1 - 161 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | QCS8450 (Proxy) | Qualcomm® QCS8450 (Proxy) | QNN_DLC | 13.197 ms | 1 - 224 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | QCS8550 (Proxy) | Qualcomm® QCS8550 (Proxy) | QNN_DLC | 9.355 ms | 1 - 3 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | QCS8550 (Proxy) | Qualcomm® QCS8550 (Proxy) | ONNX | 8.749 ms | 0 - 15 MB | NPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.onnx.zip) | |
| | ResNet-Mixed-Convolution | w8a16 | QCS9075 (Proxy) | Qualcomm® QCS9075 (Proxy) | QNN_DLC | 9.397 ms | 1 - 162 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | RB5 (Proxy) | Qualcomm® QCS8250 (Proxy) | ONNX | 744.004 ms | 90 - 110 MB | CPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.onnx.zip) | |
| | ResNet-Mixed-Convolution | w8a16 | SA7255P ADP | Qualcomm® SA7255P | QNN_DLC | 29.645 ms | 1 - 161 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | SA8255 (Proxy) | Qualcomm® SA8255P (Proxy) | QNN_DLC | 9.249 ms | 1 - 3 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | SA8295P ADP | Qualcomm® SA8295P | QNN_DLC | 16.12 ms | 1 - 166 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | SA8650 (Proxy) | Qualcomm® SA8650P (Proxy) | QNN_DLC | 9.259 ms | 1 - 3 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | SA8775P ADP | Qualcomm® SA8775P | QNN_DLC | 9.397 ms | 1 - 162 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | Samsung Galaxy S24 | Snapdragon® 8 Gen 3 Mobile | QNN_DLC | 6.631 ms | 1 - 225 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | Samsung Galaxy S24 | Snapdragon® 8 Gen 3 Mobile | ONNX | 6.523 ms | 1 - 196 MB | NPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.onnx.zip) | |
| | ResNet-Mixed-Convolution | w8a16 | Samsung Galaxy S25 | Snapdragon® 8 Elite For Galaxy Mobile | QNN_DLC | 5.734 ms | 1 - 160 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | Samsung Galaxy S25 | Snapdragon® 8 Elite For Galaxy Mobile | ONNX | 5.307 ms | 1 - 133 MB | NPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.onnx.zip) | |
| | ResNet-Mixed-Convolution | w8a16 | Snapdragon 7 Gen 4 QRD | Snapdragon® 7 Gen 4 Mobile | QNN_DLC | 15.767 ms | 1 - 168 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | Snapdragon 7 Gen 4 QRD | Snapdragon® 7 Gen 4 Mobile | ONNX | 919.68 ms | 106 - 121 MB | CPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.onnx.zip) | |
| | ResNet-Mixed-Convolution | w8a16 | Snapdragon 8 Elite Gen 5 QRD | Snapdragon® 8 Elite Gen5 Mobile | QNN_DLC | 3.817 ms | 1 - 163 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | Snapdragon 8 Elite Gen 5 QRD | Snapdragon® 8 Elite Gen5 Mobile | ONNX | 3.912 ms | 0 - 137 MB | NPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.onnx.zip) | |
| | ResNet-Mixed-Convolution | w8a16 | Snapdragon X Elite CRD | Snapdragon® X Elite | QNN_DLC | 9.929 ms | 1 - 1 MB | NPU | [ResNet-Mixed-Convolution.dlc](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.dlc) | |
| | ResNet-Mixed-Convolution | w8a16 | Snapdragon X Elite CRD | Snapdragon® X Elite | ONNX | 9.085 ms | 12 - 12 MB | NPU | [ResNet-Mixed-Convolution.onnx.zip](https://huggingface.co/qualcomm/ResNet-Mixed-Convolution/blob/main/ResNet-Mixed-Convolution_w8a16.onnx.zip) | |
|
|
|
|
|
|
|
|
| ## Installation |
|
|
|
|
| Install the package via pip: |
| ```bash |
| # NOTE: 3.10 <= PYTHON_VERSION < 3.14 is supported. |
| pip install "qai-hub-models[resnet-mixed]" |
| ``` |
|
|
|
|
| ## Configure Qualcomm® AI Hub Workbench to run this model on a cloud-hosted device |
|
|
| Sign-in to [Qualcomm® AI Hub Workbench](https://workbench.aihub.qualcomm.com/) with your |
| Qualcomm® ID. Once signed in navigate to `Account -> Settings -> API Token`. |
|
|
| With this API token, you can configure your client to run models on the cloud |
| hosted devices. |
| ```bash |
| qai-hub configure --api_token API_TOKEN |
| ``` |
| Navigate to [docs](https://workbench.aihub.qualcomm.com/docs/) for more information. |
|
|
|
|
|
|
| ## Demo off target |
|
|
| The package contains a simple end-to-end demo that downloads pre-trained |
| weights and runs this model on a sample input. |
|
|
| ```bash |
| python -m qai_hub_models.models.resnet_mixed.demo |
| ``` |
|
|
| The above demo runs a reference implementation of pre-processing, model |
| inference, and post processing. |
|
|
| **NOTE**: If you want running in a Jupyter Notebook or Google Colab like |
| environment, please add the following to your cell (instead of the above). |
| ``` |
| %run -m qai_hub_models.models.resnet_mixed.demo |
| ``` |
|
|
|
|
| ### Run model on a cloud-hosted device |
|
|
| In addition to the demo, you can also run the model on a cloud-hosted Qualcomm® |
| device. This script does the following: |
| * Performance check on-device on a cloud-hosted device |
| * Downloads compiled assets that can be deployed on-device for Android. |
| * Accuracy check between PyTorch and on-device outputs. |
|
|
| ```bash |
| python -m qai_hub_models.models.resnet_mixed.export |
| ``` |
|
|
|
|
|
|
| ## How does this work? |
|
|
| This [export script](https://aihub.qualcomm.com/models/resnet_mixed/qai_hub_models/models/ResNet-Mixed-Convolution/export.py) |
| leverages [Qualcomm® AI Hub](https://aihub.qualcomm.com/) to optimize, validate, and deploy this model |
| on-device. Lets go through each step below in detail: |
|
|
| Step 1: **Compile model for on-device deployment** |
|
|
| To compile a PyTorch model for on-device deployment, we first trace the model |
| in memory using the `jit.trace` and then call the `submit_compile_job` API. |
|
|
| ```python |
| import torch |
| |
| import qai_hub as hub |
| from qai_hub_models.models.resnet_mixed import Model |
| |
| # Load the model |
| torch_model = Model.from_pretrained() |
| |
| # Device |
| device = hub.Device("Samsung Galaxy S25") |
| |
| # Trace model |
| input_shape = torch_model.get_input_spec() |
| sample_inputs = torch_model.sample_inputs() |
| |
| pt_model = torch.jit.trace(torch_model, [torch.tensor(data[0]) for _, data in sample_inputs.items()]) |
| |
| # Compile model on a specific device |
| compile_job = hub.submit_compile_job( |
| model=pt_model, |
| device=device, |
| input_specs=torch_model.get_input_spec(), |
| ) |
| |
| # Get target model to run on-device |
| target_model = compile_job.get_target_model() |
| |
| ``` |
|
|
|
|
| Step 2: **Performance profiling on cloud-hosted device** |
|
|
| After compiling models from step 1. Models can be profiled model on-device using the |
| `target_model`. Note that this scripts runs the model on a device automatically |
| provisioned in the cloud. Once the job is submitted, you can navigate to a |
| provided job URL to view a variety of on-device performance metrics. |
| ```python |
| profile_job = hub.submit_profile_job( |
| model=target_model, |
| device=device, |
| ) |
| |
| ``` |
|
|
| Step 3: **Verify on-device accuracy** |
|
|
| To verify the accuracy of the model on-device, you can run on-device inference |
| on sample input data on the same cloud hosted device. |
| ```python |
| input_data = torch_model.sample_inputs() |
| inference_job = hub.submit_inference_job( |
| model=target_model, |
| device=device, |
| inputs=input_data, |
| ) |
| on_device_output = inference_job.download_output_data() |
| |
| ``` |
| With the output of the model, you can compute like PSNR, relative errors or |
| spot check the output with expected output. |
|
|
| **Note**: This on-device profiling and inference requires access to Qualcomm® |
| AI Hub Workbench. [Sign up for access](https://myaccount.qualcomm.com/signup). |
|
|
|
|
|
|
|
|
| ## Deploying compiled model to Android |
|
|
|
|
| The models can be deployed using multiple runtimes: |
| - TensorFlow Lite (`.tflite` export): [This |
| tutorial](https://www.tensorflow.org/lite/android/quickstart) provides a |
| guide to deploy the .tflite model in an Android application. |
|
|
|
|
| - QNN (`.so` export ): This [sample |
| app](https://docs.qualcomm.com/bundle/publicresource/topics/80-63442-50/sample_app.html) |
| provides instructions on how to use the `.so` shared library in an Android application. |
| |
| |
| ## View on Qualcomm® AI Hub |
| Get more details on ResNet-Mixed-Convolution's performance across various devices [here](https://aihub.qualcomm.com/models/resnet_mixed). |
| Explore all available models on [Qualcomm® AI Hub](https://aihub.qualcomm.com/) |
| |
| |
| ## License |
| * The license for the original implementation of ResNet-Mixed-Convolution can be found |
| [here](https://github.com/pytorch/vision/blob/main/LICENSE). |
| |
| |
| |
| ## References |
| * [A Closer Look at Spatiotemporal Convolutions for Action Recognition](https://arxiv.org/abs/1711.11248) |
| * [Source Model Implementation](https://github.com/pytorch/vision/blob/main/torchvision/models/video/resnet.py) |
| |
| |
| |
| ## Community |
| * Join [our AI Hub Slack community](https://aihub.qualcomm.com/community/slack) to collaborate, post questions and learn more about on-device AI. |
| * For questions or feedback please [reach out to us](mailto:ai-hub-support@qti.qualcomm.com). |
| |
| |
| |