Struct SimState 

pub struct SimState { /* private fields */ }

Simulation state.

Contains all state variables needed to reproduce the simulation.

Implementations

impl SimState

pub fn new() -> Self

Create a new empty state.

pub fn num_bodies(&self) -> usize

Get number of bodies.

pub fn add_body(&mut self, mass: f64, position: Vec3, velocity: Vec3)

Add a body to the simulation.

pub fn masses(&self) -> &[f64]

Get body masses.

pub fn positions(&self) -> &[Vec3]

Get body positions.

pub fn positions_mut(&mut self) -> &mut [Vec3]

Get mutable body positions.

pub fn velocities(&self) -> &[Vec3]

Get body velocities.

pub fn velocities_mut(&mut self) -> &mut [Vec3]

Get mutable body velocities.

pub fn forces(&self) -> &[Vec3]

Get body forces.

pub fn forces_mut(&mut self) -> &mut [Vec3]

Get mutable body forces.

pub fn set_position(&mut self, index: usize, position: Vec3)

Set position for a body.

Panics

Panics if index is out of bounds.

pub fn set_velocity(&mut self, index: usize, velocity: Vec3)

Set velocity for a body.

Panics

Panics if index is out of bounds.

pub fn apply_force(&mut self, index: usize, force: Vec3)

Apply force to a body.

Panics

Panics if index is out of bounds.

pub fn clear_forces(&mut self)

Clear all forces (called at start of each step).

pub fn set_potential_energy(&mut self, energy: f64)

Set potential energy (called by domain engine).

pub fn kinetic_energy(&self) -> f64

Get total kinetic energy.

pub const fn potential_energy(&self) -> f64

Get potential energy.

pub fn total_energy(&self) -> f64

Get total energy (kinetic + potential).

pub fn add_constraint(&mut self, name: impl Into<String>, violation: f64)

Add a constraint violation.

pub fn clear_constraints(&mut self)

Clear all constraints.

pub fn constraint_violations(&self) -> impl Iterator<Item = (String, f64)> + '_

Get constraint violations.

pub fn all_finite(&self) -> bool

Check if all state values are finite.

pub fn apply_event(&mut self, event: &SimEvent) -> SimResult<()>

Apply an event to the state.

Errors

Returns error if event cannot be applied.

Trait Implementations

impl Clone for SimState

fn clone(&self) -> SimState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SimState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SimState

fn default() -> SimState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SimState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SimState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.