States#
A state holds the runtime data of a simulation: positions, velocities, forces, and the solver-specific variables that evolve each step. scene.get_state() returns a SimState, an aggregate snapshot of the whole scene that holds one per-solver state for each active solver. In practice, read state through the entity or solver getters and restore snapshots with scene.reset(state=...); see Checkpoints and simulation state and Conventions.
Simulation state#
Per-solver states#
- class genesis.engine.states.solvers.RigidSolverState(scene, s_global)[source]#
Bases:
objectDynamic state queried from a RigidSolver.
- property s_global#
- class genesis.engine.states.solvers.MPMSolverState(scene)[source]#
Bases:
RBCDynamic state queried from a MPMSolver.
- property scene#
- property pos#
- property vel#
- property C#
- property F#
- property Jp#
- property active#
- class genesis.engine.states.solvers.FEMSolverState(scene)[source]#
Bases:
object- property scene#
- property pos#
- property vel#
- property active#
- class genesis.engine.states.solvers.PBDSolverState(scene)[source]#
Bases:
objectDynamic state queried from a PBDSolver.
- property scene#
- property pos#
- property vel#
- property free#
Per-entity states#
- class genesis.engine.states.entities.RigidEntityState(entity, s_global)[source]#
Bases:
RBCDynamic state queried from a genesis RigidEntity.
- property entity#
- property s_global#
- property pos#
- property quat#
- class genesis.engine.states.entities.MPMEntityState(entity, s_global)[source]#
Bases:
RBCDynamic state queried from a genesis MPMEntity.
- property entity#
- property s_global#
- property pos#
- property vel#
- property C#
- property F#
- property Jp#
- property active#
- class genesis.engine.states.entities.FEMEntityState(entity, s_global)[source]#
Bases:
objectDynamic state queried from a genesis FEMEntity.
- property entity#
- property s_global#
- property pos#
- property vel#
- property active#
See also#
Checkpoints and simulation state: saving and restoring simulation state.
Conventions: tensor shape and dtype conventions.
Differentiable simulation: gradient-tracking state in differentiable simulation.