41. External Simulation

Note

Feature requires a Momentum Granular license.

Simulations can be executed outside of SpaceClaim/Algoryx Momentum in a external AGX Dynamics environment to increase simulation performance. These external simulations can produce journal files, similar to those produced inside of SpaceClaim. The external journal files are loaded and post processed in the Journal Viewer.

41.1. Usage

Click on the Simulate button in the External Simulation ribbon menu.

../_images/ExternalSimulationRibbon.png

This opens up a dialog with different settings for the external simulation. See more in the Settings section below.

41.1.1. Settings

Record Journal: Specifies whether an external journal should be created from a simulation.

Use Display Window: Specifies whether a display window should be used in the external simulation.

Computational threads: Specifies the number of threads to be used in the simulation.

Pause At: Specifies the time stamp in seconds when the simulation should pause. You can press e to toggle pause/play mode during an active external simulation.

Attention

The journal frequency of the recorded simulation will be the same as the document setting. See Record Frequency.

41.2. Record Options

Different properties of the particles can be selected to be recorded or not recorded into the journal. Fewer recorded properties will result in lower journal data size but this also means that less information can be used in the post processing stage.

Particle.velocity: Particle velocity property.

Particle.rotation: Particle rotational property.

Particle.color: Particle color property.

ParticlePairContact.localForce: Contact forces between particles.

ParticleGeometryContact.localForce: Contact forces between particles and geometries.

Attention

Recording contact forces is necessary for visualization of the granular contact network in Granular Post Processing.

../_images/ExternalSimulation.png

Executing an external simulation by pressing Launch Simulation opens an AGX Dynamics instance running the simulation in an external environment outside of Algoryx Momentum. This is done to increase the computational performance by skipping the overhead inside Algoryx Momentum Granular for large granular data sets.

Attention

For systems with more than 10000 granular particles, it is recommended to run an external simulation.

../_images/ESExample2.png