Skip to content
This repository was archived by the owner on Oct 23, 2025. It is now read-only.

Commit d44beba

Browse files
authored
increase readability of rep 105 (#397)
* increase readability of rep 105 Signed-off-by: ARK3r <[email protected]>
1 parent d8f3db1 commit d44beba

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

rep-0105.rst

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ coordinate frames of mobile platforms used with ROS.
1818
Motivation
1919
==========
2020

21-
Developers of drivers, models, and libraries need a share convention
21+
Developers of drivers, models, and libraries need a shared convention
2222
for coordinate frames in order to better integrate and re-use software
23-
components. Shared conventions for coordinate frames provides a
23+
components. Shared conventions for coordinate frames provide a
2424
specification for developers creating drivers and models for mobile
2525
bases. Similarly, developers creating libraries and applications can
2626
more easily use their software with a variety of mobile bases that are
@@ -85,7 +85,7 @@ acting.
8585
**Map Conventions**
8686

8787
Map coordinate frames can either be referenced globally or to an application specific position.
88-
A example of an application specific positioning might be Mean Sea Level [#MSL]_ according to EGM1996 [#EGM96]_ such that the z position in the map frame is equivalent to meters above sea level.
88+
An example of an application specific positioning might be Mean Sea Level [#MSL]_ according to EGM1996 [#EGM96]_ such that the z position in the map frame is equivalent to meters above sea level.
8989
Whatever the choice is the most important part is that the choice of reference position is clearly documented for users to avoid confusion.
9090

9191
When defining coordinate frames with respect to a global reference like the earth:
@@ -106,7 +106,7 @@ The conventions above are strongly recommended for unstructured environments.
106106
**Map Conventions in Structured Environments**
107107

108108
In structured environments aligning the map with the environment may be more useful.
109-
An example structured environment such as an office building interior, which is commonly rectilinear and have limited global localization methods, aligning the map with building is recommended especially if the building layout is known apriori.
109+
An example of a structured environment is an office building interior, which is commonly rectilinear and has limited global localization methods, where aligning the map with the building is recommended especially if the building layout is known apriori.
110110
Similarly in an indoor environment it is recommended to align the map at floor level.
111111
In the case that you are operating on multiple floors it may make sense to have multiple coordinate frames, one for each floor.
112112

@@ -170,7 +170,7 @@ The basic topology should stay the same, however it is fine to insert additional
170170
**Pressure Altitude**
171171

172172
An example of a potential additional coordinate frame is one to represent pressure altitude for flying vehicles.
173-
Pressure altitude is an approximation of altitude based on a shared estimate of the atmospheric barometric pressure. [#pressure_altitude]_
173+
Pressure altitude is an approximation of altitude based on a shared estimate of the atmospheric barometric pressure [#pressure_altitude]_ .
174174
In flying applications pressure altitude can be measured precisely using just a barometric altimeter.
175175
It may drift in time like odometry but will only drift vertically.
176176
To be useful a ``pressure_altitude`` frame could be inserted between the inertially consistent ``odom`` frame and the ``map`` frame.
@@ -215,7 +215,7 @@ this information to broadcast the transform from ``map`` to ``odom``.
215215

216216
The transform from ``earth`` to ``map`` is statically published and
217217
configured by the choice of map frame. If not specifically configured
218-
a fallback position is to use the initial position of the vehicle as
218+
a fallback option is to use the initial position of the vehicle as
219219
the origin of the map frame.
220220
If the map is not georeferenced so as to support a simple static transform the localization module can follow the same procedure as for publishing the estimated offset from the ``map`` to the ``odom`` frame to publish the transform from ``earth`` to ``map`` frame.
221221

@@ -227,7 +227,7 @@ In an outdoor context map coordinate frame is a euclidian approximation of a vic
227227
In an indoor context this can be transitioning between two buildings where each has a prior map in which you are navigating or the robot is on a new floor of a building.
228228

229229
It is the responsibility of the localization frame authority to reparent the ``odom`` frame appropriately when moving between maps.
230-
The common implementation of computing the ``map`` to ``odom`` frame as the results of subtracting the ``odom`` to ``base_link`` from the localization fix ``map`` to ``base_link`` will take care of this implicitly when the choice of which ``map`` frame changes.
230+
The common implementation of computing the ``map`` to ``odom`` frame as the results of subtracting the ``odom`` to ``base_link`` from the localization fix ``map`` to ``base_link`` will take care of this implicitly when the choice of the ``map`` frame changes.
231231

232232
**odom Frame Consistency**
233233

@@ -245,7 +245,7 @@ If the vehicle travels a long enough distance that the distance from the ``odom`
245245
This is especially true of 32-bit floating point data used in things like pointclouds.
246246
If distances on this order are encountered a systematic reset of the ``odom`` frame origin may be required.
247247
If centimeter level accuracy is required the maximum distance to the ``odom`` frame is approximately 83km. [#floating_point]_
248-
There is not a standard solution to this, systems with this issue will need to work around it.
248+
There is not a standard solution to this; systems with this issue will need to work around it.
249249
Potential solutions include additional coordinate frames in which to persist obstacle data or to store obstacle data, or using higher precision.
250250

251251
Exceptions

0 commit comments

Comments
 (0)