use crate::error::Error;
use crate::traits::{JointTrajectoryClient, TrajectoryPoint};
use async_trait::async_trait;
use log::debug;
pub struct JointVelocityLimiter<C>
where
C: JointTrajectoryClient,
{
client: C,
velocity_limits: Vec<f64>,
}
impl<C> JointVelocityLimiter<C>
where
C: JointTrajectoryClient,
{
pub fn new(client: C, velocity_limits: Vec<f64>) -> Self {
assert!(client.joint_names().len() == velocity_limits.len());
Self {
client,
velocity_limits,
}
}
}
#[async_trait]
impl<C> JointTrajectoryClient for JointVelocityLimiter<C>
where
C: JointTrajectoryClient,
{
fn joint_names(&self) -> &[String] {
self.client.joint_names()
}
fn current_joint_positions(&self) -> Result<Vec<f64>, Error> {
self.client.current_joint_positions()
}
async fn send_joint_positions(
&self,
positions: Vec<f64>,
duration: std::time::Duration,
) -> Result<(), Error> {
Ok(self
.send_joint_trajectory(vec![TrajectoryPoint {
positions,
velocities: None,
time_from_start: duration,
}])
.await?)
}
async fn send_joint_trajectory(&self, trajectory: Vec<TrajectoryPoint>) -> Result<(), Error> {
let mut prev_positions = self.current_joint_positions()?;
let mut limited_trajectory = vec![];
let mut limited_duration_from_start = std::time::Duration::from_secs(0);
let mut original_duration_from_start = std::time::Duration::from_secs(0);
for (sequence_index, original_trajectory_point) in trajectory.iter().enumerate() {
let mut limited_duration_from_prev = std::time::Duration::from_secs(0);
let mut dominant_joint_index = 0;
for (joint_index, prev_position) in prev_positions.iter().enumerate() {
let single_duration = std::time::Duration::from_secs_f64(
(prev_position - original_trajectory_point.positions[joint_index]).abs()
/ self.velocity_limits[joint_index],
);
limited_duration_from_prev = if single_duration > limited_duration_from_prev {
dominant_joint_index = joint_index;
single_duration
} else {
limited_duration_from_prev
}
}
let original_duration_from_prev =
original_trajectory_point.time_from_start - original_duration_from_start;
original_duration_from_start = original_trajectory_point.time_from_start;
let use_limited = limited_duration_from_prev > original_duration_from_prev;
let selected_duration = if use_limited {
limited_duration_from_prev
} else {
original_duration_from_prev
};
limited_duration_from_start += selected_duration;
limited_trajectory.push(TrajectoryPoint {
positions: original_trajectory_point.positions.clone(),
velocities: original_trajectory_point.velocities.clone(),
time_from_start: limited_duration_from_start,
});
prev_positions = original_trajectory_point.positions.clone();
debug!(
"Sequence{} dominant joint_index {} duration limited : {:?}{} original : {:?}{}",
sequence_index,
dominant_joint_index,
limited_duration_from_prev,
if use_limited { "(O)" } else { "" },
original_duration_from_prev,
if use_limited { "" } else { "(O)" }
);
}
debug!("OriginalTrajectory {:?}", trajectory);
debug!("LimitedTrajectory {:?}", limited_trajectory);
Ok(self
.client
.send_joint_trajectory(limited_trajectory)
.await?)
}
}
#[cfg(test)]
mod tests {
use crate::DummyJointTrajectoryClient;
use assert_approx_eq::assert_approx_eq;
use std::sync::Arc;
use super::*;
#[test]
#[should_panic]
fn mismatch_size() {
let client = DummyJointTrajectoryClient::new(vec!["a".to_owned()]);
JointVelocityLimiter::new(client, vec![1.0, 2.0]);
}
#[test]
fn joint_names() {
let client = DummyJointTrajectoryClient::new(vec!["a".to_owned(), "b".to_owned()]);
let limiter = JointVelocityLimiter::new(client, vec![1.0, 2.0]);
let joint_names = limiter.joint_names();
assert_eq!(joint_names.len(), 2);
assert_eq!(joint_names[0], "a");
assert_eq!(joint_names[1], "b");
}
fn test_send_joint_positions(limits: Vec<f64>, expected_duration_secs: f64) {
let client = Arc::new(DummyJointTrajectoryClient::new(vec![
"a".to_owned(),
"b".to_owned(),
]));
let limiter = JointVelocityLimiter::new(client.clone(), limits);
assert!(tokio_test::block_on(
limiter.send_joint_positions(vec![1.0, 2.0], std::time::Duration::from_secs_f64(4.0))
)
.is_ok());
let joint_positions = limiter.current_joint_positions().unwrap();
assert_eq!(joint_positions.len(), 2);
assert_approx_eq!(joint_positions[0], 1.0);
assert_approx_eq!(joint_positions[1], 2.0);
let trajectory = client.last_trajectory.lock().unwrap();
assert_eq!(trajectory.len(), 1);
assert_eq!(trajectory[0].positions.len(), 2);
assert_approx_eq!(trajectory[0].positions[0], 1.0);
assert_approx_eq!(trajectory[0].positions[1], 2.0);
assert!(trajectory[0].velocities.is_none());
assert_approx_eq!(
trajectory[0].time_from_start.as_secs_f64(),
expected_duration_secs
);
}
#[test]
fn send_joint_positions_none_limited() {
test_send_joint_positions(vec![1.0, 2.0], 4.0);
}
#[test]
fn send_joint_positions_limited() {
test_send_joint_positions(vec![0.1, 2.0], 10.0);
test_send_joint_positions(vec![1.0, 0.2], 10.0);
test_send_joint_positions(vec![0.1, 0.6], 10.0);
test_send_joint_positions(vec![0.3, 0.2], 10.0);
}
fn test_send_joint_trajectory(limits: Vec<f64>, expected_durations_secs: [f64; 2]) {
let client = Arc::new(DummyJointTrajectoryClient::new(vec![
"a".to_owned(),
"b".to_owned(),
]));
let limiter = JointVelocityLimiter::new(client.clone(), limits);
assert!(tokio_test::block_on(limiter.send_joint_trajectory(vec![
TrajectoryPoint {
positions: vec![1.0, 2.0],
velocities: Some(vec![3.0, 4.0]),
time_from_start: std::time::Duration::from_secs_f64(4.0)
},
TrajectoryPoint {
positions: vec![3.0, 6.0],
velocities: Some(vec![3.0, 4.0]),
time_from_start: std::time::Duration::from_secs_f64(8.0)
}
]))
.is_ok());
let joint_positions = limiter.current_joint_positions().unwrap();
assert_eq!(joint_positions.len(), 2);
assert_approx_eq!(joint_positions[0], 3.0);
assert_approx_eq!(joint_positions[1], 6.0);
let trajectory = client.last_trajectory.lock().unwrap();
assert_eq!(trajectory.len(), 2);
assert_eq!(trajectory[0].positions.len(), 2);
assert_approx_eq!(trajectory[0].positions[0], 1.0);
assert_approx_eq!(trajectory[0].positions[1], 2.0);
assert!(trajectory[0].velocities.is_some());
assert_approx_eq!(trajectory[0].velocities.as_ref().unwrap()[0], 3.0);
assert_approx_eq!(trajectory[0].velocities.as_ref().unwrap()[1], 4.0);
assert_eq!(trajectory[1].positions.len(), 2);
assert_approx_eq!(trajectory[1].positions[0], 3.0);
assert_approx_eq!(trajectory[1].positions[1], 6.0);
assert!(trajectory[1].velocities.is_some());
assert_approx_eq!(trajectory[1].velocities.as_ref().unwrap()[0], 3.0);
assert_approx_eq!(trajectory[1].velocities.as_ref().unwrap()[1], 4.0);
assert_approx_eq!(
trajectory[0].time_from_start.as_secs_f64(),
expected_durations_secs[0]
);
assert_approx_eq!(
trajectory[1].time_from_start.as_secs_f64(),
expected_durations_secs[1]
);
}
#[test]
fn send_joint_trajectory_none_limited() {
test_send_joint_trajectory(vec![1.0, 2.0], [4.0, 8.0]);
}
#[test]
fn send_joint_trajectory_limited() {
test_send_joint_trajectory(vec![0.1, 2.0], [10.0, 30.0]);
test_send_joint_trajectory(vec![1.0, 0.2], [10.0, 30.0]);
test_send_joint_trajectory(vec![0.1, 0.6], [10.0, 30.0]);
test_send_joint_trajectory(vec![0.3, 0.2], [10.0, 30.0]);
test_send_joint_trajectory(vec![0.3, 2.0], [4.0, 4.0 + 2.0 / 0.3]);
test_send_joint_trajectory(vec![1.0, 0.8], [4.0, 4.0 + 4.0 / 0.8]);
}
}