Browse Source

Mention passing side assumption of RVO avoidance

Mentions passing side assumption of RVO avoidance.

(cherry picked from commit bb3d8dc18503640d24a308d22e324b1d035ba8be)
smix8 1 year ago
parent
commit
d71d4b9d0f
1 changed files with 5 additions and 0 deletions
  1. 5 0
      tutorials/navigation/navigation_using_navigationagents.rst

+ 5 - 0
tutorials/navigation/navigation_using_navigationagents.rst

@@ -131,6 +131,11 @@ NavigationObstacles can be used to add some environment constrains to the avoida
 
     Avoidance does not affect the pathfinding. It should be seen as an additional option for constantly moving objects that cannot be (re)baked to a navigation mesh efficiently in order to move around them.
 
+.. note::
+
+    RVO avoidance makes implicit assumptions about natural agent behavior. E.g. that agents move on reasonable passing sides that can be assigned when they encounter each other.
+    This means that very clinical avoidance test scenarios will commonly fail. E.g. agents moved directly against each other with perfect opposite velocities will fail because the agents can not get their passing sides assigned.
+
 Using the NavigationAgent ``enable_avoidance`` property is the preferred option
 to toggle avoidance. The following code snippets can be used to
 toggle avoidance on agents, create or delete avoidance callbacks or switch avoidance modes.