This is a Julia package for using the Hybrid A* algorithm. Hybrid A* algorithm is typically used to find a drivable path for a Dubin's car in an obstacle rich environment. However, it can be used for other problems as well that fall in the same category! (Problems with continuous/discrete state space and finite action space)
- Junior: The Stanford entry in the Urban Challenge (Link)
- Practical Search Techniques in Path Planning for Autonomous Driving (Link)
- Application of Hybrid A* to an Autonomous Mobile Robot for Path Planning in Unstructured Outdoor Environments (Link)
hybrid_astar_search(goal, start_state, actions, dynamics, discretization, g, h; planning_time=0.2, lambda=1.0)
The function returns a sequence of actions that can be applied to the agent to take it from its starting position to its goal position.
goal::Any
: specifies the agent's goal location/set; Any object that supportsin(goal, state)
can be used.start_state::Any
: specifies the agent's starting stateactions::AbstractVector
: list of available agent actionsdynamics::Function
: function describing the dynamics of the agent. It takes in the state and an action as inputs and outputs the next resulting state. It will be called like this:next_state = dynamics(state, action)
discretization::Function
: function that is used to discretize the continuous agent state. It takes in the state as an input and outputs the corresponding discrete value. It will be called like this:discrete_key = discretization(state)
g::Function
: function that calculates the cost of transitioning from one state to the other. It takes in the old state, the new state, the applied action and the depth of the new state in the graph as inputs and outputs the corresponding cost. To penalize collision with obstacles in the environment, user should reflect it in this function.g
will be called like this:cost = g(old_state, new_state, action, new_depth)
h::Function
: function that calculates the heuristic cost of reaching the goal from any given state. It takes in the state as an input and outputs the corresponding heuristic cost. It will be called like this:heuristic_cost = h(state)
planning_time::Real=0.2
: specifies the planning time in seconds allocated to find a feasible pathlambda::Real=0.99
: specifies the discounting factor to weigh initial steps of the agent's trajectory more than the later steps
- [if path found] array of agent actions that can guide the agent from its start state to its goal region
- [if path not found] empty array
get_path(start_state, action_sequence, dynamics)
The function returns the path followed by the agent from a given starting state under a given dynamics function and given sequence of actions.
start_state::Any
: specifies the agent's starting state.action_sequence::AbstractVector
: array of agent actions to be applied in sequencedynamics::Function
: function describing the dynamics of the agent. It takes in the state and an action as inputs and outputs the next resulting state. It will be called like this:next_state = dynamics(state,action)
- array of agent states from its start state to the final state after applying all the actions in the action_sequence
-
A simple example to find path for a holonomic vehicle using the Hybrid A* algorithm can be found in examples/demo_holonomic_vehicle.jl
-
A more complex example of finding a drivable path for a Dubin's car using the Hybrid A* algorithm can be found in examples/demo_dubin_car.jl
In case of any queries, feel free to raise a Github Issue or reach out to the author via email at [email protected].