Struct SandModel 

pub struct SandModel {
    pub relative_density: f64,
    pub critical_state_friction_angle: f64,
    pub d50: f64,
    pub specific_gravity: f64,
}

Sand model with relative density and dilatancy (Bolton’s approach).

Fields

relative_density: f64

Relative density Dr [-], 0 (loose) to 1 (dense).

critical_state_friction_angle: f64

Critical state friction angle φ_cs [radians].

d50: f64

Mean particle diameter d50 [m].

specific_gravity: f64

Specific gravity Gs [-].

Implementations

impl SandModel

pub fn new( relative_density: f64, critical_state_friction_angle_deg: f64, d50: f64, specific_gravity: f64, ) -> Self

Create a new sand model.

pub fn medium_dense_quartz() -> Self

Typical medium dense quartz sand.

pub fn loose_sand() -> Self

Loose sand.

pub fn peak_friction_angle(&self, dr: f64) -> f64

Peak friction angle [radians] using Bolton’s simplified formula.

φ_p = φ_cs + 5 * Ir (radians, Ir = dilatancy index)

pub fn dilatancy_index(&self, dr: f64, _stress_level: f64) -> f64

Bolton dilatancy index Ir = Dr*(Q - ln(p/kPa)) - R.

Q = 10 (quartz), R = 1.

pub fn bolton_dilatancy(&self, dr: f64, p_kpa: f64) -> f64

Bolton’s dilatancy formula with explicit pressure.

Ir = Dr*(Q - ln(p_kPa)) - R, clamped to [0, ∞)

pub fn e_max(&self) -> f64

Maximum void ratio (loosest packing) — approximate.

pub fn e_min(&self) -> f64

Minimum void ratio (densest packing) — approximate.

pub fn current_void_ratio(&self) -> f64

Current void ratio from relative density.

pub fn dry_unit_weight(&self) -> f64

Dry unit weight [kN/m^3].

Trait Implementations

impl Clone for SandModel

fn clone(&self) -> SandModel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SandModel

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

Formats the value using the given formatter.