From e1d7bf2abb5b6eef88c8d98b5ed22012ef95ed1d Mon Sep 17 00:00:00 2001 From: Atsushi Sakai Date: Tue, 18 Jul 2017 16:36:05 -0700 Subject: [PATCH] update README --- .idea/preferred-vcs.xml | 6 + PathPlanning/StateLatticePlanner/Figure_3.png | Bin 0 -> 53326 bytes PathPlanning/StateLatticePlanner/Figure_4.png | Bin 0 -> 60776 bytes .../state_lattice_planner.py | 125 ++++++++++++++++-- README.md | 6 + 5 files changed, 128 insertions(+), 9 deletions(-) create mode 100644 .idea/preferred-vcs.xml create mode 100644 PathPlanning/StateLatticePlanner/Figure_3.png create mode 100644 PathPlanning/StateLatticePlanner/Figure_4.png diff --git a/.idea/preferred-vcs.xml b/.idea/preferred-vcs.xml new file mode 100644 index 00000000..848cfc44 --- /dev/null +++ b/.idea/preferred-vcs.xml @@ -0,0 +1,6 @@ + + + + ApexVCS + + \ No newline at end of file diff --git a/PathPlanning/StateLatticePlanner/Figure_3.png b/PathPlanning/StateLatticePlanner/Figure_3.png new file mode 100644 index 0000000000000000000000000000000000000000..09a4909dd109775c25b2ea935d733d70af2ef5fc GIT binary patch literal 53326 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 literal 0 HcmV?d00001 diff --git a/PathPlanning/StateLatticePlanner/Figure_4.png b/PathPlanning/StateLatticePlanner/Figure_4.png new file mode 100644 index 0000000000000000000000000000000000000000..3c468efd5723f6889197785b0c18e661061f85b9 GIT binary patch literal 60776 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 JQUS9J`!|YDudo0B literal 0 HcmV?d00001 diff --git a/PathPlanning/StateLatticePlanner/state_lattice_planner.py b/PathPlanning/StateLatticePlanner/state_lattice_planner.py index fc334c37..d8293557 100644 --- a/PathPlanning/StateLatticePlanner/state_lattice_planner.py +++ b/PathPlanning/StateLatticePlanner/state_lattice_planner.py @@ -60,7 +60,6 @@ def generate_path(states, k0): def calc_uniform_states(np, nh, d, a_min, a_max, p_min, p_max): """ - calc uniform state :param np: number of position sampling @@ -70,32 +69,90 @@ def calc_uniform_states(np, nh, d, a_min, a_max, p_min, p_max): :param a_max: position sampling max angle :param p_min: heading sampling min angle :param p_max: heading sampling max angle - :return: + :return: states list """ states = [] for i in range(np): a = a_min + (a_max - a_min) * i / (np - 1) - print(a) for j in range(nh): xf = d * math.cos(a) yf = d * math.sin(a) - yawf = p_min + (p_max - p_min) * j / (nh - 1) + a + if nh == 1: + yawf = (p_max - p_min) / 2 + a + else: + yawf = p_min + (p_max - p_min) * j / (nh - 1) + a + states.append([xf, yf, yawf]) return states +def calc_biased_states(goal_angle, ns, nxy, nh, d, a_min, a_max, p_min, p_max): + """ + calc biased state + + :param goal_angle: goal orientation for biased sampling + :param ns: number of biased sampling + :param nxy: number of position sampling + :param nxy: number of position sampling + :param nh: number of heading sampleing + :param d: distance of terminal state + :param a_min: position sampling min angle + :param a_max: position sampling max angle + :param p_min: heading sampling min angle + :param p_max: heading sampling max angle + :return: states list + """ + + cnav = [] + for i in range(ns - 1): + asi = a_min + (a_max - a_min) * i / (ns - 1) + cnavi = math.pi - abs(asi - goal_angle) + cnav.append(cnavi) + + cnav_sum = sum(cnav) + cnav_max = max(cnav) + + # normalize + for i in range(ns - 1): + cnav[i] = (cnav_max - cnav[i]) / (cnav_max * ns - cnav_sum) + + csumnav = np.cumsum(cnav) + di = [] + for i in range(nxy): + for ii in range(ns - 1): + if ii / ns >= i / (nxy - 1): + di.append(csumnav[ii]) + break + + states = [] + for i in di: + a = a_min + (a_max - a_min) * i + + for j in range(nh): + xf = d * math.cos(a) + yf = d * math.sin(a) + if nh == 1: + yawf = (p_max - p_min) / 2 + a + else: + yawf = p_min + (p_max - p_min) * j / (nh - 1) + a + states.append([xf, yf, yawf]) + + return states + + + def uniform_terminal_state_sampling1(): k0 = 0.0 - np = 5 + nxy = 5 nh = 3 d = 20 a_min = - math.radians(45.0) a_max = math.radians(45.0) p_min = - math.radians(45.0) p_max = math.radians(45.0) - states = calc_uniform_states(np, nh, d, a_min, a_max, p_min, p_max) + states = calc_uniform_states(nxy, nh, d, a_min, a_max, p_min, p_max) result = generate_path(states, k0) for table in result: @@ -112,14 +169,14 @@ def uniform_terminal_state_sampling1(): def uniform_terminal_state_sampling2(): k0 = 0.1 - np = 6 + nxy = 6 nh = 3 d = 20 a_min = - math.radians(-10.0) a_max = math.radians(45.0) p_min = - math.radians(20.0) p_max = math.radians(20.0) - states = calc_uniform_states(np, nh, d, a_min, a_max, p_min, p_max) + states = calc_uniform_states(nxy, nh, d, a_min, a_max, p_min, p_max) result = generate_path(states, k0) for table in result: @@ -134,10 +191,60 @@ def uniform_terminal_state_sampling2(): print("Done") +def biased_terminal_state_sampling1(): + k0 = 0.0 + nxy = 30 + nh = 2 + d = 20 + a_min = math.radians(-45.0) + a_max = math.radians(45.0) + p_min = - math.radians(20.0) + p_max = math.radians(20.0) + ns = 100 + goal_angle = math.radians(0.0) + states = calc_biased_states(goal_angle, ns, nxy, nh, d, a_min, a_max, p_min, p_max) + result = generate_path(states, k0) + + for table in result: + xc, yc, yawc = motion_model.generate_trajectory( + table[3], table[4], table[5], k0) + plt.plot(xc, yc, "-r") + + plt.grid(True) + plt.axis("equal") + plt.show() + + +def biased_terminal_state_sampling2(): + k0 = 0.0 + nxy = 30 + nh = 1 + d = 20 + a_min = math.radians(0.0) + a_max = math.radians(45.0) + p_min = - math.radians(20.0) + p_max = math.radians(20.0) + ns = 100 + goal_angle = math.radians(30.0) + states = calc_biased_states(goal_angle, ns, nxy, nh, d, a_min, a_max, p_min, p_max) + result = generate_path(states, k0) + + for table in result: + xc, yc, yawc = motion_model.generate_trajectory( + table[3], table[4], table[5], k0) + plt.plot(xc, yc, "-r") + + plt.grid(True) + plt.axis("equal") + plt.show() + + def main(): # uniform_terminal_state_sampling1() - uniform_terminal_state_sampling2() + # uniform_terminal_state_sampling2() + # biased_terminal_state_sampling1() + biased_terminal_state_sampling2() if __name__ == '__main__': diff --git a/README.md b/README.md index 874431ce..290788f7 100644 --- a/README.md +++ b/README.md @@ -46,6 +46,12 @@ This code uses the model predictive trajectory generator to solve boundary probl ![PythonRobotics/figure_1.png at master · AtsushiSakai/PythonRobotics](https://github.com/AtsushiSakai/PythonRobotics/blob/master/PathPlanning/StateLatticePlanner/Figure_2.png) +### Biased polar sampling results: + +![PythonRobotics/figure_1.png at master · AtsushiSakai/PythonRobotics](https://github.com/AtsushiSakai/PythonRobotics/blob/master/PathPlanning/StateLatticePlanner/Figure_3.png) + +![PythonRobotics/figure_1.png at master · AtsushiSakai/PythonRobotics](https://github.com/AtsushiSakai/PythonRobotics/blob/master/PathPlanning/StateLatticePlanner/Figure_4.png) + ## RRT