stereolabs/zed-ros2-wrapper

무엇인가요

zed-ros2-wrapper 는 Stereolabs ZED 깊이 센서 카메라를 ROS 2 로봇 시스템 내에서 사용할 수 있게 해주는 공식 ROS 2 패키지입니다. CUDA를 지원하는 GPU에서 실행되는 ZED SDK를 감싸고, 카메라의 데이터를 표준 ROS 2 토픽으로 게시합니다.

주요 기능 (README에 설명됨)

기능	ROS 2에서 얻는 것
이미지 스트림	정규화/비정규화된 컬러 및 그레이스케일 이미지.
깊이	픽셀 단위의 깊이 맵.
포인트 클라우드	색상이 있는 3D 포인트 클라우드 (선택적 포인트 클라우드 전송 압축 포함).
위치 추적 및 매핑	오도메트리, SLAM 스타일 매핑, 지구 기준 위치 추정을 위한 선택적 GNSS 융합.
객체 탐지	GPU 가속된 내장 객체 탐지기 및 선택적 커스텀 YOLO 스타일 ONNX 모델.
바디 트래킹	인간의 스켈레톤 추출.
센서 데이터	IMU, 기압계, 자력계 (카메라가 지원하는 경우).
시뮬레이션 모드	NVIDIA Isaac Sim에서 스트리밍되는 가상 ZED에 대해 동일한 파이프라인을 실행 가능. 하드웨어 없이 테스트에 유용.
통합	NVIDIA Isaac ROS / NITROS와 연동하여 데이터 전송을 가속화.

실행 방법

사전 요구 사항 – Ubuntu 20.04/22.04/24.04/26.04, ZED SDK v5.2, CUDA, 그리고 지원되는 ROS 2 배포판 (Humble, Jazzy, Lyrical, Foxy (역호환용), 또는 개발자용 Rolling).
설치 – 리포지토리를 ROS 2 워크스페이스에 클론하고, rosdep로 종속성 설치 후 colcon build --symlink-install로 빌드.
실행 – 제공된 런치 파일 사용:
```
ros2 launch zed_wrapper zed_camera.launch.py camera_model:=<model>
```
<model> 을 사용 중인 ZED 모델로 변경하세요 (예: zed2i, zedx, virtual 등).
구성 – 모든 매개변수는 zed_wrapper/config 아래의 YAML 파일들 (예: common_stereo.yaml, zed2.yaml)에 있습니다. 해상도, 프레임레이트, 객체 탐지, 매핑, GNSS 융합 등을 활성화/비활성화할 수 있습니다.
시각화 – 미리 구성된 RViz2 설정이 제공됩니다. rviz2 -d ./zed_wrapper/config/rviz2/<model>.rviz 를 실행하거나, 헬퍼 zed_display_rviz2 패키지를 실행하세요.
시뮬레이션 – sim_mode:=true use_sim_time:=true 를 런치 명령에 추가하여, 합성 카메라 데이터를 스트리밍하는 Isaac Sim 인스턴스에 연결하세요.

누구에게 유용한가요?

로봇 개발자 : 고해상도 깊이, 객체 탐지, 또는 인간 자세 추정이 필요한 ROS 2 기반의 인식 파이프라인을 구축하는 사람.
연구자 : 실시간 영상 스트림에서 SLAM, GNSS 융합 위치 추정, AI 기반 객체 탐지 실험을 하는 사람.
시뮬레이션 엔지니어 : 하드웨어에 배포하기 전에 NVIDIA Isaac Sim에서 가상 ZED 카메라로 프로토타이핑하고 싶은 사람.

README에 기재된 제한 사항

일부 기능 (객체 탐지, 바디 트래킹, GNSS 융합, 2D 모드 등)은 오래된 1세대 ZED 카메라 또는 ZED X One 모델에서는 사용 불가능합니다.
포인트 클라우드 전송은 선택 사항입니다. 압축된 포인트 클라우드가 필요하면 ros-$ROS_DISTRO-point-cloud-transport 를 수동으로 설치해야 합니다.
이 패키지는 공식적으로 LTS ROS 2 릴리스에서만 테스트되었습니다. 새로운 비-LTS 릴리스는 작동할 수 있지만 보장되지 않습니다.
Jetson 플랫폼(JP6)에서는 CUDA_TOOLKIT_ROOT_DIR 를 nvidia-jetpack 패키지를 통해 설정해야 할 수 있습니다.

빠른 시작 체크리스트

# 1. 워크스페이스 설정
mkdir -p ~/ros2_ws/src && cd ~/ros2_ws/src
git clone https://github.com/stereolabs/zed-ros2-wrapper.git
cd ..
rosdep update && rosdep install --from-paths src --ignore-src -r -y

# 2. 빌드
colcon build --symlink-install --cmake-args=-DCMAKE_BUILD_TYPE=Release
source install/local_setup.bash

# 3. ZED 카메라 실행 (모델에 따라 변경)
ros2 launch zed_wrapper zed_camera.launch.py camera_model:=zed2i

위 정보는 리포지토리의 README에서 직접 가져온 것이며, 추가 기능은 추측되지 않았습니다.