Skip to content

Commit 4431a36

Browse files
authored
Update README.md
1 parent 846e5d0 commit 4431a36

File tree

1 file changed

+16
-5
lines changed

1 file changed

+16
-5
lines changed

README.md

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
[![View Offroad-Navigation-for-Autonomous-Haul-Trucks on File Exchange](https://www.mathworks.com/matlabcentral/images/matlab-file-exchange.svg)](https://www.mathworks.com/matlabcentral/fileexchange/135472-offroad-navigation-for-autonomous-haul-trucks)
55
<!-- Add this icon to the README if this repo also appears on File Exchange via the "Connect to GitHub" feature -->
66

7-
Hauling material in an open pit mining requires a planning stack capable of both navigating at the global scale and avoiding obstacles during local path following. Navigation Toolbox&trade; offers planners and controllers that serve well for 2-D indoor planning but they can also be extended for 2.5-D offroad navigation. You can do this by deriving structure from terrain and incorporating heuristics into the planners to account for changes in elevation or slope. The solution proposed by this repository approaches the offroad navigation problem in three steps described in these three MLX files:
7+
Hauling material in an open pit mining requires a planning stack capable of both navigating at the global scale and avoiding obstacles during local path following. Navigation Toolbox&trade; offers planners and controllers that serve well for 2-D indoor planning but they can also be extended for 2.5-D offroad navigation. You can do this by deriving structure from terrain and incorporating heuristics into the planners to account for changes in elevation or slope. The solution proposed by this repository approaches the offroad navigation problem in multiple steps described in the following MLX files:
88

99
1. [![Open in MATLAB Online](https://www.mathworks.com/images/responsive/global/open-in-matlab-online.svg)](https://matlab.mathworks.com/open/github/v1?repo=mathworks-robotics/Offroad-Navigation-for-Autonomous-Haul-Trucks&project=AutonomousHaulTruck.prj&file=CreateRoutePlannerUsingDigitalElevationData.mlx) `CreateRoutePlannerUsingDigitalElevationData.mlx` — Process digital elevation data into a road network for route planning.
1010

@@ -16,23 +16,34 @@ Hauling material in an open pit mining requires a planning stack capable of both
1616

1717
3. [![Open in MATLAB Online](https://www.mathworks.com/images/responsive/global/open-in-matlab-online.svg)](https://matlab.mathworks.com/open/github/v1?repo=mathworks-robotics/Offroad-Navigation-for-Autonomous-Haul-Trucks&project=AutonomousHaulTruck.prj&file=CreateLocalPlannerToNavigateGlobalPath.mlx) `CreateLocalPlannerToNavigateGlobalPath.mlx` — Create a planner for following global reference paths while satisfying the kinematic and geometric constraints of the haul truck.
1818

19-
![Animation of truck using local planner](images/local_planner.gif)
19+
![Animation of truck using local planner](images/local_planner.gif)
2020

21-
Lastly, the repository has the [![Open in MATLAB Online](https://www.mathworks.com/images/responsive/global/open-in-matlab-online.svg)](https://matlab.mathworks.com/open/github/v1?repo=mathworks-robotics/Offroad-Navigation-for-Autonomous-Haul-Trucks&project=AutonomousHaulTruck.prj&file=ModelAndControlAutonomousHaulTruck.mlx) `ModelAndControlAutonomousHaulTruck` MLX file. This file shows how to use Simulink&reg; to integrate the road network and planners into an autonomous navigation stack with logic controlled by Stateflow&reg;.
21+
4. [![Open in MATLAB Online](https://www.mathworks.com/images/responsive/global/open-in-matlab-online.svg)](https://matlab.mathworks.com/open/github/v1?repo=mathworks-robotics/Offroad-Navigation-for-Autonomous-Haul-Trucks&project=AutonomousHaulTruck.prj&file=CreatePathFollowingMPCController.mlx) `CreatePathFollowingMPCController.mlx` — Create an MPC-based controller for efficiently following a reference-path while minimizing drift.
22+
23+
![Animation of truck using local planner](images/mpcPathFollower.gif)
24+
25+
Lastly, the repository has the [![Open in MATLAB Online](https://www.mathworks.com/images/responsive/global/open-in-matlab-online.svg)](https://matlab.mathworks.com/open/github/v1?repo=mathworks-robotics/Offroad-Navigation-for-Autonomous-Haul-Trucks&project=AutonomousHaulTruck.prj&file=ModelAndControlAutonomousHaulTruck.mlx) `ModelAndControlAutonomousHaulTruck` MLX file. This file shows how to use Simulink&reg; to integrate the road network and planners into an autonomous navigation stack with logic controlled by Stateflow&reg;.
2226

2327
This figure shows the top-level of the autonomous navigation stack.
2428
![Autonomous navigation stack Simulink model containing Stateflow logic, the road network, and planners](images/navigation_stack.png)
2529

30+
In R2024a, support for Unreal&reg; simulation was added:
31+
32+
![Animation of truck using local planner](images/unrealDemo.gif)
33+
2634
### MathWorks Products (https://www.mathworks.com)
2735

28-
Requires MATLAB release R2023b or newer
36+
Requires MATLAB release R2024a or newer
2937
- [MATLAB&reg;](https://www.mathworks.com/products/matlab.html)
3038
- [Simulink&reg;](https://www.mathworks.com/products/simulink.html)
3139
- [Navigation Toolbox&trade;](https://www.mathworks.com/products/navigation.html)
3240
- [Computer Vision Toolbox&trade;](https://www.mathworks.com/products/computer-vision.html)
3341
- [Image Processing Toolbox&trade;](https://www.mathworks.com/products/image.html)
3442
- [Automated Driving Toolbox&trade;](https://www.mathworks.com/products/automated-driving.html)
3543
- [Stateflow&reg;](https://www.mathworks.com/products/stateflow.html)
44+
- [Robotics System Toolbox&trade;](https://www.mathworks.com/products/robotics.html) (Optional)
45+
- [Simulink 3D Animation&trade;](https://www.mathworks.com/products/3d-animation.html) (Optional)
46+
- [Model Predictive Control Toolbox&trade;](https://www.mathworks.com/products/stateflow.html) (Optional)
3647

3748
## Installation
3849
Installation instuctions
@@ -48,7 +59,7 @@ The license is available in the license.txt file in this GitHub repository.
4859
## Community Support
4960
[MATLAB Central](https://www.mathworks.com/matlabcentral)
5061

51-
Copyright 2023 The MathWorks, Inc.
62+
Copyright 2023-2024 The MathWorks, Inc.
5263

5364
<!--- Do not forget to the add the SECURITY.md to this repo --->
5465
<!--- Add Topics #Topics to your Repo such as #MATLAB --->

0 commit comments

Comments
 (0)