# dhiaelhak-rached/dracoviloc architecture

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

- Interactive diagram: https://gitdiagram.com/dhiaelhak-rached/dracoviloc
- Repository: https://github.com/dhiaelhak-rached/dracoviloc

## Overview

DracoViLoc combines camera-based YOLO detection with ODAS-separated audio and selectable audio classifiers, then optionally fuses directions through an EKF and tracks them with a robot arm. The documented workflow starts YOLO separately in an Isaac ROS container, then launches host-side audio, fusion, and mock-arm components. The graph preserves AST, GRE, and direct-tracking alternatives. Relationships are based on the README’s workflow and capability descriptions; unsampled implementations are represented by their exact paths, without asserting internal calls not shown.

Main entry points: [`src/odas_ros/odas_ros/lib_odas_server_node.py`](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/odas_ros/odas_ros/lib_odas_server_node.py) (ODAS audio pipeline), [`src/dracoviloc_ekf/src/ekf_node.cpp`](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_ekf/src/ekf_node.cpp) (Direction EKF), [`src/dracoviloc_bringup/launch/arm_audio_demo.launch.py`](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_bringup/launch/arm_audio_demo.launch.py) (Demo orchestration), [`isaac_ros/packages/isaac_ros_yolo_direction/isaac_ros_yolo_direction/direction_publisher.py`](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/isaac_ros/packages/isaac_ros_yolo_direction/isaac_ros_yolo_direction/direction_publisher.py) (YOLO direction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vision["Visual perception"]
  node_yolo_launch["YOLO launch"]
  node_yolo_direction["YOLO direction"]
end

subgraph group_audio["Audio perception"]
  node_odas["ODAS audio pipeline"]
  node_odas_core["ODAS core<br/>[odas_core_node.cpp]"]
  node_ast["AST classifier"]
  node_gre["GRE classifier"]
  node_mobilenet["MobileNet classifier<br/>[classifier_node.py]"]
  node_trt["TensorRT runner<br/>[trt_engine.py]"]
end

subgraph group_fusion["Fusion and tracking"]
  node_ekf["Direction EKF<br/>[ekf_node.cpp]"]
  node_audio_tracker["Audio tracker"]
  node_drone_tracker["Drone tracker"]
  node_bringup["Demo orchestration"]
end

subgraph group_robot["Robot control"]
  node_mock_arm["Mock robot"]
  node_command_server["Robot command server<br/>[command_server.cpp]"]
end

subgraph group_sdk["Robot SDK"]
  node_fairino_sdk["Fairino C++ SDK<br/>[robot.cpp]"]
end

node_operator(("Operator"))
node_camera(("Camera"))
node_microphone(("UMA16 microphone"))
node_real_arm(("Fairino robot"))

node_operator -->|"starts camera launch"| node_yolo_launch
node_camera -->|"provides images"| node_yolo_direction
node_yolo_launch -.->|"launches"| node_yolo_direction
node_yolo_direction -->|"supplies direction"| node_ekf
node_operator -->|"starts host workflow"| node_bringup
node_microphone -->|"provides audio"| node_odas
node_odas -.->|"runs processing"| node_odas_core
node_odas -.->|"provides separated audio"| node_ast
node_odas -.->|"provides separated audio"| node_gre
node_odas -->|"provides separated audio"| node_mobilenet
node_mobilenet -.->|"runs inference"| node_trt
node_ast -.->|"optional direction source"| node_ekf
node_gre -.->|"optional direction source"| node_ekf
node_mobilenet -->|"optional direction source"| node_ekf
node_bringup -->|"launches audio"| node_odas
node_bringup -->|"selects classifier"| node_mobilenet
node_bringup -->|"configures fusion"| node_ekf
node_ekf -->|"provides direction"| node_audio_tracker
node_yolo_direction -.->|"supports direct tracking"| node_drone_tracker
node_audio_tracker -->|"commands motion"| node_mock_arm
node_drone_tracker -.->|"commands motion"| node_mock_arm
node_bringup -->|"selects mock mode"| node_mock_arm
node_command_server -.->|"uses robot API"| node_fairino_sdk
node_fairino_sdk -.->|"controls robot"| node_real_arm

click node_yolo_launch "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/isaac_ros/packages/isaac_ros_yolo_direction/launch/yolo_camera.launch.py"
click node_yolo_direction "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/isaac_ros/packages/isaac_ros_yolo_direction/isaac_ros_yolo_direction/direction_publisher.py"
click node_odas "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/odas_ros/odas_ros/lib_odas_server_node.py"
click node_odas_core "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/odas_ros/src/odas_core_node.cpp"
click node_ast "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_ast/ast/ast_classifier_node.py"
click node_gre "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_gre/gre/gre_classifier_node.py"
click node_mobilenet "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_mobilenetv2/mobilenetv2/classifier_node.py"
click node_trt "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_mobilenetv2/mobilenetv2/trt_engine.py"
click node_ekf "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_ekf/src/ekf_node.cpp"
click node_audio_tracker "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_tracking/src/arm_audio_tracker.cpp"
click node_drone_tracker "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_tracking/src/arm_drone_tracker.cpp"
click node_bringup "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_bringup/launch/arm_audio_demo.launch.py"
click node_mock_arm "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/fairino_hardware/src/fairino_hardware_interface.cpp"
click node_command_server "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/fairino_hardware/src/command_server.cpp"
click node_fairino_sdk "https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/fairino-cpp-sdk/libfairino/src/src/Robot/robot.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_yolo_launch,node_yolo_direction toneBlue
class node_odas,node_odas_core,node_ast,node_gre,node_mobilenet,node_trt toneAmber
class node_ekf,node_audio_tracker,node_drone_tracker,node_bringup toneMint
class node_mock_arm,node_command_server toneRose
class node_fairino_sdk,node_operator,node_camera,node_microphone,node_real_arm toneIndigo
```

## Components

### Visual perception

- [YOLO launch](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/isaac_ros/packages/isaac_ros_yolo_direction/launch/yolo_camera.launch.py): `isaac_ros/packages/isaac_ros_yolo_direction/launch/yolo_camera.launch.py`
- [YOLO direction](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/isaac_ros/packages/isaac_ros_yolo_direction/isaac_ros_yolo_direction/direction_publisher.py): `isaac_ros/packages/isaac_ros_yolo_direction/isaac_ros_yolo_direction/direction_publisher.py`

### Audio perception

- [ODAS audio pipeline](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/odas_ros/odas_ros/lib_odas_server_node.py): `src/odas_ros/odas_ros/lib_odas_server_node.py`
- [ODAS core](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/odas_ros/src/odas_core_node.cpp): `src/odas_ros/src/odas_core_node.cpp`
- [AST classifier](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_ast/ast/ast_classifier_node.py): `src/dracoviloc_ast/ast/ast_classifier_node.py`
- [GRE classifier](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_gre/gre/gre_classifier_node.py): `src/dracoviloc_gre/gre/gre_classifier_node.py`
- [MobileNet classifier](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_mobilenetv2/mobilenetv2/classifier_node.py): `src/dracoviloc_mobilenetv2/mobilenetv2/classifier_node.py`
- [TensorRT runner](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_mobilenetv2/mobilenetv2/trt_engine.py): `src/dracoviloc_mobilenetv2/mobilenetv2/trt_engine.py`

### Fusion and tracking

- [Direction EKF](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_ekf/src/ekf_node.cpp): `src/dracoviloc_ekf/src/ekf_node.cpp`
- [Audio tracker](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_tracking/src/arm_audio_tracker.cpp): `src/dracoviloc_tracking/src/arm_audio_tracker.cpp`
- [Drone tracker](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_tracking/src/arm_drone_tracker.cpp): `src/dracoviloc_tracking/src/arm_drone_tracker.cpp`
- [Demo orchestration](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/dracoviloc_bringup/launch/arm_audio_demo.launch.py): `src/dracoviloc_bringup/launch/arm_audio_demo.launch.py`

### Robot control

- [Mock robot](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/fairino_hardware/src/fairino_hardware_interface.cpp): `src/fairino_hardware/src/fairino_hardware_interface.cpp`
- [Robot command server](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/src/fairino_hardware/src/command_server.cpp): `src/fairino_hardware/src/command_server.cpp`

### Robot SDK

- [Fairino C++ SDK](https://github.com/dhiaelhak-rached/dracoviloc/blob/feature/mobilenetv2-ekf/fairino-cpp-sdk/libfairino/src/src/Robot/robot.cpp): `fairino-cpp-sdk/libfairino/src/src/Robot/robot.cpp`

### Other components

- **Operator**
- **Camera**
- **UMA16 microphone**
- **Fairino robot**

## Connections

- Operator → YOLO launch: starts camera launch
- Camera → YOLO direction: provides images
- YOLO launch → YOLO direction: launches
- YOLO direction → Direction EKF: supplies direction
- Operator → Demo orchestration: starts host workflow
- UMA16 microphone → ODAS audio pipeline: provides audio
- ODAS audio pipeline → ODAS core: runs processing
- ODAS audio pipeline → AST classifier: provides separated audio
- ODAS audio pipeline → GRE classifier: provides separated audio
- ODAS audio pipeline → MobileNet classifier: provides separated audio
- MobileNet classifier → TensorRT runner: runs inference
- AST classifier → Direction EKF: optional direction source
- GRE classifier → Direction EKF: optional direction source
- MobileNet classifier → Direction EKF: optional direction source
- Demo orchestration → ODAS audio pipeline: launches audio
- Demo orchestration → MobileNet classifier: selects classifier
- Demo orchestration → Direction EKF: configures fusion
- Direction EKF → Audio tracker: provides direction
- YOLO direction → Drone tracker: supports direct tracking
- Audio tracker → Mock robot: commands motion
- Drone tracker → Mock robot: commands motion
- Demo orchestration → Mock robot: selects mock mode
- Robot command server → Fairino C++ SDK: uses robot API
- Fairino C++ SDK → Fairino robot: controls robot
