# econsystems/depthvista-helix-isaacsim-camera architecture

> Architecture diagram of the GitHub repository econsystems/depthvista-helix-isaacsim-camera, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/econsystems/depthvista-helix-isaacsim-camera
- Repository: https://github.com/econsystems/depthvista-helix-isaacsim-camera

## Overview

This Isaac Sim package adds e-con DepthVista Helix iToF cameras to a USD stage, then provides a control panel for ROS 2 publishing and two depth-viewing paths. The principal workflow is to add a camera, discover and select units, enable their baked ROS variant, and press Play to stream. The extension also supports a browser point-cloud preview, Replicator ground-truth viewing/projection, and a camera-on-stand rig. Edges follow shown calls or README descriptions; unsampled implementation details are not inferred.

Main entry points: [`exts/econ.itof.ros/econ/itof/ros/extension.py`](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/extension.py) (ROS Extension), [`exts/econ.itof.ros/econ/itof/ros/publisher.py`](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/publisher.py) (Variant Publisher), [`exts/econ.itof.menu/econ/itof/menu/extension.py`](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.menu/econ/itof/menu/extension.py) (Camera Menu), [`exts/econ.itof.menu/assets/DEPTHVISTA_HELIX_GMSL.usd`](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.menu/assets/DEPTHVISTA_HELIX_GMSL.usd) (GMSL Camera USD)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_camera["Camera Assets"]
  node_menu["Camera Menu<br/>[extension.py]"]
  node_gmsl["GMSL Camera USD"]
  node_usb["USB Camera USD"]
end

subgraph group_control["Extension Control"]
  node_control_ext["ROS Extension<br/>[extension.py]"]
  node_panel["Control Window<br/>[window.py]"]
  node_discovery["Unit Discovery<br/>[discovery.py]"]
end

subgraph group_stream["ROS Streaming"]
  node_publisher["Variant Publisher<br/>[publisher.py]"]
  node_ros_graphs["Baked ROS Graphs"]
  node_ros_consumers(("ROS 2 Consumers"))
end

subgraph group_view["Depth Viewers"]
  node_web_service["Depth HTTP Server<br/>[web_viewer.py]"]
  node_browser(("Browser Viewer"))
  node_gt_viewer["Ground Truth Viewer<br/>[viewer_gt.py]"]
end

subgraph group_rig["Scene Setup"]
  node_rig["Camera Stand Rig<br/>[scene_setup.py]"]
end

node_user(("Isaac Sim User"))
node_isaac["Isaac Sim Stage"]

node_user -->|"adds camera"| node_menu
node_menu -->|"references asset"| node_gmsl
node_gmsl -->|"composes into stage"| node_isaac
node_user -->|"opens controls"| node_control_ext
node_control_ext -->|"creates window"| node_panel
node_panel -->|"invokes actions"| node_control_ext
node_control_ext -->|"lists units"| node_discovery
node_publisher -->|"resolves cameras"| node_discovery
node_control_ext -->|"starts publishing"| node_publisher
node_publisher -->|"selects ROS variant"| node_ros_graphs
node_ros_graphs -->|"publishes topics"| node_ros_consumers
node_control_ext -->|"starts preview"| node_web_service
node_web_service -->|"serves depth data"| node_browser
node_control_ext -->|"configures GT view"| node_gt_viewer
node_gt_viewer -->|"projects depth"| node_isaac
node_user -->|"places test rig"| node_rig
node_rig -->|"adds rig"| node_isaac
node_user -.->|"references directly"| node_usb

click node_menu "https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.menu/econ/itof/menu/extension.py"
click node_gmsl "https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.menu/assets/DEPTHVISTA_HELIX_GMSL.usd"
click node_usb "https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.menu/assets/DEPTHVISTA_HELIX_USB.usd"
click node_control_ext "https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/extension.py"
click node_panel "https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/window.py"
click node_discovery "https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/discovery.py"
click node_publisher "https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/publisher.py"
click node_ros_graphs "https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.menu/assets/configurations/DEPTHVISTA_HELIX_ROS.usd"
click node_web_service "https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/web_viewer.py"
click node_gt_viewer "https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/viewer_gt.py"
click node_rig "https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/scene_setup.py"

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_menu,node_gmsl,node_usb,node_user toneBlue
class node_control_ext,node_panel,node_discovery toneAmber
class node_publisher,node_ros_graphs,node_ros_consumers toneMint
class node_web_service,node_browser,node_gt_viewer toneRose
class node_rig,node_isaac toneIndigo
```

## Components

### Camera Assets

- [Camera Menu](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.menu/econ/itof/menu/extension.py): `exts/econ.itof.menu/econ/itof/menu/extension.py`
- [GMSL Camera USD](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.menu/assets/DEPTHVISTA_HELIX_GMSL.usd): `exts/econ.itof.menu/assets/DEPTHVISTA_HELIX_GMSL.usd`
- [USB Camera USD](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.menu/assets/DEPTHVISTA_HELIX_USB.usd): `exts/econ.itof.menu/assets/DEPTHVISTA_HELIX_USB.usd`

### Extension Control

- [ROS Extension](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/extension.py): `exts/econ.itof.ros/econ/itof/ros/extension.py`
- [Control Window](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/window.py): `exts/econ.itof.ros/econ/itof/ros/window.py`
- [Unit Discovery](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/discovery.py): `exts/econ.itof.ros/econ/itof/ros/discovery.py`

### ROS Streaming

- [Variant Publisher](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/publisher.py): `exts/econ.itof.ros/econ/itof/ros/publisher.py`
- [Baked ROS Graphs](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.menu/assets/configurations/DEPTHVISTA_HELIX_ROS.usd): `exts/econ.itof.menu/assets/configurations/DEPTHVISTA_HELIX_ROS.usd`
- **ROS 2 Consumers**

### Depth Viewers

- [Depth HTTP Server](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/web_viewer.py): `exts/econ.itof.ros/econ/itof/ros/web_viewer.py`
- **Browser Viewer**
- [Ground Truth Viewer](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/viewer_gt.py): `exts/econ.itof.ros/econ/itof/ros/viewer_gt.py`

### Scene Setup

- [Camera Stand Rig](https://github.com/econsystems/depthvista-helix-isaacsim-camera/blob/main/exts/econ.itof.ros/econ/itof/ros/scene_setup.py): `exts/econ.itof.ros/econ/itof/ros/scene_setup.py`

### Other components

- **Isaac Sim User**
- **Isaac Sim Stage**

## Connections

- Isaac Sim User → Camera Menu: adds camera (evidence: `README.md`)
- Camera Menu → GMSL Camera USD: references asset (evidence: `exts/econ.itof.menu/econ/itof/menu/extension.py`)
- GMSL Camera USD → Isaac Sim Stage: composes into stage
- Isaac Sim User → ROS Extension: opens controls (evidence: `README.md`)
- ROS Extension → Control Window: creates window (evidence: `exts/econ.itof.ros/econ/itof/ros/extension.py`)
- Control Window → ROS Extension: invokes actions (evidence: `exts/econ.itof.ros/econ/itof/ros/window.py`)
- ROS Extension → Unit Discovery: lists units (evidence: `exts/econ.itof.ros/econ/itof/ros/extension.py`)
- Variant Publisher → Unit Discovery: resolves cameras (evidence: `exts/econ.itof.ros/econ/itof/ros/publisher.py`)
- ROS Extension → Variant Publisher: starts publishing (evidence: `exts/econ.itof.ros/econ/itof/ros/extension.py`)
- Variant Publisher → Baked ROS Graphs: selects ROS variant (evidence: `README.md`)
- Baked ROS Graphs → ROS 2 Consumers: publishes topics (evidence: `README.md`)
- ROS Extension → Depth HTTP Server: starts preview (evidence: `exts/econ.itof.ros/econ/itof/ros/extension.py`)
- Depth HTTP Server → Browser Viewer: serves depth data (evidence: `exts/econ.itof.ros/econ/itof/ros/web_viewer.py`)
- ROS Extension → Ground Truth Viewer: configures GT view (evidence: `exts/econ.itof.ros/econ/itof/ros/extension.py`)
- Ground Truth Viewer → Isaac Sim Stage: projects depth (evidence: `README.md`)
- Isaac Sim User → Camera Stand Rig: places test rig (evidence: `README.md`)
- Camera Stand Rig → Isaac Sim Stage: adds rig (evidence: `exts/econ.itof.ros/econ/itof/ros/scene_setup.py`)
- Isaac Sim User → USB Camera USD: references directly (evidence: `README.md`)
