Struct ScapuloHumeralCoupling
pub struct ScapuloHumeralCoupling {
pub setting_threshold_rad: f32,
pub gh_to_st_ratio: f32,
pub scapular_upward_axis: [f32; 3],
pub humeral_elevation_axis: [f32; 3],
pub humeral_shaft_axis: [f32; 3],
pub max_scapular_elevation_rad: f32,
}Expand description
Coupled glenohumeral-to-scapulothoracic rhythm (2:1 GH:ST above 30 deg elevation).
Fields§
§setting_threshold_rad: f32Setting-phase elevation threshold below which scapular rotation is zero (default: 30 deg).
gh_to_st_ratio: f32Glenohumeral-to-scapulothoracic incremental ratio above threshold (default: 2.0 for 2:1).
scapular_upward_axis: [f32; 3]Unit axis of scapulothoracic upward rotation in thorax frame.
humeral_elevation_axis: [f32; 3]Unit axis of humeral elevation in scapular frame.
humeral_shaft_axis: [f32; 3]Unit shaft axis of the resting humerus (orthogonal to humeral_elevation_axis).
max_scapular_elevation_rad: f32Maximum scapulothoracic upward rotation in radians (default: 60 deg).
Implementations§
§impl ScapuloHumeralCoupling
impl ScapuloHumeralCoupling
pub fn new(
setting_threshold_rad: f32,
gh_to_st_ratio: f32,
scapular_upward_axis: [f32; 3],
humeral_elevation_axis: [f32; 3],
) -> ScapuloHumeralCoupling
pub fn new( setting_threshold_rad: f32, gh_to_st_ratio: f32, scapular_upward_axis: [f32; 3], humeral_elevation_axis: [f32; 3], ) -> ScapuloHumeralCoupling
Constructs a scapulohumeral rhythm coupler with normalized axes and orthogonal shaft frame.
pub fn partition_elevation_rad(&self, total_elevation_rad: f32) -> (f32, f32)
pub fn partition_elevation_rad(&self, total_elevation_rad: f32) -> (f32, f32)
Partitions total_elevation_rad into (glenohumeral_rad, scapulothoracic_rad).
pub fn solve_coupled_quaternions(
&self,
total_humeral_q: [f32; 4],
) -> ([f32; 4], [f32; 4])
pub fn solve_coupled_quaternions( &self, total_humeral_q: [f32; 4], ) -> ([f32; 4], [f32; 4])
Decomposes desired thorax-relative humeral orientation total_humeral_q ([w, x, y, z])
into (scapulothoracic_q, glenohumeral_q) satisfying st_q * gh_q == total_humeral_q.
pub fn solve_coupled_motors(&self, total_humeral_local: Motor) -> (Motor, Motor)
pub fn solve_coupled_motors(&self, total_humeral_local: Motor) -> (Motor, Motor)
Decomposes a thorax-relative humeral local Motor into (scapulothoracic_motor, glenohumeral_motor).
Trait Implementations§
§impl Clone for ScapuloHumeralCoupling
impl Clone for ScapuloHumeralCoupling
§fn clone(&self) -> ScapuloHumeralCoupling
fn clone(&self) -> ScapuloHumeralCoupling
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more