i/OrbbecSDK_ROS2
1
0
Fork 0
mirror of https://github.com/orbbec/OrbbecSDK_ROS2.git synced 2026-10-12 23:39:50 +08:00
Code Issues Packages Projects Releases Wiki Activity

Refactor predefined presets documentation for clarity and completeness

Browse Source
This commit is contained in:
ob-yalian
2026-01-19 15:21:14 +08:00
parent 31f72f27c4
commit a29d2eddf8
2 changed files with 125 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/en/source/camera_devices/5_advanced_guide/configuration/predefined_presets.md
+61 -11
View File
@@ -1,15 +1,65 @@
# Predefined presets #Device default
| Preset | Features | Recommended use cases | This document lists available presets, features, and recommended scenarios by product. Please select a preset name that matches the product model and set it as the value of the `device_preset` parameter.
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Default | - Best visual perception``- Overall good performance in accuracy, fill rate, tiny objects, etc. | - Generic `<br>`- Robotics |
| Hand | - Clear hand and finger edges | - Gesture recognition |
| High Accuracy | - Depth of high confidence `<br>`- Barely noise depth values `<br>`- Lower fill rate | - Collision avoidance `<br>`- Object scanning |
| High Density | - Higher fill rate `<br>`- More tiny objects `<br>`- May suffer from noise depth values | - Object recognition `<br>`- Pick & place `<br>`- Foreground & background animation |
| Medium Density | - Balanced performance in fill rate and accuracy `<br>`- In comparison to Default: lower fill rate, better edge quality | - Generic and alternative to Default |
| Custom | - User defined Preset `<br>`- Derived from Presets above, with customized modifications `<br>`- e.g. a new configuration for the post-processing pipeline, etc. | - Better depth performance achieved using customized configurations in comparison to using predefined presets `<br>`- For well-established custom configurations |
Choose the appropriate preset name based on your specific use case and set it as the value for the `device_preset` ## Gemini 330 / Gemini 330L / Gemini 335 / Gemini 335L
parameter.
| Defaults | Features | Recommended usage scenarios |
| --- | --- | --- |
| Default | Best visual effect<br> Overall performance is good, including typical indicators such as accuracy, filling rate, small object detection capability | General scenarios<br> Robot application |
| Hand | Clear hand and finger edges | Gesture recognition |
| High Accuracy | Highly reliable depth information<br> Very little depth noise<br> Relatively low depth fill rate | Obstacle avoidance<br> Object scanning |
| High Density | Higher depth filling rate<br> Can detect more small objects<br> More susceptible to depth noise | Object recognition<br> Grabbing<br> Foreground or background processing, such as cutout, etc. |
| Medium Density | Balanced depth fill rate and precision performance<br> Compared with default settings: relatively low fill rate, better edge quality | Universal scene, alternative to Default |
| Custom | Custom modifications, such as new configurations of post-processing pipelines, modifications to depth AE functions | By adjusting the depth configuration yourself, you can achieve better results than the predefined depth preset configuration<br> Fully proven customized depth configuration |
## Gemini 336 / Gemini 336L
| Defaults | Features |
| --- | --- |
| Default | The best visual effect<br> The overall performance is good, including typical indicators such as accuracy, filling rate, and small object detection capabilities |
| High Accuracy | Highly reliable depth information<br> Very little depth noise<br> Relatively low depth fill rate |
| Custom | Custom modifications, such as new configurations of post-processing pipelines and modifications to deep AE functions |
## Gemini 2
| Defaults | Features |
| --- | --- |
| Unbinned Dense Default | Depth Quality Priority |
| Binned Sparse Default | Small dead zone, low power consumption, high frame rate |
| Obstacle Avoidance | Robot obstacle avoidance mode |
## Gemini 2L
| Defaults | Features |
| --- | --- |
| Unbinned Dense Default | Depth Quality Priority |
| Dimensioning | Measurement accuracy is priority |
| Binned Sparse Default | Small dead zone, low power consumption, high frame rate |
| Unbinned Sparse Default | Balance quality and power consumption, improve low-reflection and semi-outdoor effects |
## Gemini 305
| Defaults | Features |
| --- | --- |
| Default | Best visual perception<br> Good overall performance in terms of accuracy, filling rate, small objects, etc. |
| High Accuracy | High confidence depth values<br> Virtually noiseless depth values<br> Low fill rate |
| Close Range High Accuracy | Adjustable larger parallax search range, Mini-Z reduction<br> The rest of the performance remains consistent with High Accuracy |
| Dual Color Streams | Supports left and right color streams at the same time, no depth IR information<br> The left and right output effects are consistent |
| Custom | Custom modifications, such as new configurations of post-processing pipelines and modifications to deep AE functions |
> Since the parameter configuration of `Dual Color Streams` mode is quite different from that of `Default` mode, we provide the corresponding YAML configuration file.
Please set `config_file_path` to `gemini305_dual_color.yaml`, the configuration file is located in the config directory.
## Extended presets
### G33X Close Range High Accuracy (Gemini 330 / Gemini 335 / Gemini 336)
| Defaults | Features | Recommended usage scenarios |
| --- | --- | --- |
| G33X Close Range High Accuracy | For the selected depth resolution, the depth value at the closest working distance will be reduced by 50%<br> The new closest working distance is 0.13m when close application is enabled<br> Supported depth resolutions: 1280x800/1280x720/640x400/424x266 only | Eye in hand and close range operation tasks<br> Close range measurement |
### G336X AMR Default (Gemini 336 / Gemini 336L)
| Defaults | Features | Recommended usage scenarios |
| --- | --- | --- |
| G336X AMR Default | Optimized for reliable depth performance in sunlit and repetitively textured warehouse scenes<br> Recommended depth resolutions: 1280x800 / 640x400 / 424x266 | Warehouse AMRs |
docs/zh/source/camera_devices/5_advanced_guide/configuration/predefined_presets.md
+64 -9
View File
@@ -1,12 +1,67 @@
# 设备预设 # 设备预设
| 预设 | 特点 | 推荐使用场景 | 本文档按产品列出可用预设、特点与推荐场景。请选择匹配产品型号的预设名称，并将其设置为`device_preset`参数的值。
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Default | - 最佳视觉感知<br>- 在精度、填充率、微小物体等方面的整体性能良好 | - 通用场景<br>- 机器人应用 | ## Gemini 330 / Gemini 330L / Gemini 335 / Gemini 335L
| Hand | - 清晰的手部和手指边缘 | - 手势识别 |
| High Accuracy | - 高置信度深度<br>- 几乎无噪声深度值<br>- 填充率较低 | - 避障<br>- 物体扫描 | | 预设 | 特点 | 推荐使用场景 |
| High Density | - 更高填充率<br>- 更多微小物体<br>- 可能存在噪声深度值 | - 物体识别<br>- 抓取和放置<br>- 前景和背景动画 | | --- | --- | --- |
| Medium Density | - 填充率和精度的平衡性能<br>- 与 Default 相比：填充率较低，边缘质量更好 | - 通用场景和 Default 的替代方案 | | Default | 最佳视觉效果<br> 整体性能较好，包括精度、填充率、小物体检测能力等典型指标 | 通用场景<br> 机器人应用 |
| Custom | - 用户自定义预设<br>- 从上述预设派生，具有自定义修改<br>- 例如后处理管道的新配置等 | - 通过使用自定义配置可获得比预定义预设更好的深度性能<br>- 适用于已建立的自定义配置 | | Hand | 清晰的手和手指边缘 | 手势识别 |
| High Accuracy | 高可靠的深度信息<br> 极少的深度噪声<br> 相对较低的深度填充率 | 避障<br> 物体扫描 |
| High Density | 更高的深度填充率<br> 可检测到更多的细小物体<br> 更容易受到深度噪声影响 | 物体识别<br> 抓取<br> 前景或背景处理，如抠图等 |
| Medium Density | 平衡的深度填充率和精度表现<br> 与默认设置相比：填充率相对较低，边缘质量更好 | 通用场景，可替代Default |
| Custom | 自定义修改，例如后处理管道的新配置、深度AE功能的修改 | 通过自行调整深度配置，可获得比预定义深度预置配置更好的效果<br> 经过充分验证的定制化深度配置 |
## Gemini 336 / Gemini 336L
| 预设 | 特点 |
| --- | --- |
| Default | 最佳视觉效果<br> 整体性能较好，包括精度、填充率、小物体检测能力等典型指标 |
| High Accuracy | 高可靠的深度信息<br> 极少的深度噪声<br> 相对较低的深度填充率 |
| Custom | 自定义修改，例如后处理管道的新配置、深度AE功能的修改 |
## Gemini 2
| 预设 | 特点 |
| --- | --- |
| Unbinned Dense Default | 深度质量优先 |
| Binned Sparse Default | 小盲区、低功耗、高帧率 |
| Obstacle Avoidance | 机器人避障模式 |
## Gemini 2L
| 预设 | 特点 |
| --- | --- |
| Unbinned Dense Default | 深度质量优先 |
| Dimensioning | 测量精度优先 |
| Binned Sparse Default | 小盲区、低功耗、高帧率 |
| Unbinned Sparse Default | 平衡质量和功耗，提升低反和半室外效果 |
## Gemini 305
| 预设 | 特点 |
| --- | --- |
| Default | 最佳视觉感知<br> 在精度、填充率、微小物体等方面整体性能良好 |
| High Accuracy | 高置信度深度值<br> 几乎无噪声深度值<br> 填充率较低 |
| Close Range High Accuracy | 可调更大视差搜索范围，Mini-Z减小<br> 其余表现与High Accuracy保持一致 |
| Dual Color Streams | 支持左右彩色同时出流，无深度IR信息<br> 左右路输出效果一致 |
| Custom | 自定义修改，例如后处理管道的新配置、深度AE功能的修改 |
> 由于 `Dual Color Streams` 模式的参数配置与 `Default` 模式差异较大，我们提供了对应的 YAML 配置文件。
请将 `config_file_path` 设置为 `gemini305_dual_color`，该配置文件位于 config 目录下。
## 扩展预设
### G33X Close Range High Accuracy（Gemini 330 / Gemini 335 / Gemini 336）
| 预设 | 特点 | 推荐使用场景 |
| --- | --- | --- |
| G33X Close Range High Accuracy | 对于选定的深度分辨率，最近工作距离的深度值将减小50%<br> 启用近距应用时新的最近工作距离为0.13m<br> 支持的深度分辨率：仅限1280x800/1280x720/640x400/424x266 | 眼在手上和近距离操作任务<br> 近距离测量 |
### G336X AMR Default（Gemini 336 / Gemini 336L）
| 预设 | 特点 | 推荐使用场景 |
| --- | --- | --- |
| G336X AMR Default | 优化其在阳光照射和重复纹理的仓库场景中具有可靠的深度性能<br> 推荐深度分辨率：1280x800 / 640x400 / 424x266 | 仓库AMRs |
根据您的具体使用场景选择合适的预设名称，并将其设置为 `device_preset` 参数的值。