ROS 점유 격자 맵 주석 달기

몇 시간의 SLAM 튜닝 끝에 아름다운 점유 격자가 생겼습니다. 이제 논문, 보고서, 발표에 계획된 경로가 그려지고, 목표 자세가 레이블되고, 금지 구역이 음영 처리된 형태로 넣어야 합니다. 이것이 drawtonomy의 ROS 맵 가져오기가 하는 일입니다.

drawtonomy가 .pgm + .yaml로 하는 것

drawtonomy는 ROS 맵 쌍 (.pgm 이미지 + .yaml 메타데이터)을 읽고:

• 올바른 미터 축척으로 점유 격자를 캔버스에 배치합니다.
• YAML의 resolution과 origin 필드를 사용하여 세계 좌표가 라운드트립됩니다.
• 위에 차선, 교차로, 차량, 보행자, 신호등, 자유 형식 화살표/텍스트를 그릴 수 있습니다.

그리기 레이어는 별도의 도형 세트입니다; 원본 .pgm은 수정되지 않습니다.

격자에 주석을 다는 이유

• 논문 그림. “그림 3: 장애물 주변 nav2 플래닝.” 빈 점유 격자는 거의 읽기 어렵습니다; 계획된 경로와 목표 자세가 있는 격자가 이야기를 전달합니다.
• 내부 문서. 금지 구역, 충전 도크 위치, 명명된 하위 영역이 주석으로 달린 SLAM 맵은 팀 교체를 견디는 아티팩트입니다.
• 강의 자료. nav2나 AMCL을 가르칠 때, 주석이 달린 격자로 학생들이 플래너가 보는 것을 볼 수 있습니다.
• 버그 재현. “로봇이 여기서 막혔습니다, 여기 격자가 있고, 여기 실패하는 계획 경로가 있습니다.”

drawtonomy 워크플로

1. 가져오기. 가져오기 → ROS 맵. .pgm과 .yaml 모두 드롭 (또는 zip으로 묶어서).
2. 축척 확인. yaml의 resolution과 origin이 자동으로 적용됩니다. drawtonomy 눈금자가 미터를 보여줍니다.
3. 주석 달기. 차선, 차량, 경로, 다각형, 텍스트 도형을 사용합니다. 낮은 불투명도의 다각형 도구가 금지 구역 음영에 잘 작동합니다.
4. .drawtonomy.svg로 저장합니다 (drawtonomy의 기본 SVG 형식). SLAM 맵의 주석은 거의 일회성이 아닙니다 — 새 금지 구역이 추가되고, 명명된 하위 영역이 변경되고, 맵 자체가 재녹화되기도 합니다. .drawtonomy.svg는 모든 주석이 그대로 다시 열리므로 반복이 재그리기가 아닌 편집이 됩니다.
5. 배포용으로 내보냅니다. 같은 장면에서, 확장 가능한 벡터가 필요하지 않은 문서용 PNG, 또는 논문과 슬라이드용 일반 SVG (격자를 래스터 배경으로, 주석을 벡터로)를 내보냅니다.

몇 가지 렌더링 팁

• 주석 레이어에 단일 강조 색상을 사용합니다. 그레이스케일 격자 위의 여러 색상은 시각적 노이즈를 만듭니다.
• 라인스트링과 텍스트 도형으로 수동으로 축척 바를 추가합니다 — drawtonomy는 자동으로 렌더링하지 않지만 눈금자가 주어진 길이가 몇 미터인지 정확히 알려줍니다.

한계

• drawtonomy는 격자를 자르기/팽창/회전하는 nav2의 map_server 편집 도구 (CLI 유틸리티)의 대체재가 아닙니다. 그를 위해서는 ROS 툴체인에 남아 있으세요.
• 주석 레이어는 drawtonomy 기본이므로; 원본으로 .drawtonomy.svg 파일을 보관하고, 다른 도구에서 주석 기하가 필요할 때만 일반 SVG를 내보냅니다.

가져오기 세부 사항은 ROS 점유 격자 가져오기 가이드를 참조하세요.