|
1 | | -# LMR Simulation |
| 1 | +# LENNA Mobile Robot Simulation |
2 | 2 |
|
3 | | -## Interactive URDF Viewer |
| 3 | +<p align="center"> |
| 4 | + <img src="docs/media/lmr1_simulation.png" alt="LMR1 Simulation" width="900"> |
| 5 | +</p> |
4 | 6 |
|
5 | | -🌐 https://lenna-robotics-research-lab.github.io/LMR1-Simulation/ |
| 7 | +<p align="center"> |
| 8 | + <a href="https://lenna-robotics-research-lab.github.io/LMR1-Simulation/"> |
| 9 | + <img src="https://img.shields.io/badge/Interactive%20URDF-Open%20Viewer-blue?style=for-the-badge" alt="Interactive URDF Viewer"> |
| 10 | + </a> |
| 11 | +</p> |
6 | 12 |
|
7 | | -Explore the robot model directly in your browser: |
8 | | -- Orbit camera |
9 | | -- Joint manipulation |
10 | | -- TF visualization |
11 | | -- Link highlighting |
| 13 | +## Robot Overview |
| 14 | + |
| 15 | +LMR1 is a differential-drive mobile robot platform intended for research and education in: |
| 16 | + |
| 17 | +- Autonomous navigation |
| 18 | +- Mapping and localization |
| 19 | +- Robot intelligence |
| 20 | +- Decision making |
| 21 | +- Control systems |
| 22 | + |
| 23 | +The repository maintains equivalent ROS1 and ROS2 implementations to support both legacy and modern robotics workflows. |
| 24 | + |
| 25 | +## Repository Structure |
| 26 | + |
| 27 | +```mermaid |
| 28 | +flowchart TD |
| 29 | +
|
| 30 | + A[LMR Simulation] |
| 31 | +
|
| 32 | + A --> B[lmr1_description] |
| 33 | + A --> C[lmr2_description] |
| 34 | + A --> D[web_viewer] |
| 35 | + A --> E[docs] |
| 36 | +
|
| 37 | + B --> B1[launch] |
| 38 | + B --> B2[meshes] |
| 39 | + B --> B3[urdf] |
| 40 | + B --> B4[CMakeLists.txt] |
| 41 | + B --> B5[package.xml] |
| 42 | +
|
| 43 | + D --> D1[public] |
| 44 | + D --> D2[index.html] |
| 45 | + D --> D3[main.js] |
| 46 | + D --> D4[package.json] |
| 47 | + D --> D5[vite.config.js] |
| 48 | +
|
| 49 | + E --> E1[media] |
| 50 | +``` |
| 51 | + |
| 52 | + |
| 53 | +<table> |
| 54 | +<tr> |
| 55 | +<td width="50%" valign="top"> |
| 56 | + |
| 57 | +### ROS1 (Noetic) |
| 58 | + |
| 59 | +The ROS1 version provides a complete simulation environment for the LMR1 platform using the ROS Noetic/Melodic ecosystem. |
| 60 | + |
| 61 | +#### Features |
| 62 | + |
| 63 | +- Differential-drive mobile robot |
| 64 | +- URDF/Xacro robot description |
| 65 | +- Gazebo simulation |
| 66 | +- RViz visualization |
| 67 | +- SLAM Toolbox integration |
| 68 | +- AMCL localization |
| 69 | +- Navigation Stack support |
| 70 | + |
| 71 | +#### Quick Start |
| 72 | + |
| 73 | +```bash |
| 74 | +catkin_make |
| 75 | +source devel/setup.bash |
| 76 | +roslaunch lmr1_gazebo simulation.launch |
| 77 | +``` |
| 78 | + |
| 79 | +</td> |
| 80 | +<td width="50%" valign="top"> |
| 81 | + |
| 82 | +### ROS2 (Humble) |
| 83 | + |
| 84 | +The ROS2 version provides a modern simulation environment built on the ROS2 ecosystem and contemporary robotics workflows. |
| 85 | + |
| 86 | +#### Quick Start |
| 87 | + |
| 88 | +```bash |
| 89 | +colcon build |
| 90 | +source install/setup.bash |
| 91 | +ros2 launch lmr1_gazebo simulation.launch.py |
| 92 | +``` |
| 93 | + |
| 94 | +</td> |
| 95 | +</tr> |
| 96 | +</table> |
| 97 | + |
| 98 | + |
| 99 | +## License |
| 100 | + |
| 101 | +Specify your license here. |
0 commit comments