pub struct HillMuscleFacet {
pub max_isometric_force_n: f64,
pub optimal_fiber_length_m: f64,
pub tendon_slack_length_m: f64,
pub max_contraction_velocity_l0_s: f64,
pub pennation_angle_rad: f64,
}Expand description
Biomechanical muscle actuator facet based on Hill’s three-element muscle model.
$$F_{\text{muscle}}(t) = F_{\max}\left[a(t)\cdot f_L(\tilde{l})\cdot f_V(\tilde{v}) + f_P(\tilde{l})\right]\cos\alpha_{\text{penn}}$$
Fields§
§max_isometric_force_n: f64Maximum isometric force at optimal fiber length (N).
optimal_fiber_length_m: f64Optimal muscle fiber length $L_0$ (m).
tendon_slack_length_m: f64Elastic tendon slack length $L_s^T$ (m).
max_contraction_velocity_l0_s: f64Maximum contraction velocity normalized to $L_0$ ($s^{-1}$).
pennation_angle_rad: f64Muscle fiber pennation angle with respect to tendon line of action (radians).
Implementations§
Source§impl HillMuscleFacet
impl HillMuscleFacet
Sourcepub const fn new(
max_isometric_force_n: f64,
optimal_fiber_length_m: f64,
tendon_slack_length_m: f64,
max_contraction_velocity_l0_s: f64,
pennation_angle_rad: f64,
) -> Self
pub const fn new( max_isometric_force_n: f64, optimal_fiber_length_m: f64, tendon_slack_length_m: f64, max_contraction_velocity_l0_s: f64, pennation_angle_rad: f64, ) -> Self
Constructs a new Hill muscle facet.
Sourcepub fn active_force_length(l_norm: f64) -> f64
pub fn active_force_length(l_norm: f64) -> f64
Evaluates the active normalized force-length relationship $f_L(\tilde{l})$.
$$f_L(\tilde{l}) = \exp\left( - \left(\frac{\tilde{l} - 1.0}{0.45}\right)^2 \right)$$
Sourcepub fn force_velocity(v_norm: f64) -> f64
pub fn force_velocity(v_norm: f64) -> f64
Evaluates the normalized force-velocity relationship $f_V(\tilde{v})$.
Uses Hill’s hyperbola for concentric shortening ($\tilde{v} < 0$) and an eccentric plateau saturating up to 1.4 for lengthening ($\tilde{v} > 0$).
Sourcepub fn passive_force_length(l_norm: f64) -> f64
pub fn passive_force_length(l_norm: f64) -> f64
Evaluates the passive normalized force-length relationship $f_P(\tilde{l})$.
Exponential tension curve engaged when fiber length exceeds optimal length ($\tilde{l} > 1.0$).