openrr-planner 0.1.0

Collision avoidance path planning for robotics
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use assert_approx_eq::assert_approx_eq;
use openrr_planner::*;

#[test]
fn test_funcs() {
    use std::f64::consts::PI;

    let limits: Vec<Option<k::joint::Range<f64>>> = vec![
        None,
        Some(k::joint::Range::new(-1.0, 1.0)),
        Some(k::joint::Range::new(0.0, 0.1)),
    ];
    for _ in 0..1000 {
        let angles = generate_random_joint_positions_from_limits(&limits);
        assert_eq!(angles.len(), limits.len());
        assert!(angles[0] >= -PI && angles[0] < PI);
        assert!(angles[1] >= -1.0 && angles[1] < 1.0);
        assert!(angles[2] >= 0.0 && angles[2] < 0.1);
    }
    let angles_fail = vec![0.1];
    assert!(generate_clamped_joint_positions_from_limits(&angles_fail, &limits).is_err());

    let angles1 = vec![100.0, -2.0, 0.5];
    let clamped = generate_clamped_joint_positions_from_limits(&angles1, &limits).unwrap();
    assert_approx_eq!(clamped[0], 100.0);
    assert_approx_eq!(clamped[1], -1.0);
    assert_approx_eq!(clamped[2], 0.1);
}

#[test]
fn test_interpolate_values() {
    use trajectory::{CubicSpline, Trajectory};

    // parameters for test
    let total_duration = 4.0_f64;
    let unit_duration = 0.01_f64;
    let points = vec![
        vec![0.0, -1.0],
        vec![2.0, -3.0],
        vec![3.0, 3.0],
        vec![1.0, 5.0],
    ];

    // preparing vector of times for interpolate
    let key_frame_unit_duration = total_duration / (points.len() as f64 - 1.0_f64);
    let time = (0_usize..points.len())
        .map(|t| t as f64 * key_frame_unit_duration)
        .collect::<Vec<f64>>();
    assert_eq!(time.len(), points.len());

    // interpolate
    let func_result = interpolate(&points, total_duration, unit_duration);
    let spline = CubicSpline::new(time, points).expect("failed interpolation");
    let t_points = match func_result {
        Some(some) => some,
        None => panic!("failed interpolation(Trajectory Points)"),
    };

    // preparing vector of times by unit_duration
    let time = (0..(total_duration / unit_duration) as i32)
        .map(|t| t as f64 * unit_duration)
        .collect::<Vec<f64>>();

    // check trajectory point, position, velocity and acceleration
    // check all time points
    for (t_point, t) in t_points.iter().zip(time) {
        // check value of all dimension
        t_point
            .position
            .iter()
            .zip(spline.position(t).unwrap())
            .for_each(|(t_point, correct)| {
                assert_approx_eq!(*t_point, correct);
            });
        t_point
            .velocity
            .iter()
            .zip(spline.velocity(t).unwrap())
            .for_each(|(t_point, correct)| {
                assert_approx_eq!(*t_point, correct);
            });
        t_point
            .acceleration
            .iter()
            .zip(spline.acceleration(t).unwrap())
            .for_each(|(t_point, correct)| {
                assert_approx_eq!(*t_point, correct);
            });
    }
}

#[test]
fn test_interpolation_ok() {
    let points = interpolate(&[vec![0.0, 1.0], vec![2.0, 0.0]], 1.0, 0.1).unwrap();
    assert_eq!(points.len(), 12);
    assert_approx_eq!(points[0].position[0], 0.0f64);
    assert_approx_eq!(points[0].position[1], 1.0f64);
    assert_approx_eq!(points[1].position[0], 0.2f64);
    assert_approx_eq!(points[1].position[1], 0.9f64);
}

#[test]
fn test_interpolation_with_same_values() {
    let points = interpolate(&[vec![0.0, 1.0], vec![0.0, 1.0]], 1.0, 0.1).unwrap();
    assert_eq!(points.len(), 12);
    for p in points {
        assert_approx_eq!(p.position[0], 0.0f64);
        assert_approx_eq!(p.position[1], 1.0f64);
    }
}

#[test]
fn test_interpolation_fail() {
    assert!(interpolate(&[vec![0.0, 1.0], vec![2.0]], 1.0, 0.1).is_none());
    // do not handle minus total duration
    assert!(interpolate(&[vec![0.0], vec![2.0]], -1.0, 0.1).is_none());
    // do not interpolate minus duration (no extrapolate)
    assert!(interpolate(&[vec![0.0], vec![2.0]], 1.0, -0.1).is_none());
}