# ahnaf-2210007/kibo-robot-programming-2026 architecture

> Architecture diagram of the GitHub repository ahnaf-2210007/kibo-robot-programming-2026, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ahnaf-2210007/kibo-robot-programming-2026
- Repository: https://github.com/ahnaf-2210007/kibo-robot-programming-2026

## Overview

Kibo-RPC 7th Simulator is a ROS workspace for authoring participant programs and running them against the Web or local simulator. The documented participant workflow is to edit the sample program, submit a package to the Web simulator or run it locally, then inspect results and logs; replay is also supported. The tree and excerpts expose simulator-side judging, environment generation, status, and recording, plus ROS transform and image-processing libraries. Some subsystem links are documented only at a high level; unsampled implementation details are not inferred.

Main entry points: [`users/catkin_ws/src/krpc_user/scripts/user_template.py`](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/users/catkin_ws/src/krpc_user/scripts/user_template.py) (Sample Program), [`docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer.py`](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer.py) (Transform Buffer), [`docker/ros_python3_overlay/src/tf2_py/src/tf2_py.cpp`](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_py/src/tf2_py.cpp) (Python TF Binding), [`users/catkin_ws/src/krpc_api_server/scripts/krpc_api_node.py`](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/users/catkin_ws/src/krpc_api_server/scripts/krpc_api_node.py) (K-RPC API Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_participant["Participant Program"]
  node_user_program["Sample Program<br/>[user_template.py]"]
  node_user_node["C++ User Node"]
  node_api["K-RPC API Server<br/>[krpc_api_node.py]"]
  node_cheatsheet["Cheat Sheet Loader"]
end

subgraph group_simulator["Simulator Runtime"]
  node_judge["Game Judge<br/>[judge.py]"]
  node_environment["Environment Generator"]
  node_transforms_math["Transform Math<br/>[transformations.py]"]
  node_status["Status Indicator"]
  node_recorder["Flight Recorder"]
end

subgraph group_transforms["ROS Transforms"]
  node_tf2_native["Python TF Binding<br/>[tf2_py.cpp]"]
  node_tf2_buffer["Transform Buffer<br/>[buffer.py]"]
  node_tf2_interface["Buffer Interface"]
  node_tf2_client["Buffer Client<br/>[buffer_client.py]"]
  node_tf2_listener["Transform Listener"]
  node_tf2_broadcaster["Transform Broadcaster"]
  node_tf2_static["Static Broadcaster"]
end

subgraph group_vision["Vision Libraries"]
  node_cv_python["Python Image Bridge<br/>[core.py]"]
  node_cv_native["Native Image Bridge<br/>[cv_bridge.cpp]"]
  node_camera_model["Pinhole Camera Model"]
  node_stereo_model["Stereo Camera Model"]
end

node_developer(("Participant"))
node_web_sim["Web Simulator"]
node_local_sim["Local Simulator"]

node_developer -->|"edits"| node_user_program
node_developer -->|"edits"| node_user_node
node_user_program -->|"submit package"| node_web_sim
node_user_program -->|"run locally"| node_local_sim
node_api -->|"loads"| node_cheatsheet
node_environment -->|"uses"| node_transforms_math
node_tf2_interface -->|"imports"| node_tf2_native
node_tf2_client -->|"imports"| node_tf2_native
node_tf2_listener -->|"exports"| node_tf2_buffer
node_tf2_broadcaster -->|"exports"| node_tf2_buffer
node_tf2_static -->|"exports"| node_tf2_buffer
node_cv_python -.->|"uses extension"| node_cv_native

click node_user_program "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/users/catkin_ws/src/krpc_user/scripts/user_template.py"
click node_user_node "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/users/catkin_ws/src/krpc_user/src/user_template_node.cpp"
click node_api "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/users/catkin_ws/src/krpc_api_server/scripts/krpc_api_node.py"
click node_cheatsheet "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/users/catkin_ws/src/krpc_api_server/scripts/cheat_sheet_loader.py"
click node_judge "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/rootfs/krpc/judge_module/judge.py"
click node_environment "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/rootfs/krpc/random_env_generator/generate_objects.py"
click node_transforms_math "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/rootfs/krpc/random_env_generator/transformations.py"
click node_status "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/rootfs/krpc/status_indicator_module/krpc_status_indicator.py"
click node_recorder "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/rootfs/krpc/flight_recorder_module/krpc_flight_recorder.py"
click node_tf2_native "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_py/src/tf2_py.cpp"
click node_tf2_buffer "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer.py"
click node_tf2_interface "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer_interface.py"
click node_tf2_client "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer_client.py"
click node_tf2_listener "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/transform_listener.py"
click node_tf2_broadcaster "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/transform_broadcaster.py"
click node_tf2_static "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/static_transform_broadcaster.py"
click node_cv_python "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/vision_opencv/cv_bridge/python/cv_bridge/core.py"
click node_cv_native "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/vision_opencv/cv_bridge/src/cv_bridge.cpp"
click node_camera_model "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/vision_opencv/image_geometry/src/pinhole_camera_model.cpp"
click node_stereo_model "https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/vision_opencv/image_geometry/src/stereo_camera_model.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_user_program,node_user_node,node_api,node_cheatsheet toneBlue
class node_judge,node_environment,node_transforms_math,node_status,node_recorder toneAmber
class node_tf2_native,node_tf2_buffer,node_tf2_interface,node_tf2_client,node_tf2_listener,node_tf2_broadcaster,node_tf2_static toneMint
class node_cv_python,node_cv_native,node_camera_model,node_stereo_model toneRose
class node_developer,node_web_sim,node_local_sim toneIndigo
```

## Components

### Participant Program

- [Sample Program](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/users/catkin_ws/src/krpc_user/scripts/user_template.py): `users/catkin_ws/src/krpc_user/scripts/user_template.py`
- [C++ User Node](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/users/catkin_ws/src/krpc_user/src/user_template_node.cpp): `users/catkin_ws/src/krpc_user/src/user_template_node.cpp`
- [K-RPC API Server](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/users/catkin_ws/src/krpc_api_server/scripts/krpc_api_node.py): `users/catkin_ws/src/krpc_api_server/scripts/krpc_api_node.py`
- [Cheat Sheet Loader](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/users/catkin_ws/src/krpc_api_server/scripts/cheat_sheet_loader.py): `users/catkin_ws/src/krpc_api_server/scripts/cheat_sheet_loader.py`

### Simulator Runtime

- [Game Judge](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/rootfs/krpc/judge_module/judge.py): `rootfs/krpc/judge_module/judge.py`
- [Environment Generator](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/rootfs/krpc/random_env_generator/generate_objects.py): `rootfs/krpc/random_env_generator/generate_objects.py`
- [Transform Math](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/rootfs/krpc/random_env_generator/transformations.py): `rootfs/krpc/random_env_generator/transformations.py`
- [Status Indicator](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/rootfs/krpc/status_indicator_module/krpc_status_indicator.py): `rootfs/krpc/status_indicator_module/krpc_status_indicator.py`
- [Flight Recorder](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/rootfs/krpc/flight_recorder_module/krpc_flight_recorder.py): `rootfs/krpc/flight_recorder_module/krpc_flight_recorder.py`

### ROS Transforms

- [Python TF Binding](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_py/src/tf2_py.cpp): `docker/ros_python3_overlay/src/tf2_py/src/tf2_py.cpp`
- [Transform Buffer](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer.py): `docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer.py`
- [Buffer Interface](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer_interface.py): `docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer_interface.py`
- [Buffer Client](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer_client.py): `docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer_client.py`
- [Transform Listener](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/transform_listener.py): `docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/transform_listener.py`
- [Transform Broadcaster](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/transform_broadcaster.py): `docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/transform_broadcaster.py`
- [Static Broadcaster](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/static_transform_broadcaster.py): `docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/static_transform_broadcaster.py`

### Vision Libraries

- [Python Image Bridge](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/vision_opencv/cv_bridge/python/cv_bridge/core.py): `docker/ros_python3_overlay/src/vision_opencv/cv_bridge/python/cv_bridge/core.py`
- [Native Image Bridge](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/vision_opencv/cv_bridge/src/cv_bridge.cpp): `docker/ros_python3_overlay/src/vision_opencv/cv_bridge/src/cv_bridge.cpp`
- [Pinhole Camera Model](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/vision_opencv/image_geometry/src/pinhole_camera_model.cpp): `docker/ros_python3_overlay/src/vision_opencv/image_geometry/src/pinhole_camera_model.cpp`
- [Stereo Camera Model](https://github.com/ahnaf-2210007/kibo-robot-programming-2026/blob/main/docker/ros_python3_overlay/src/vision_opencv/image_geometry/src/stereo_camera_model.cpp): `docker/ros_python3_overlay/src/vision_opencv/image_geometry/src/stereo_camera_model.cpp`

### Other components

- **Participant**
- **Web Simulator**
- **Local Simulator**

## Connections

- Participant → Sample Program: edits (evidence: `README.md`)
- Participant → C++ User Node: edits (evidence: `README.md`)
- Sample Program → Web Simulator: submit package (evidence: `README.md`)
- Sample Program → Local Simulator: run locally (evidence: `README.md`)
- K-RPC API Server → Cheat Sheet Loader: loads (evidence: `users/catkin_ws/src/krpc_api_server/scripts/krpc_api_node.py`)
- Environment Generator → Transform Math: uses (evidence: `rootfs/krpc/random_env_generator/generate_objects.py`)
- Buffer Interface → Python TF Binding: imports (evidence: `docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer_interface.py`)
- Buffer Client → Python TF Binding: imports (evidence: `docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/buffer_client.py`)
- Transform Listener → Transform Buffer: exports (evidence: `docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/__init__.py`)
- Transform Broadcaster → Transform Buffer: exports (evidence: `docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/__init__.py`)
- Static Broadcaster → Transform Buffer: exports (evidence: `docker/ros_python3_overlay/src/tf2_ros/src/tf2_ros/__init__.py`)
- Python Image Bridge → Native Image Bridge: uses extension
