MARSIM 项目使用教程

1. 项目的目录结构及介绍

MARSIM 项目的目录结构如下：

MARSIM/
├── Utils/
│   ├── cascadePID/
│   ├── local_sensing/
│   ├── map_generator/
│   └── mars_drone_sim/
├── test_interface/
│   └── launch/
├── .gitignore
├── LICENSE
├── README.md
└── ubuntu20/

目录结构介绍

• Utils/: 包含项目中使用的各种工具和辅助功能模块。

  • cascadePID/: 用于控制无人机的PID控制器。
  • local_sensing/: 用于本地传感数据的处理。
  • map_generator/: 用于生成地图数据。
  • mars_drone_sim/: 包含无人机的模拟相关代码。

• test_interface/: 包含测试接口的相关文件。

  • launch/: 包含启动文件，用于启动模拟环境。

• .gitignore: Git 忽略文件，指定哪些文件和目录不需要被版本控制。

• LICENSE: 项目的许可证文件，采用 GPL-2.0 许可证。

• README.md: 项目的说明文件，包含项目的简介、安装和使用说明。

• ubuntu20/: 包含适用于 Ubuntu 20.04 的特定配置和代码。

2. 项目的启动文件介绍

在 test_interface/launch/ 目录下，有多个启动文件，用于启动不同的模拟场景。以下是一些主要的启动文件：

• single_drone_avia.launch: 用于启动单个无人机的模拟环境。
• exploration.launch: 用于启动带有 FUEL 算法的探索模拟环境。

启动文件示例

<launch>
    <!-- 启动单个无人机的模拟环境 -->
    <include file="$(find test_interface)/launch/single_drone_avia.launch"/>
</launch>

启动步骤

1. 进入项目工作空间：

   cd marsim_ws
   

2. 编译项目：

   catkin_make
   

3. 启动模拟环境：

   source devel/setup.bash
   roslaunch test_interface single_drone_avia.launch
   

3. 项目的配置文件介绍

MARSIM 项目的配置文件主要位于 test_interface/launch/ 目录下，这些配置文件用于设置模拟环境的参数，如地图、LiDAR 等。

配置文件示例

<launch>
    <!-- 设置地图参数 -->
    <arg name="map_file" default="$(find map_generator)/maps/map1.yaml"/>
    <arg name="use_gpu" default="false"/>

    <!-- 加载地图 -->
    <node name="map_server" pkg="map_server" type="map_server" args="$(arg map_file)"/>

    <!-- 启动无人机模拟 -->
    <node name="drone_sim" pkg="mars_drone_sim" type="drone_sim" output="screen">
        <param name="use_gpu" value="$(arg use_gpu)"/>
    </node>
</launch>

配置文件参数说明

• map_file: 指定使用的地图文件路径。
• use_gpu: 是否使用 GPU 加速，默认为 false。

通过修改这些配置文件中的参数，可以调整模拟环境的行为和性能。

---

以上是 MARSIM 项目的目录结构、启动文件和配置文件的详细介绍。希望这份教程能帮助你更好地理解和使用该项目。