Ubuntu 22.04 本地部署 Matterport3D-Simulator (从零开始的超详细安装指南)Ubuntu 22.04 本地部署 Matterport3D-Simulator (从零开始的超详细安装指南)

二、安装 Docker 与 NVIDIA 运行时

为了降低部署难度，我们推荐使用 Docker 容器化方案进行 Matterport3D-Simulator 的安装。首先，我们需要安装 Docker 引擎：

    sudo apt updatesudo apt install docker.iosudo systemctl start dockersudo systemctl enable docker  

接着安装 NVIDIA Container Toolkit，使 Docker 能够调用物理显卡进行 3D视觉 计算：

    distribution=$(. /etc/os-release;echo $ID$VERSION_ID)curl -s -L https://nvidia.github.io/libnvidia-container/gpgkey | sudo apt-key add -curl -s -L https://nvidia.github.io/libnvidia-container/$distribution/libnvidia-container.list | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.listsudo apt update && sudo apt install -y nvidia-container-toolkitsudo systemctl restart docker  

三、下载数据集与源码

由于版权原因，Matterport3D 数据集需要向官方申请。申请通过后，你将获得一个下载脚本。执行该脚本将数据放置在本地目录（例如 ~/data/v1/scans）。

获取模拟器源码：

    git clone --recursive https://github.com/pms67/Matterport3D-Simulator.gitcd Matterport3D-Simulator  

四、构建并运行容器

在源码根目录下，利用 Dockerfile 构建镜像。这一步会自动配置复杂的 机器人仿真 依赖库，如 OpenGL、EGL 等：

    docker build -t m3d_sim .  

构建完成后，启动容器并将数据集挂载进去：

    docker run --gpus all -it --env="DISPLAY" --volume="/tmp/.X11-unix:/tmp/.X11-unix:rw" --mount type=bind,source=$MATTERPORT_DATA_DIR,target=/data/v1/scans m3d_sim /bin/bash  

五、测试部署结果

在容器内部，运行示例脚本以验证环境是否安装成功：

    cd /Matterport3D-Simulator/build./main  

如果看到渲染出的室内场景窗口，说明你的 Matterport3D-Simulator 已经成功在 Ubuntu 22.04 部署！

总结

通过本文的讲解，我们从驱动安装、Docker 配置到源码编译，完成了 Matterport3D-Simulator 的完整部署。这将为你后续在 3D视觉 和 机器人仿真 领域的深入研究打下坚实的基础。如果在安装过程中遇到路径报错，请仔细检查 Docker 的挂载参数。