Simulate Collision Avoidance

 
 
 

Updates actors' positions, velocities, and other data in a CrowdFX simulation, taking neighbors and walls into account.

This compound should be used in the Simulation region on the Point_Cloud object of a CrowdFX simulation.

Tasks: Crowds/Simulation

Output Ports: Execute

Mute

Disables the calculations. Connect a per-point value to affect individual points.

Target Speed

The speed that actors try to reach when there is no risk of collision. The Max Acceleration is set in Initialize Collision Avoidance.

For more information, see Controlling the Actor's Animation.

Execute Goal

Connect one of the Crowds/Goals compounds, such as Closest Goal, Goal Sequencer, or Follow Curve.

Alternatively, you can create and connect your own custom goal compound that sets the actors' CrowdFX_Goal_Position. If you want to use Crowd Look At Goal, then your compound should also set CrowdFX_Actor_PreviousGoalPosition and reset __CrowdFX_LookAtGoal_Counter to 0 when changing goals (to control the transition from looking at one goal to looking at the next).

Execute Before Avoidance Solver

Connect execute-type nodes to adjust any values that you want to take into account before the collision avoidance is calculated, such as Ignore Neighbors in Same Social Group.

Actor Avoidance

For more information, see Anticipating Collisions in the Simulation.

Anticipation Factor

Controls the time to a potential collision at which an actor starts turning. The rate of turning is controlled by Angular Velocity at Slow Speed and Angular Velocity at Target Speed in Initialize Collision Avoidance.

Anticipation Contrast

Controls the turning response based on the time to a potential collision. At high values, actors turn very slowly when a collision is far off but very quickly when it is close. At lower values, there is less difference in the amount of turning.

Braking Threshold

The time (in seconds) to a potential collision at which an actor starts to slow down. The Max Deceleration is set in Initialize Collision Avoidance.