1291.59 시각적 편집 도구와의 친화성 (Affinity with Visual Editing Tools)

1. 시각적 편집 도구의 개념과 필요성

1.1 행동 트리 시각화의 공학적 의의

행동 트리(Behavior Tree, BT)는 트리(tree) 자료 구조에 기반한 행동 명세 체계이다. 트리 구조는 본질적으로 그래프(graph)의 특수한 형태이며, 노드와 간선(edge)으로 구성된 시각적 표현이 가능하다. 행동 트리의 시각적 표현에서 각 노드는 그래프의 정점(vertex)으로, 부모-자식 관계는 방향 간선(directed edge)으로 나타내어진다. 이 시각적 표현은 텍스트 기반 명세(XML 파일, 소스 코드)에 비하여 트리 구조의 전체적 형상과 분기 논리의 직관적 파악에서 인지적 이점을 갖는다.

시각적 편집 도구(visual editing tool)란, 행동 트리의 구조를 그래픽 사용자 인터페이스(Graphical User Interface, GUI)를 통하여 시각적으로 표시하고, 사용자의 마우스 및 키보드 조작에 의하여 노드의 추가, 삭제, 이동, 연결, 매개변수 설정 등의 편집 작업을 수행할 수 있는 소프트웨어 도구이다.

1.2 시각적 편집의 공학적 필요성

대규모 행동 트리는 수십에서 수백 개의 노드로 구성될 수 있으며, XML 텍스트만으로는 트리의 전체적 구조를 파악하기 어려워진다. 시각적 편집 도구는 다음의 공학적 필요성에 의하여 요구된다.

첫째, 트리 구조의 전체적 조망(overview)이다. 시각적 도구는 트리의 전체 구조를 하나의 화면에서 축소(zoom-out)하여 조망하거나, 특정 서브트리를 확대(zoom-in)하여 세부 구조를 검토하는 기능을 제공한다. XML 텍스트에서는 중첩의 깊이가 증가할수록 부모-자식 관계의 추적이 어려워지나, 시각적 표현에서는 간선에 의하여 이 관계가 즉시 식별된다.

둘째, 구조 변경의 즉시적 피드백이다. 노드의 추가나 순서 변경 시, 변경 결과가 즉시 시각적으로 반영되어 의도한 구조가 올바르게 형성되었는지를 확인할 수 있다. 텍스트 편집에서는 요소의 닫기 태그(closing tag)의 위치 오류 등에 의한 구조적 오류가 시각적으로 드러나지 않는다.

셋째, 실행 상태의 실시간 모니터링이다. 시각적 도구는 행동 트리의 실행 중에 각 노드의 반환 상태(Success, Failure, Running)를 색상이나 아이콘으로 실시간 표시하는 기능을 제공하여, 디버깅과 행동 검증을 지원한다.

2. Groot: BehaviorTree.CPP의 시각적 편집 도구

2.1 Groot의 개요

Groot는 BehaviorTree.CPP 프레임워크의 공식 시각적 편집 및 모니터링 도구이다. Davide Faconti에 의하여 개발되었으며, Qt 프레임워크 기반의 데스크톱 애플리케이션으로 구현되어 있다. Groot는 행동 트리의 설계, 편집, 저장, 그리고 실행 중 모니터링 기능을 통합적으로 제공한다.

Groot의 주요 기능은 다음과 같이 분류된다.

• 편집 모드(Editor Mode): 행동 트리의 구조를 시각적으로 설계하고 편집한다.
• 모니터 모드(Monitor Mode): 실행 중인 행동 트리의 상태를 실시간으로 시각화한다.
• 로그 재생 모드(Log Replay Mode): 기록된 실행 로그를 재생하여 과거의 행동 흐름을 분석한다.

2.2 편집 모드의 기능

Groot의 편집 모드에서 사용자는 노드 팔레트(node palette)로부터 노드 유형을 드래그 앤 드롭(drag and drop)하여 트리에 배치한다. 노드 간의 부모-자식 관계는 간선의 연결로 설정되며, 노드의 포트 매핑은 속성 편집기(property editor)를 통하여 지정된다.

편집 모드에서 수행되는 주요 작업은 다음과 같다.

• 제어 흐름 노드(Sequence, Fallback, Parallel 등)의 배치와 자식 노드의 연결
• 액션 노드(Action Node)와 조건 노드(Condition Node)의 트리 말단 배치
• 데코레이터 노드(Decorator Node)의 삽입
• 서브트리(SubTree) 참조의 생성
• 각 노드의 입출력 포트에 대한 블랙보드 키 매핑 또는 상수 값 지정
• 트리 구조의 유효성 검사

편집된 행동 트리는 BehaviorTree.CPP의 XML 형식으로 저장된다. 시각적 편집 도구의 출력이 XML 파일이라는 점이, 행동 트리의 XML 기반 선언적 정의와 시각적 편집 도구 간의 근본적인 연계 메커니즘이다.

2.3 모니터 모드의 기능

모니터 모드에서 Groot는 실행 중인 BehaviorTree.CPP 인스턴스에 네트워크 소켓(ZeroMQ 기반)을 통하여 연결된다. 연결이 수립되면, 행동 트리의 각 tick에서 모든 노드의 반환 상태가 Groot로 전송되며, Groot는 이 상태 정보를 시각적으로 렌더링한다.

각 노드는 반환 상태에 따라 다음과 같이 색상으로 표현된다.

이 실시간 시각화에 의하여, 행동 트리의 제어 흐름이 어떤 경로를 따라 진행되고 있는지, 어떤 노드에서 실패가 발생하는지, 어떤 노드가 장기간 Running 상태를 유지하는지를 즉시 파악할 수 있다. 이는 텍스트 로그(text log)에 기반한 디버깅에 비하여 행동 흐름의 직관적 이해에서 현저한 이점을 제공한다.

2.4 로그 재생 모드의 기능

BehaviorTree.CPP는 실행 중의 행동 트리 상태를 파일로 기록하는 로깅 기능을 제공한다. Groot의 로그 재생 모드에서는 이 기록 파일을 로드하여 과거의 실행 흐름을 시간 순서에 따라 재생할 수 있다. 재생 중에 특정 시점으로 이동(seeking)하거나, 재생 속도를 조절하여 문제 발생 시점의 행동 흐름을 정밀하게 분석하는 것이 가능하다.

이 기능은 현장에서 발생한 비정상 행동의 사후 분석(post-mortem analysis)에서 활용된다. 로봇의 운용 중 기록된 로그를 개발 환경에서 재생하여, 행동 트리의 어떤 분기에서 의도하지 않은 흐름이 발생하였는지를 시각적으로 추적할 수 있다.

3. XML 기반 선언적 정의와 시각적 도구 간의 연계

3.1 XML을 매개로 한 양방향 변환

행동 트리의 XML 기반 선언적 정의는 시각적 편집 도구와의 연계에서 중심적 역할을 수행한다. Groot는 XML 파일을 입력으로 받아 시각적 표현을 생성하고(XML → 시각적 표현), 시각적 편집의 결과를 XML 파일로 출력한다(시각적 표현 → XML). 이 양방향 변환에 의하여, 텍스트 편집기에서 XML을 직접 수정하는 것과 Groot에서 시각적으로 편집하는 것이 동일한 결과를 산출한다.

[XML 파일] ←→ [Groot 시각적 편집기] ←→ [BehaviorTree.CPP 실행 엔진]

이 아키텍처에서 XML 파일은 시각적 도구와 실행 엔진 사이의 공유 명세(shared specification) 역할을 수행한다. 시각적 도구는 XML 명세의 생성과 편집을 위한 사용자 인터페이스이며, 실행 엔진은 XML 명세의 해석과 실행을 담당한다.

3.2 TreeNodesModel의 시각적 도구 지원 기능

XML 명세 내의 <TreeNodesModel> 블록은 시각적 편집 도구에서 핵심적인 역할을 수행한다. 이 블록에 선언된 노드 유형과 포트 정보가 Groot의 노드 팔레트와 속성 편집기에 자동으로 반영된다.

<TreeNodesModel>
    <Action ID="NavigateToWaypoint">
        <input_port name="waypoint" type="geometry_msgs::msg::PoseStamped"/>
        <input_port name="speed" type="double" default="0.5"/>
        <output_port name="result" type="nav2_msgs::action::NavigateToPose::Result"/>
    </Action>
</TreeNodesModel>

위의 노드 모델 선언에 기반하여, Groot에서 NavigateToWaypoint 노드를 트리에 배치할 때, waypoint, speed, result 포트가 자동으로 표시되며, 각 포트의 데이터 유형과 기본값(default value)이 속성 편집기에 표시된다. 이에 의하여 사용자가 노드의 포트 인터페이스를 C++ 소스 코드를 참조하지 않고도 파악하고 설정할 수 있다.

3.3 표준화된 데이터 교환 형식의 이점

XML이 행동 트리의 표준 데이터 교환 형식(data interchange format)으로 기능함에 따라, 시각적 편집 도구의 구현이 특정 프레임워크의 내부 자료 구조에 종속되지 않는다. XML 스키마를 준수하는 한, Groot 이외의 시각적 도구나 코드 생성기(code generator)도 동일한 XML 파일과 상호운용(interoperation)할 수 있다.

이 표준화는 다음의 도구 생태계 확장을 가능하게 한다.

• 웹 기반 시각적 편집기의 개발
• CI/CD(Continuous Integration/Continuous Deployment) 파이프라인에서의 XML 자동 검증 도구 통합
• XML 명세로부터의 문서 자동 생성 도구 개발
• 복수의 시각적 도구 간 행동 트리 명세의 교환

4. 유한 상태 머신의 시각적 도구 지원과의 비교

유한 상태 머신(FSM)에 대한 시각적 편집 도구도 존재한다. SMACH의 smach_viewer, FlexBE의 FlexBE App 등이 그 예이다. 그러나 이러한 도구는 각 FSM 프레임워크에 특화된 독자적 데이터 형식과 프로토콜을 사용하며, 프레임워크 간의 상호운용성은 확보되어 있지 않다.

행동 트리의 XML 기반 선언적 정의가 시각적 편집 도구와의 연계에서 유한 상태 머신에 비하여 구조적 이점을 갖는 근본적 이유는, 행동 명세와 실행 코드가 XML 파일을 매개로 명확히 분리되어 있기 때문이다. 이 분리 구조가 시각적 도구의 설계를 단순화하고, 도구와 실행 엔진 간의 명확한 인터페이스를 제공한다.

5. 시각적 도구 친화성의 시스템 개발 효과

5.1 개발 주기의 단축

시각적 편집 도구에 의한 행동 트리의 설계는 설계-편집-검증 주기(design-edit-verify cycle)를 단축한다. 텍스트 기반 편집에서는 XML 파일의 수정, 저장, 실행, 결과 확인의 단계를 거치지만, 시각적 도구에서는 구조 변경의 결과가 즉시 시각적으로 확인되며, 모니터 모드를 통한 실행 검증이 동일 도구 내에서 수행된다.

5.2 팀 간 의사소통의 개선

시각적 표현은 텍스트 명세에 비하여 팀 구성원 간의 의사소통 매체로서 효과적이다. 행동 트리의 시각적 표현을 코드 리뷰, 설계 회의, 기술 문서에 활용함으로써, 소프트웨어 엔지니어와 도메인 전문가 간의 행동 설계에 대한 공동 이해(shared understanding)가 형성된다.

5.3 디버깅 효율의 향상

모니터 모드와 로그 재생 모드는 행동 트리의 디버깅 효율을 향상시킨다. 텍스트 로그에서 노드의 반환 상태를 시계열로 추적하는 것에 비하여, 시각적 도구에서 트리 구조 위에 상태가 색상으로 표시되는 방식은 문제 발생 지점의 식별에서 현저히 효율적이다. 특히 복수의 분기를 갖는 대규모 행동 트리에서, 실패 경로(failure path)의 추적이 시각적 도구에 의하여 용이해진다.

6. 시각적 도구 활용의 한계

6.1 대규모 트리의 시각적 표현 한계

노드 수가 수백 개를 초과하는 대규모 행동 트리에서는, 시각적 표현의 화면 내 배치가 어려워지며, 배치의 중첩이나 간선의 교차가 발생하여 가독성이 저하될 수 있다. 이에 대한 대응으로, 서브트리 단위의 접기(collapse) 기능과 계층적 탐색(hierarchical navigation) 기능이 활용된다.

6.2 자동화된 워크플로우와의 통합 제약

시각적 편집 도구는 사용자의 수동적 조작(manual interaction)을 전제로 한다. CI/CD 파이프라인이나 자동화된 빌드 시스템에서는 XML 파일의 직접적 처리가 시각적 도구를 경유하는 것보다 효율적이다. 그러나 XML 기반 정의의 특성에 의하여, 시각적 도구와 자동화 도구가 동일한 XML 파일을 공유하여 상호 보완적으로 활용될 수 있다.

7. 참고 문헌

• Faconti, D. (2022). BehaviorTree.CPP 4.x Documentation. https://www.behaviortree.dev/
• Faconti, D. (2022). Groot: A Graphical Editor for BehaviorTree.CPP. https://www.behaviortree.dev/groot
• Colledanchise, M., & Ögren, P. (2018). Behavior Trees in Robotics and AI: An Introduction. CRC Press.
• Iovino, M., Scukins, E., Styrud, J., Ögren, P., & Smith, C. (2022). “A Survey of Behavior Trees in Robotics and AI.” Robotics and Autonomous Systems, 154, 104096.
• Bohren, J., & Cousins, S. (2010). “The SMACH High-Level Executive.” IEEE Robotics and Automation Magazine, 17(4), 18–20.
• Schillinger, P., Kohlbrecher, S., & von Stryk, O. (2016). “Human-Robot Collaborative High-Level Control with Application to Rescue Robotics.” IEEE International Conference on Robotics and Automation (ICRA), 2796–2801.

버전: 2026-04-01