AGXSimulator Item

The following additional properties are available in the AGXSimulator item.

Parameter

Default Value

Unit

Type

Description

NumThreads

1

threads

unsigned int

Number of threads used by AGX Dynamics. Parallelizes internal calculations (collision detection, solver). You can verify if it’s working by checking CPU usage with tools like top.

ContactReduction

true

-

bool

Enable/disable contact reduction feature. Specify true or false. Reduces solver computational load by eliminating unnecessary contact points.

ContactReductionBinResolution

3

bins

unsigned int

Number of bins for contact reduction. Specify 1-10. Number of bins used in the 6-dimensional bin packing algorithm.

ContactReductionThreshold

12

points

unsigned int

Threshold for starting contact reduction. When contact points between links exceed the specified threshold, contact reduction begins.

ContactWarmstarting

false

-

bool

When contact state is unchanged from the previous step, uses the previous solver solution to accelerate convergence calculations.

AMOR

false

-

bool

Merges stationary rigid bodies together to reduce solver computational load. Specify true or false. Each link must also be configured. See Additional Parameters for Body Models for details.

AutoSleep (deprecated)

false

-

bool

Removes stationary rigid bodies from the solver to reduce computational load. Specify true or false. Each link must also have autoSleep configured. See Additional Parameters for Body Models for details.

SaveToAGXFileOnStart

false

-

bool

Saves the scene in AGX Dynamics file format (.agx) when simulation starts. Save location is the directory where Choreonoid’s executable binary is located or the current directory at runtime. Can be used for debugging and performance verification with AGX Dynamics standalone.

DebugMessageOnConsole

warning

-

debug, info, warning, or error

Sets the type of messages output by AGXSimulator. debug: Displays AGX debugging messages. info: Shows forces applied to agxBreakableJoint, etc. warning: When shapes are incorrect, materials are missing from material table, etc. error: Fatal errors when simulation stops or crashes.