APEX · HR35 · QUICK GUIDE
공통 시험장
간소화 버전
실차 원본 PI로 움직이고,
같은 환경에서 동작과 지형을 확인합니다.
01 / 현재 위치
동작 시연과 연결 시험은 가능합니다.
움직임 · 관측 · 기록
- 원본 PI로 굴착부터 배토·복귀까지
- 목표·실제 버킷 궤적과 자세 비교
- 정답 / LiDAR 지형 입력과 결과 기록
정식 알고리즘 성능 비교
- 실차 전체 제어 경로의 동등성
- 센서·지도까지 포함한 완전 초기화
- 추종·토사·실차 정합의 정밀 평가
02 / 가능한 기능
필요한 기능만 모았습니다.
원본 PI 제어
기존 궤적·PI·출력 보상 유지
선회 중 버킷 중립 보조 OFF
기계·유압 구동
붐·암·버킷 실린더 구동
선회, 펌프 공유, 마찰 반영
실제 토양 작업
AGX 지형 변형·토사 입자
굴착·운반·배토·복귀
궤적·자세 표시
목표와 실제 이동 곡선
8곳의 버킷 윤곽과 각도
공통 지형 입력
현재 지형 + 목표 지형 + 영역
정답 / LiDAR 선택
검사·기록·정리
시작 상태 검사·통신 단절 정지
실행 기록과 자동 종료·정리
03 / 구성
제어와 물리 모델을 연결합니다.
기존 궤적 생성
굴착·배토 목표
실차 원본 PI
관절 제어·출력 보상
ROS 연결부
명령·관측 전달
Unity + AGX
기계·유압·토양
실행 관리
초기화 → 시작 검사 → 실행 → 기록·종료
지형 관측
정답 / LiDAR → 같은 형식의 지형 입력
04 / 물리 모델
유압과 토양을 포함한 간소 모델입니다.
붐 · 암 · 버킷
실린더 압력·유량을 계산해 관절에 힘을 적용합니다.
선회
속도 구동과 공유 유량 소비를 반영합니다.
상세 유압 모터의 차압→토크 모델은 아닙니다.
펌프 · 마찰
공유 유량 한계·공급압 강하·실린더 씰 마찰을 포함합니다.
차체 · 토양
중력·접촉·차체 운동, 지형 변형과 토사 입자를 계산합니다.
실차 보정, 관절핀별 마찰·백래시, 상세 전력·효율 모델은 추가 범위입니다.
주행·도저는 기반 경로가 있으나 현재 C 검증은 작업장치 중심입니다.
05 / 대표 시나리오
한 번 실행하면 작업 사이클을 확인합니다.
새 모델과 지형을 준비하고, 시작 상태가 기준과 맞을 때만 제어를 시작합니다.
굴착
기존 100점 궤적
들기
토사를 담아 상승
운반·선회
배토 위치로 이동
배토
토사를 내려놓기
복귀
원위치 후 정지
위 5단계를 내부 8개 제어 동작으로 실행합니다. 반복할 때는 새 세션을 준비합니다.
06 / 시각 확인
같은 화면에서 목표와 실제를 봅니다.
곡선은 이동 경로
목표와 실제 날 끝의
이동 차이를 확인합니다.
8곳의 버킷 모양
목표·실제 자세를
윤곽과 각도로 비교합니다.
각도는 자세 기준
지면 수평 대비
핀→날 방향의 각도입니다.
Unity Scene 표시 · 정밀 추종 오차는 로그로 별도 평가합니다.
07 / 지형 관측
지형의 출처를 선택할 수 있습니다.
Unity 정답 지형
시뮬레이터의 높이 격자를 읽습니다.
지형 입력 자체를 확인하는 기준입니다.
LiDAR 측정 지형
캐빈·붐 센서 → 기체 제거 → 높이맵
가림을 포함한 관측 입력을 확인합니다.
현재 지형
시간에 따라 갱신
목표 지형
시험 파일에 고정
작업 영역
작업할 칸을 선택
같은 좌표·형식으로 전달합니다. 보이지 않는 칸은 미관측으로 남깁니다.
LiDAR 모드는 정답 지형으로 빈칸을 채우지 않습니다. 현재 센서는 무잡음 모의 센서입니다.
08 / 목표 설정
파일에서 목표와 작업 영역을 정합니다.
공통 지형 입력 예제
38 × 67칸 · 한 칸 15cm
world 좌표의 높이(m)를 사용합니다.
예제: 작업 영역 20칸 · 목표 높이 −0.2m
그림은 영역 선택을 설명하는 개념도입니다.
① 목표 높이
각 칸에서 도달할 지형 높이
② 작업 영역
계산·작업할 칸만 선택
③ 지형 출처
실행할 때 정답 / LiDAR 선택
docs/benchmark/examples/terrain_task.json
09 / 시작하기 — 준비
준비된 연구 PC에서 시작합니다.
필요한 환경
- Unity 6.1 + AGX 라이선스
- ROS 2 Humble · 원본 PI 환경
- 허용된 HR35 모델·소스 접근
- C worktree · Unity 사용권 설정
현재 실행기는 연구 PC의 경로에 연결돼 있습니다.
새 PC에서는 경로·의존성 설정이 먼저 필요합니다.
python3 -B scripts/hr35_benchmark/prepare_live.py \ --terrain-task \ docs/benchmark/examples/terrain_task.json
출력 경로를 보관하세요.
준비 결과의 runtime 경로를
다음 실행 명령에 사용합니다.
모델은 전용 비공개 임시 폴더에 준비됩니다.
슬라이드 파일에 모델·라이선스는 포함하지 않습니다.
10 / 시작하기 — 실행
출처를 고르고 한 사이클 실행합니다.
source /home/hmlee/dev/APEX_hr35/ros2_ws/install/setup.bash BENCH_SESSION='여기에-준비된-runtime-절대경로' APEX_HR35_BENCH_SEQUENCE=cycle python3 -B scripts/hr35_benchmark/run_live.py \ "$BENCH_SESSION" --monitor 1 --probe original-pi \ --terrain-source lidar --review-seconds 30
정답 지형으로 바꾸려면
lidar → unity_truth
재실행마다 새 세션을 준비합니다.
QUEUED가 나오면 사용권 차례에 같은 명령을 재실행합니다.
중간에 정지하려면
다른 터미널에서 같은 runtime 경로를 지정합니다.
touch '/준비된/runtime/stop.request'
11 / 결과와 검증
화면과 저장된 판정을 함께 확인합니다.
원본 PI 동작 성공
최종 정답·LiDAR 모드 각각
사이클 17개 판정 통과
굴착 변화 관측
실제 지형과 LiDAR 양쪽에서
3cm 이상 낮아진 칸 확인
오프라인 검사 통과
입력·상태·기록 검사
높이 오류 주입·복원도 확인
어디에 저장되나요?
Library/Hr35BenchmarkSetup/session-…/
관측·명령·PI·지형 기록이 남습니다.
공유할 요약 판정은 docs/benchmark/evidence/에 보존합니다.
무엇부터 보나요?
pi_result.json — 동작 결과terrain_input.jsonl — 지형 입력 기록analyze_cycle.py / analyze_terrain.py — 독립 평가
근거: 최종 실행 ehxq0k4n / pgtw7pm9 · 센서 없는 원본 연결은 앞서 독립 재시작 3회 검증
12 / 확장 지점
새 알고리즘은 같은 입출력에 연결합니다.
공통 지형 입력
현재 높이 · 목표 높이 · 작업 영역
유효 여부 · 시각 · 지형 출처
/hr35_c/terrain/input
ROS domain 42 · JSON 메시지
작업 영역 전체가 유효할 때 계획 가능 표시.
미관측·만료 상태에서는 새 계획을 시작하지 않습니다.
MPC · DMP · 지형 기반 계획
새 목표 생성 또는 제어 출력을 연결하고,
같은 조건에서 별도 검증합니다.
제어기 비교 — 같은 궤적·지형·모델
궤적 생성기 비교 — 같은 제어기·작업 목표
기존 관절각·압력·명령 경계에 어댑터가 필요합니다.
현재는 자동 교체 기능이나 MPC/DMP 구현이 없습니다.
13 / 첫 사용 체크리스트
먼저 같은 시연을 재현해 보세요.
- 환경과 모델 접근 권한 확인
- 목표 파일·지형 출처 선택
- 새 세션 준비 → 한 사이클 실행
- 화면과 결과 판정 함께 확인
- 실험 조건을 고정한 뒤 확장
실행 · 관측 · 기록 기반
원본 PI 동작과 지형 관측을 재현합니다.
다음 완료 조건
전체 경로 동등성 · 완전 초기화
정밀 평가 · 새 알고리즘 연결
공개 소개 자료입니다. 실제 시험장 사용에는 별도의 개발 환경과 모델 접근 권한이 필요합니다.