Skip to content

Commit 2e99ecf

Browse files
committed
Improve offset documentation
1 parent 6769777 commit 2e99ecf

File tree

4 files changed

+8
-3
lines changed

4 files changed

+8
-3
lines changed
24.6 MB
Loading
25 MB
Loading
-913 KB
Binary file not shown.

docs/examples_xrp.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -203,14 +203,19 @@ Then click the run button in the top right corner:
203203
<figcaption markdown>Run Button</figcaption>
204204
</figure>
205205

206+
The offset values depend on the [axes conventions](https://en.wikipedia.org/wiki/Axes_conventions) that you choose for your robot. Below are 2 animations showing ENU (East-North-Up) and NWU (North-West-Up) axes conventions with the XRP, and the required offset values for the indicated location of the OTOS for each. In this case, the sensor is mounted 2 inches to the right ("East"), 4 inches forward ("North"), and with the x-axis to the right ("East").
206207

207-
If the sensor is mounted 5 inches to the left (negative X) and 10 inches forward (positive Y) of the center of the robot, and mounted 90 degrees clockwise (negative rotation) from the robot's orientation, the offset would be {-5, 10, -90}. These can be any value, even the angle can be tweaked slightly to compensate for imperfect mounting (eg. 1.3 degrees).
208+
<figure markdown>
209+
[![OTOS offsets with ENU axes conventions](assets/img/SEN-24904-XRP-Offset-ENU.gif){ width="600" }](assets/img/SEN-24904-XRP-Offset-ENU.gif "Click to enlarge")
210+
<figcaption markdown>OTOS offsets with ENU axes conventions</figcaption>
211+
</figure>
208212

209213
<figure markdown>
210-
[![The X, Y, and Angular Offset of the Optical Tracking Sensor](assets/img/SEN-24904-XRP-XY-Offset.jpg){ width="600" }](assets/img/SEN-24904-XRP-XY-Offset.jpg "Click to enlarge")
211-
<figcaption markdown>The X, Y, and Angular Offset of the Optical Tracking Sensor</figcaption>
214+
[![OTOS offsets with NWU axes conventions](assets/img/SEN-24904-XRP-Offset-NWU.gif){ width="600" }](assets/img/SEN-24904-XRP-Offset-NWU.gif "Click to enlarge")
215+
<figcaption markdown>OTOS offsets with NWU axes conventions</figcaption>
212216
</figure>
213217

218+
With the ENU convention, the OTOS axes are aligned with the robot axes, so the offset angle is zero. With the NWU convention, the OTOS axes are rotated -90 degrees (right-hand rule about the "up" z-axis) relative to the robot axes. So the offset values would be `{2, 4, 0}` for ENU and `{4, -2, -90}` for NWU. These can be any value, even the angle can be tweaked slightly to compensate for imperfect mounting (eg. 1.3 degrees).
214219

215220
These four examples cover the basics - there are more examples to explore in the GitHub Repo!
216221

0 commit comments

Comments
 (0)