WWW-POSIM v0.6.16시뮬레이터 문서
문서 메뉴
WWW-POSIM / 시뮬레이터 문서

커스텀 센서

센서 설정은 차량 SDF에 들어 있습니다. 먼저 차량 편집기에서 사용할 센서를 선택한 뒤 시작 전 검토에서 SDF를 내려받으세요. 파일에는 활성 센서와 해당 차량이 지원하는 모든 센서의 주석 예제가 함께 들어 있습니다.

수정할 항목 선택하기

SDF 항목 바뀌는 내용
sensor / pose 장착 위치(m)와 롤·피치·요(rad)입니다. 로컬 X는 전방, Y는 왼쪽, Z는 위쪽입니다.
update_rate 시뮬레이션 시간 1초당 요청 측정 횟수입니다. 렌더링·중계 한도에 따라 실제 수신 빈도는 낮아질 수 있습니다.
camera / image / width, height 영상의 가로·세로 픽셀 수입니다. 업로드에도 차량 편집기의 픽셀 예산과 크기 한도가 적용됩니다.
camera / horizontal_fov 수평 화각(rad)입니다. 화각을 바꾸면 영상 기하와 보정 정보도 달라집니다.
camera / clip / near, far 가까운·먼 클리핑 평면(m)입니다. 0 < near < far ≤ 10000을 만족해야 합니다. 수중 안개로 실제 식별 거리는 더 짧을 수 있습니다.
lidar / scan, lidar / range 광선 각도, 표본 수와 측정 거리입니다. 센서 종류와 설치된 연결 경로를 유지하세요.
gz:dvl / maximum_range 해저 반사파를 사용하는 최대 거리입니다. DVL 어댑터에도 저장한 값이 적용됩니다.
noise 기존 잡음 모델의 파라미터입니다. 모델 종류는 유지하고 이미 있는 수치 항목을 수정하세요.
음향 플러그인 항목 공급자별 주파수, 빔 형상, 거리와 강도 처리 설정입니다. 설치된 음향 공급자와 센서 구현과 파라미터를 확인하세요.

클리핑 거리는 물에 의한 빛의 흡수와 다릅니다. 단일 Ping, DVL과 영상 소나도 각각 다른 값을 측정합니다. 거리 값만 늘려도 센서의 측정 방식이 바뀌지는 않습니다.

보정 정보와 연결 유지하기

수정한 SDF를 SDF 파일 편집 → 수정한 차량 SDF 올리기로 올리세요. 지원되는 장착 위치, 갱신 주파수, 영상 크기, 화각과 거리 값은 저장된 구성 정보와 센서 목록에도 반영됩니다. 새 세션은 저장된 SDF 자체를 사용하므로 허용된 다른 플러그인의 수치 설정도 보존됩니다.

토픽 이름, 좌표계 이름, 플러그인 파일명과 제어기 연결은 유지하세요. 센서를 추가하거나 삭제하려면 저장된 차량 → 복사 후 편집에서 구성한 뒤 내보내세요. 멀티빔 소나는 시뮬레이션 호스트에 호환 공급자가 있어야 합니다. DVL과 단일 Ping은 동시에 선택할 수 없습니다.

전체 예제와 결과 확인하기

WAM-V 전체 SDF와 BlueROV2 전체 SDF에서 전체 모델과 비활성 센서 예제를 볼 수 있습니다. 주석은 설명일 뿐 센서를 활성화하지 않습니다.

다시 시작한 뒤 센서 트리, 영상 크기, 타임스탬프와 장착 방향을 확인하세요. RViz와 Foxglove 뷰어로 출력도 살펴보세요. 검사에 실패하면 안내된 항목을 수정하세요. 허용 범위를 벗어난 값으로 실행 환경의 기능 한도를 늘릴 수는 없습니다.

선택 센서와 공급자

센서를 선택하기 전에 출력 종류와 실행 호스트의 지원 상태를 확인하세요. 공급자 필요로 비활성화된 항목은 해당 플러그인이 설치·검증된 호스트가 필요합니다. 웹 호스트와 내 컴퓨터의 공급자 구성은 다를 수 있습니다.

센서 확인할 출력과 용도
전방·하향 카메라 컬러 영상과 보정 정보. 장착 방향·시야각·해상도를 함께 확인합니다.
2D LiDAR · WAM-V 평면 거리 스캔. 대상이 스캔 높이 밖에 있으면 보이지 않습니다.
하향 단일 Ping 좁은 광선 묶음에서 변환한 단일 거리값. 영상 소나와 다른 출력이며 DVL과 동시에 선택하지 않습니다.
DVL 바닥 추적 속도와 상태. 유효한 바닥 반사가 필요하며 단일 Ping과 동시에 선택하지 않습니다.
전방 멀티빔 호환 음향 공급자를 사용한 거리·방위각 강도 영상. 물리 기반 소나 미리보기를 참고하세요.

센서를 추가하는 것만으로 SLAM 지도가 생기지는 않습니다. SLAM에는 호환 추정기, 필요한 센서, 보정·시간·좌표계가 함께 필요합니다. 영상 속 전용 SLAM 구성과 현재 호스트의 실행 가능 기능을 구분하고 POSIM-SLAM 문서를 확인하세요.

문서 검색