Struct PackingOptimizer 

pub struct PackingOptimizer {
    pub config: OptimizerConfig,
    pub spheres: Vec<PackingSphere>,
    pub domain: [f64; 3],
    pub convergence: Vec<f64>,
    pub converged: bool,
}

Force-based packing optimizer.

Uses a soft-sphere repulsive potential to relax overlapping spheres toward a mechanically stable configuration.

Fields

config: OptimizerConfig

Optimizer configuration.

spheres: Vec<PackingSphere>

Spheres being optimized.

domain: [f64; 3]

Domain bounds.

convergence: Vec<f64>

Convergence history (max overlap at each iteration).

converged: bool

Whether the optimizer has converged.

Implementations

impl PackingOptimizer

pub fn new( spheres: Vec<PackingSphere>, domain: [f64; 3], config: OptimizerConfig, ) -> Self

Create a new optimizer.

pub fn step(&mut self) -> f64

Perform one optimization step.

Returns the maximum overlap after the step.

pub fn run(&mut self)

Run the optimizer until convergence or max iterations.

pub fn potential_energy(&self) -> f64

Compute the total potential energy of the packing.

pub fn packing_fraction(&self) -> f64

Compute the packing fraction after optimization.

pub fn max_overlap(&self) -> f64

Return the maximum overlap in the current configuration.