v0.51.0
Browse filesSee https://github.com/qualcomm/ai-hub-models/releases/v0.51.0 for changelog.
- LICENSE +1 -0
- README.md +103 -0
- release_assets.json +27 -0
LICENSE
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
The license of the original trained model can be found at https://github.com/ibaiGorordo/CREStereo-Pytorch/blob/main/LICENSE.
|
README.md
ADDED
|
@@ -0,0 +1,103 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
library_name: pytorch
|
| 3 |
+
license: other
|
| 4 |
+
tags:
|
| 5 |
+
- android
|
| 6 |
+
pipeline_tag: depth-estimation
|
| 7 |
+
|
| 8 |
+
---
|
| 9 |
+
|
| 10 |
+

|
| 11 |
+
|
| 12 |
+
# CREStereo: Optimized for Qualcomm Devices
|
| 13 |
+
|
| 14 |
+
CREStereo (Cascaded Recurrent Network with Adaptive Correlation) is a CVPR 2022 Oral paper that achieves state-of-the-art stereo matching accuracy.
|
| 15 |
+
|
| 16 |
+
This is based on the implementation of CREStereo found [here](https://github.com/ibaiGorordo/CREStereo-Pytorch).
|
| 17 |
+
This repository contains pre-exported model files optimized for Qualcomm® devices. You can use the [Qualcomm® AI Hub Models](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/models/crestereo) library to export with custom configurations. More details on model performance across various devices, can be found [here](#performance-summary).
|
| 18 |
+
|
| 19 |
+
Qualcomm AI Hub Models uses [Qualcomm AI Hub Workbench](https://workbench.aihub.qualcomm.com) to compile, profile, and evaluate this model. [Sign up](https://myaccount.qualcomm.com/signup) to run these models on a hosted Qualcomm® device.
|
| 20 |
+
|
| 21 |
+
## Getting Started
|
| 22 |
+
There are two ways to deploy this model on your device:
|
| 23 |
+
|
| 24 |
+
### Option 1: Download Pre-Exported Models
|
| 25 |
+
|
| 26 |
+
Below are pre-exported model assets ready for deployment.
|
| 27 |
+
|
| 28 |
+
| Runtime | Precision | Chipset | SDK Versions | Download |
|
| 29 |
+
|---|---|---|---|---|
|
| 30 |
+
| ONNX | float | Universal | ONNX Runtime 1.24.3 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/crestereo/releases/v0.51.0/crestereo-onnx-float.zip)
|
| 31 |
+
| QNN_DLC | float | Universal | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/crestereo/releases/v0.51.0/crestereo-qnn_dlc-float.zip)
|
| 32 |
+
| TFLITE | float | Universal | | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/crestereo/releases/v0.51.0/crestereo-tflite-float.zip)
|
| 33 |
+
|
| 34 |
+
For more device-specific assets and performance metrics, visit **[CREStereo on Qualcomm® AI Hub](https://aihub.qualcomm.com/models/crestereo)**.
|
| 35 |
+
|
| 36 |
+
|
| 37 |
+
### Option 2: Export with Custom Configurations
|
| 38 |
+
|
| 39 |
+
Use the [Qualcomm® AI Hub Models](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/models/crestereo) Python library to compile and export the model with your own:
|
| 40 |
+
- Custom weights (e.g., fine-tuned checkpoints)
|
| 41 |
+
- Custom input shapes
|
| 42 |
+
- Target device and runtime configurations
|
| 43 |
+
|
| 44 |
+
This option is ideal if you need to customize the model beyond the default configuration provided here.
|
| 45 |
+
|
| 46 |
+
See our repository for [CREStereo on GitHub](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/models/crestereo) for usage instructions.
|
| 47 |
+
|
| 48 |
+
## Model Details
|
| 49 |
+
|
| 50 |
+
**Model Type:** Model_use_case.depth_estimation
|
| 51 |
+
|
| 52 |
+
**Model Stats:**
|
| 53 |
+
- Model checkpoint: CREStereo ETH3D pretrained (crestereo_eth3d.pt)
|
| 54 |
+
- Input: Rectified stereo pair — left and right RGB images
|
| 55 |
+
- Input resolution: 240x320
|
| 56 |
+
- Output: Disparity map
|
| 57 |
+
- Number of parameters: 5.43M
|
| 58 |
+
- Model size (float): 20.7 MB
|
| 59 |
+
|
| 60 |
+
## Performance Summary
|
| 61 |
+
| Model | Runtime | Precision | Chipset | Inference Time (ms) | Peak Memory Range (MB) | Primary Compute Unit
|
| 62 |
+
|---|---|---|---|---|---|---
|
| 63 |
+
| CREStereo | ONNX | float | Snapdragon® 8 Elite Gen 5 Mobile | 3841.905 ms | 77 - 97 MB | CPU
|
| 64 |
+
| CREStereo | ONNX | float | Snapdragon® X2 Elite | 2034.246 ms | 179 - 179 MB | CPU
|
| 65 |
+
| CREStereo | ONNX | float | Snapdragon® X Elite | 6292.226 ms | 184 - 184 MB | CPU
|
| 66 |
+
| CREStereo | ONNX | float | Snapdragon® 8 Gen 3 Mobile | 4583.867 ms | 59 - 81 MB | CPU
|
| 67 |
+
| CREStereo | ONNX | float | Qualcomm® QCS8550 (Proxy) | 5846.538 ms | 65 - 68 MB | CPU
|
| 68 |
+
| CREStereo | ONNX | float | Qualcomm® QCS9075 | 3946.878 ms | 95 - 97 MB | CPU
|
| 69 |
+
| CREStereo | ONNX | float | Snapdragon® 8 Elite For Galaxy Mobile | 3982.126 ms | 62 - 85 MB | CPU
|
| 70 |
+
| CREStereo | QNN_DLC | float | Snapdragon® 8 Elite Gen 5 Mobile | 2891.856 ms | 143 - 233 MB | CPU
|
| 71 |
+
| CREStereo | QNN_DLC | float | Snapdragon® X2 Elite | 2830.939 ms | 85 - 85 MB | CPU
|
| 72 |
+
| CREStereo | QNN_DLC | float | Snapdragon® X Elite | 9926.739 ms | 85 - 85 MB | CPU
|
| 73 |
+
| CREStereo | QNN_DLC | float | Snapdragon® 8 Gen 3 Mobile | 4485.42 ms | 120 - 212 MB | CPU
|
| 74 |
+
| CREStereo | QNN_DLC | float | Qualcomm® QCS8275 (Proxy) | 10840.625 ms | 131 - 216 MB | CPU
|
| 75 |
+
| CREStereo | QNN_DLC | float | Qualcomm® QCS8550 (Proxy) | 5622.908 ms | 111 - 154 MB | CPU
|
| 76 |
+
| CREStereo | QNN_DLC | float | Qualcomm® SA8775P | 6649.979 ms | 129 - 213 MB | CPU
|
| 77 |
+
| CREStereo | QNN_DLC | float | Qualcomm® QCS9075 | 7805.077 ms | 304 - 1206 MB | CPU
|
| 78 |
+
| CREStereo | QNN_DLC | float | Qualcomm® QCS8450 (Proxy) | 7283.514 ms | 141 - 236 MB | CPU
|
| 79 |
+
| CREStereo | QNN_DLC | float | Qualcomm® SA7255P | 10840.625 ms | 131 - 216 MB | CPU
|
| 80 |
+
| CREStereo | QNN_DLC | float | Qualcomm® SA8295P | 5593.28 ms | 129 - 213 MB | CPU
|
| 81 |
+
| CREStereo | QNN_DLC | float | Snapdragon® 8 Elite For Galaxy Mobile | 3425.318 ms | 125 - 212 MB | CPU
|
| 82 |
+
| CREStereo | TFLITE | float | Snapdragon® 8 Elite Gen 5 Mobile | 2917.477 ms | 45 - 73 MB | CPU
|
| 83 |
+
| CREStereo | TFLITE | float | Snapdragon® 8 Gen 3 Mobile | 4461.271 ms | 46 - 76 MB | CPU
|
| 84 |
+
| CREStereo | TFLITE | float | Qualcomm® QCS8275 (Proxy) | 7591.053 ms | 48 - 73 MB | CPU
|
| 85 |
+
| CREStereo | TFLITE | float | Qualcomm® QCS8550 (Proxy) | 5318.402 ms | 47 - 60 MB | CPU
|
| 86 |
+
| CREStereo | TFLITE | float | Qualcomm® SA8775P | 6053.307 ms | 48 - 73 MB | CPU
|
| 87 |
+
| CREStereo | TFLITE | float | Qualcomm® QCS9075 | 6158.679 ms | 47 - 153 MB | CPU
|
| 88 |
+
| CREStereo | TFLITE | float | Qualcomm® QCS8450 (Proxy) | 7052.932 ms | 48 - 81 MB | CPU
|
| 89 |
+
| CREStereo | TFLITE | float | Qualcomm® SA7255P | 7591.053 ms | 48 - 73 MB | CPU
|
| 90 |
+
| CREStereo | TFLITE | float | Qualcomm® SA8295P | 4082.577 ms | 47 - 73 MB | CPU
|
| 91 |
+
| CREStereo | TFLITE | float | Snapdragon® 8 Elite For Galaxy Mobile | 3275.879 ms | 47 - 75 MB | CPU
|
| 92 |
+
|
| 93 |
+
## License
|
| 94 |
+
* The license for the original implementation of CREStereo can be found
|
| 95 |
+
[here](https://github.com/ibaiGorordo/CREStereo-Pytorch/blob/main/LICENSE).
|
| 96 |
+
|
| 97 |
+
## References
|
| 98 |
+
* [Practical Stereo Matching via Cascaded Recurrent Network with Adaptive Correlation](https://arxiv.org/abs/2203.11483)
|
| 99 |
+
* [Source Model Implementation](https://github.com/ibaiGorordo/CREStereo-Pytorch)
|
| 100 |
+
|
| 101 |
+
## Community
|
| 102 |
+
* Join [our AI Hub Slack community](https://aihub.qualcomm.com/community/slack) to collaborate, post questions and learn more about on-device AI.
|
| 103 |
+
* For questions or feedback please [reach out to us](mailto:ai-hub-support@qti.qualcomm.com).
|
release_assets.json
ADDED
|
@@ -0,0 +1,27 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"version": "0.51.0",
|
| 3 |
+
"precisions": {
|
| 4 |
+
"float": {
|
| 5 |
+
"universal_assets": {
|
| 6 |
+
"tflite": {
|
| 7 |
+
"tool_versions": {
|
| 8 |
+
"litert": "1.4.2"
|
| 9 |
+
},
|
| 10 |
+
"download_url": "https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/crestereo/releases/v0.51.0/crestereo-tflite-float.zip"
|
| 11 |
+
},
|
| 12 |
+
"qnn_dlc": {
|
| 13 |
+
"tool_versions": {
|
| 14 |
+
"qairt": "2.45.0.260326154327"
|
| 15 |
+
},
|
| 16 |
+
"download_url": "https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/crestereo/releases/v0.51.0/crestereo-qnn_dlc-float.zip"
|
| 17 |
+
},
|
| 18 |
+
"onnx": {
|
| 19 |
+
"tool_versions": {
|
| 20 |
+
"onnx_runtime": "1.24.3"
|
| 21 |
+
},
|
| 22 |
+
"download_url": "https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/crestereo/releases/v0.51.0/crestereo-onnx-float.zip"
|
| 23 |
+
}
|
| 24 |
+
}
|
| 25 |
+
}
|
| 26 |
+
}
|
| 27 |
+
}
|