Skip to content

Commit 013d577

Browse files
committed
Refactor coordinate systems documentation
1 parent baeca65 commit 013d577

File tree

2 files changed

+50
-42
lines changed

2 files changed

+50
-42
lines changed

docs/en/source/4_application_guide/coordinate_and_tf.md

Lines changed: 25 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,28 @@
1-
## ROS Robot Coordinate System vs Camera Optical Coordinate System
1+
## Coordinate Systems and TF Transforms
2+
3+
### Camera sensor structure
4+
5+
![module in rviz2](../image/application_guide/image3.png)
6+
7+
![module in rviz2](../image/application_guide/image1.png)
8+
9+
### TF from coordinate A to coordinate B:
10+
11+
In Orbbec cameras, the origin point (0,0,0) is taken from the camera_link position
12+
13+
Our wrapper provide static TFs between each sensor coordinate to the camera base (camera_link)
14+
15+
Also, it provides TFs from each sensor ROS coordinates to its corrosponding optical coordinates.
16+
17+
Example of static TFs of RGB sensor and right infra sensor of Gemini335 module as it shown in rviz:
18+
19+
```bash
20+
roslaunch orbbec_description view_model.launch.py model:=gemini_335_336.urdf.xacro
21+
```
22+
23+
![module in rviz2](../image/application_guide/image2.png)
24+
25+
### ROS Robot Coordinate System vs Camera Optical Coordinate System
226

327
* Observation perspective:
428
* Imagine we stand behind the camera looking forward.
@@ -253,25 +277,5 @@ if ((pid == FEMTO_BOLT_PID || pid == FEMTO_MEGA_PID) && enable_stream_[DEPTH] &&
253277
- Identify FEMTO series cameras by PID (FEMTO_BOLT, FEMTO_MEGA).
254278
- For FEMTO series, additionally compute the transform from depth to color sensor to ensure proper mapping across models.
255279
256-
### Camera sensor structure
257-
258-
![module in rviz2](../image/application_guide/image3.png)
259-
260-
![module in rviz2](../image/application_guide/image1.png)
261280
262-
### TF from coordinate A to coordinate B:
263-
264-
In Orbbec cameras, the origin point (0,0,0) is taken from the camera_link position
265-
266-
Our wrapper provide static TFs between each sensor coordinate to the camera base (camera_link)
267-
268-
Also, it provides TFs from each sensor ROS coordinates to its corrosponding optical coordinates.
269-
270-
Example of static TFs of RGB sensor and right infra sensor of Gemini335 module as it shown in rviz:
271-
272-
```bash
273-
roslaunch orbbec_description view_model.launch.py model:=gemini_335_336.urdf.xacro
274-
```
275-
276-
![module in rviz2](../image/application_guide/image2.png)
277281

docs/zh/source/4_application_guide/coordinate_and_tf.md

Lines changed: 25 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,28 @@
1-
## ROS机器人坐标系 vs 相机光学坐标系
1+
## 坐标系和 TF 变换
2+
3+
### 相机传感器结构
4+
5+
![相机模块结构图](../image/application_guide/image3.png)
6+
7+
![相机传感器布局](../image/application_guide/image1.png)
8+
9+
### 从坐标A到坐标B的TF变换:
10+
11+
在奥比中光相机中,原点(0,0,0)取自camera_link位置
12+
13+
我们的包装器提供从每个传感器坐标到相机基座(camera_link)的静态TF变换
14+
15+
同时,它还提供从每个传感器ROS坐标到其对应光学坐标的TF变换。
16+
17+
以下是Gemini335模块的RGB传感器和右红外传感器在rviz中显示的静态TF变换示例:
18+
19+
```bash
20+
roslaunch orbbec_description view_model.launch model:=gemini_335_336.urdf.xacro
21+
```
22+
23+
![rviz中的模块](../image/application_guide/image2.png)
24+
25+
### ROS机器人坐标系 vs 相机光学坐标系
226

327
* 观察视角:
428
* 想象我们站在相机后面,向前看。
@@ -254,24 +278,4 @@ if ((pid == FEMTO_BOLT_PID || pid == FEMTO_MEGA_PID) && enable_stream_[DEPTH] &&
254278
- 根据设备PID识别FEMTO系列相机(FEMTO_BOLT、FEMTO_MEGA)
255279
- 对于FEMTO系列相机,需要额外计算深度到颜色传感器的变换关系,确保了不同相机型号的坐标系正确映射
256280
257-
### 相机传感器结构
258-
259-
![相机模块结构图](../image/application_guide/image3.png)
260-
261-
![相机传感器布局](../image/application_guide/image1.png)
262281
263-
### 从坐标A到坐标B的TF变换:
264-
265-
在奥比中光相机中,原点(0,0,0)取自camera_link位置
266-
267-
我们的包装器提供从每个传感器坐标到相机基座(camera_link)的静态TF变换
268-
269-
同时,它还提供从每个传感器ROS坐标到其对应光学坐标的TF变换。
270-
271-
以下是Gemini335模块的RGB传感器和右红外传感器在rviz中显示的静态TF变换示例:
272-
273-
```bash
274-
roslaunch orbbec_description view_model.launch model:=gemini_335_336.urdf.xacro
275-
```
276-
277-
![rviz中的模块](../image/application_guide/image2.png)

0 commit comments

Comments
 (0)