측정된 도전과제 예제 코드 이해하기
리더보드의 예제 결과에는 과제별 참고 점수, 예제 코드 받기, 5회 기록 보기가 함께 표시됩니다. 과제를 선택하면 해당 예제가 나옵니다. 참고 예제는 참가자 순위 집계에서 제외됩니다.
아래 여섯 예제는 WWW-POSIM 도전과제 채점 규칙과 Python SDK 0.4.2를 사용합니다. 점수는 완료된 공식 실행 다섯 번의 결과입니다. 주석본과 실제 채점 원본을 함께 제공합니다. 게시 검사는 두 코드의 Python AST가 같은지 확인하며, 주석은 실행 로직을 바꾸지 않고 프로그램을 설명합니다. 기록에는 원래 제출 번호, 실행 ID와 배치 시드를 보존합니다.
| 과제 | 코드 | 5회 측정 점수 | 종합 | 기록 |
|---|---|---|---|---|
surface_station |
주석본 · 채점 원본 | 70.03, 16.03, 6.16, 0.74, 1.18 | 15.2108 | ↗ |
surface_gates |
주석본 · 채점 원본 | 20.35, 21.27, 20.08, 15.11, 20.17 | 18.5392 | ↗ |
surface_slalom |
주석본 · 채점 원본 | 16.00, 16.00, 16.00, 16.00, 1.00 | 10.6000 | ↗ |
underwater_gate |
주석본 · 채점 원본 | 13.33, 13.33, 13.33, 13.33, 13.34 | 13.3338 | ↗ |
underwater_path |
주석본 · 채점 원본 | 15.00, 15.00, 15.00, 15.00, 10.00 | 13.2002 | ↗ |
underwater_return |
주석본 · 채점 원본 | 13.33, 10.00, 6.67, 10.00, 10.01 | 9.3347 | ↗ |
예제 하나 실행하기
- 과제에 맞는 주석본을 내려받아
main.py로 저장하고 VS Code에서 여세요. 영문·한글 주석이 과제와 제어 블록을 설명합니다. - 설치형 앱에서 연습 경기장을 준비하고 같은 과제·조건을 선택하세요. ROS 2 직접 제어를 유지하고 생성한 월드를 시작하세요.
- 과제 카드의 채점 시작을 누른 뒤 프로젝트의 준비된 터미널에서
python main.py를 실행하세요. 전체 준비 과정은 설치형 앱 실습에 있습니다. - Ctrl+C 또는 입력 정지로 끝내세요. SDK가 제어권을 해제합니다. 이동 기록을 살핀 뒤 다음 실험에는 월드를 다시 시작하세요.
- 공식 결과를 받으려면 자율운항 도전과제 프로그램 제출하기를 따르세요. 서버가 자체 Python·SDK 환경을 준비합니다. 코드에 로그인 정보를 넣지 마세요.
각 과제의 제어기 역할
| 과제 | 목표 | 코드에서 사용하는 부분 |
|---|---|---|
surface_station |
목표 위치와 선수 방향에 도달해 연속으로 유지 | 접근·유지 히스테리시스, 방향 오차, 제한된 전진·회전 명령 |
surface_gates |
게이트를 순서대로 지나 통로로 복귀하고 출발점에서 유지 | 목표 진행, 역순 복귀 경유점과 정상 해류 보상 |
surface_slalom |
부표 코스를 지나 마지막 목표에서 유지 | 가시성 그래프 우회, 전진 전 방향 오차 제한과 해류 보상 |
underwater_gate |
잠항·게이트 통과 후 마지막 수심·방향 유지 | 게이트 평면 통과, 입구 쪽 재접근과 6개 추진기의 수심·자세 제어 |
underwater_path |
검사 목표와 각 목표의 수심·유지 조건 추종 | 검사 이동용 게인과 제한된 표류 보상 추진력 |
underwater_return |
장애물을 지나 복귀하고 마지막 부상·유지 수행 | 소형 선체 우회, 속도 오차 적분과 추진기 힘 배분 |
경로 예제들은 보조 함수를 공유합니다. mission['task']가 사용할 분기를 고르므로 다른 과제의 함수는 이번 실행에서 쓰이지 않을 수 있습니다. 제어기의 목표 번호는 자체 항법 상태입니다. 서버가 차량을 독립적으로 측정해 점수를 부여합니다.
블록별로 코드 읽기
- 연결·과제 정보:
Session.local(control=True)가 준비된 세션을 찾습니다.sim.profile['mission']에서 이번 목표·조건을 받으며 위치를 코드에 고정하지 않습니다. - 센서 입력: 메시지 종류로
nav_msgs/msg/Odometry를 선택합니다.sim.latest(..., max_age=0.5)는 최근 실제 시간 0.5초 안에 수신한 표본을 요구합니다. - 자세·목표 오차: 쿼터니언 자세를 yaw·roll로 바꿉니다. 위치와 과제 목표는 같은 map/world 축의 미터 값입니다. +z가 위쪽이므로 수중 목표 z는 음수입니다. 오도메트리 속도는 기체 축입니다. yaw·roll은 라디안, 과제의 해류 각도·변동각은 도 단위입니다.
- 항법 상태: 목표 근접, 게이트 평면 통과와 연속 유지를 확인합니다. 유지 조건을 벗어나면 로컬 타이머를 초기화합니다. 게이트 보조 함수는 공개 코스의 X 방향 평면을 가정합니다.
- 제어: WAM-V는 전진 m/s와 회전 rad/s 명령을 사용합니다. BlueROV2는 기본 조인트 순서의 추진력 6개를 N 단위로 사용합니다. 힘 배분에는 기본 모델의 45도 수평 추진기와 0.167m·0.109m 레버 암을 사용합니다.
- 시간: ROS 시각·유지 타이머·적분
dt는 시뮬레이션 초입니다. SDK 명령의duration=0.25는 실제 시간의 초이며, 10Hz로 명령을 갱신하고 반환 전에 명령 임대를 해제합니다. 시뮬레이터가 느리면 호출마다 진행하는 시뮬레이션 시간이 줄어듭니다. - 종료·오류:
control_lease_ended이면 정상적으로 루프를 끝냅니다. 다른 오류는 숨기지 않습니다.Session문맥을 벗어나면 세션을 닫고 제어권을 해제합니다.
다섯 기록으로 조정하기
게인을 바꾸기 전에 과제별 주석을 읽으세요. 거리→속도 게인, 방향 게인, 속도·힘 제한, 게이트 여유 또는 표류 보상 게인을 하나씩 조정하세요. 다섯 조건 전체의 경로·오차 값을 비교하세요. 수중 루프는 적분 추정값을 제한하고 고정 수직 트림을 사용하며, 이 값들은 기본 모델에 맞춘 값입니다.
표시 점수는 연결된 실제 측정 결과입니다. 새 실행 결과는 시간·환경 조건에 따라 달라질 수 있습니다. 학습용 제어기의 측정 점수는 높지 않으며 모든 자율운항 목표의 완료를 보장하지 않습니다. 주석은 채점 로직을 유지합니다. 실행문을 바꾸면 새 제어기이므로 다시 평가해야 합니다.