Struct ImpedanceOptions 

pub struct ImpedanceOptions {
    pub gains: ImpedanceGains,
    pub torque_limits: [f64; 7],
    pub cutoff_frequency: f64,
    pub posture: Option<[f64; 7]>,
    pub ik: IkOptions,
    pub velocity_feedforward: bool,
    pub leash: Leash,
    pub project_joint_gains: bool,
}

Options of Backend::Impedance; cartesian and joint are the documented starting points and the with_* methods change one field each.

Fields

gains: ImpedanceGains

The gains of the law.

torque_limits: [f64; 7]

Per-joint clamp on the commanded torque, Nm, at most RATED_TORQUES. Default 86 on joints 1-4, 11.5 on 5-7.

cutoff_frequency: f64

Cutoff, Hz, of the crate’s first-order low-pass on the commanded torque; MAX_CUTOFF_FREQUENCY switches it off. Default 100.

posture: Option<[f64; 7]>

The configuration the Cartesian IK’s nullspace bias pulls toward; None, the default, is the configuration the loop starts in. Ignored by the joint interface.

ik: IkOptions

The Cartesian interface’s inverse kinematics. Ignored by the joint interface.

velocity_feedforward: bool

Whether the damping acts on the velocity error, Kd (dq_goal - dq), with dq_goal the goal’s velocity (the generator’s on the joint interface, the IK solution’s finite difference on the Cartesian one); false damps the absolute velocity, DROID parity, and a goal moving at v is then tracked Kd v / Kp behind. Default true.

leash: Leash

How far the desired state may run ahead of the measured one; see Leash.

project_joint_gains: bool

Whether the joint gains are projected into the nullspace of the Jacobian (N Kq N, N Kqd N, N = I - J⁺ J with the damped pseudoinverse of IkOptions::damping), so that the Cartesian gains alone are felt at the end effector; false leaves them unprojected, DROID parity. For the Cartesian interface: projected joint gains hold the nullspace only, so with zero Cartesian gains the end effector would be free. Default false.

Implementations

impl ImpedanceOptions

pub fn cartesian() -> Self

The defaults of the Cartesian interface: ImpedanceGains::CARTESIAN.

pub fn joint() -> Self

The defaults of the joint interface: ImpedanceGains::JOINT.

pub fn with_gains(self, gains: ImpedanceGains) -> Self

Sets the gains.

pub fn with_torque_limits(self, limits: [f64; 7]) -> Self

Sets the per-joint torque clamp, Nm.

pub fn with_cutoff_frequency(self, hertz: f64) -> Self

Sets the torque low-pass cutoff, Hz.

pub fn with_posture(self, posture: Option<[f64; 7]>) -> Self

Sets the IK’s posture (None: the start configuration).

pub fn with_ik(self, ik: IkOptions) -> Self

Sets the IK options.

pub fn with_velocity_feedforward(self, on: bool) -> Self

Switches the damping between the velocity error (true) and the absolute velocity.

pub fn with_leash(self, leash: Leash) -> Self

Sets the leash.

pub fn with_project_joint_gains(self, on: bool) -> Self

Switches the projection of the joint gains into the Jacobian’s nullspace.

pub fn validate(&self) -> FrankaResult<()>

Checks the options without starting anything.

Errors

FrankaError::InvalidArgument naming the field: a gain that is not finite or negative, a torque limit, cutoff frequency or leash that is not finite and positive, a posture that is not finite, or invalid IkOptions.

Trait Implementations

impl Clone for ImpedanceOptions

fn clone(&self) -> ImpedanceOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ImpedanceOptions

impl Debug for ImpedanceOptions

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

Formats the value using the given formatter.

impl PartialEq for ImpedanceOptions

fn eq(&self, other: &ImpedanceOptions) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ImpedanceOptions