# ros-industrial/industrial_reconstruction architecture

> Architecture diagram of the GitHub repository ros-industrial/industrial_reconstruction, 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/ros-industrial/industrial_reconstruction
- Repository: https://github.com/ros-industrial/industrial_reconstruction

## Overview

Industrial Reconstruction is a ROS 2 application that turns calibrated RGB-D images and camera poses into a TSDF-derived mesh. Its primary workflow is: receive synchronized camera data, associate poses through TF, integrate frames, then extract, filter, publish, and save the mesh; stopping may also archive captured inputs. A separate archive player republishes saved images, calibration, and poses for replay. The README documents these capabilities, while some implementation details (including filtering and replay wiring) are not shown in the excerpts, so uncertain links are omitted.

Main entry points: [`industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py) (Reconstruction Node), [`industrial_reconstruction/industrial_reconstruction/archive_player.py`](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/archive_player.py) (Archive Player), [`industrial_reconstruction/src/industrial_reconstruction/utility/ros.py`](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/src/industrial_reconstruction/utility/ros.py) (Mesh ROS Conversion), [`industrial_reconstruction_msgs/srv/StartReconstruction.srv`](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction_msgs/srv/StartReconstruction.srv) (Start / Stop Services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and Replay"]
  node_image_sync["Image Synchronizer"]
  node_archive_player["Archive Player<br/>[archive_player.py]"]
  node_archive_data[("Archived RGB-D Data")]
  node_ros_topics["Images, Info, TF"]
end

subgraph group_reconstruction["Reconstruction"]
  node_recon_node["Reconstruction Node"]
  node_pose_lookup["Pose Lookup"]
  node_camera_calibration["Camera Calibration"]
  node_tsdf_integration["TSDF Integration"]
end

subgraph group_outputs["Mesh and Archive"]
  node_mesh_export["Mesh Extraction"]
  node_mesh_filtering["Mesh Filtering"]
  node_archive_writer["Archive Writer"]
  node_mesh_file["PLY Mesh File"]
  node_mesh_visualization["Mesh Visualization"]
end

subgraph group_support["ROS Support"]
  node_mesh_ros["Mesh ROS Conversion<br/>[ros.py]"]
  node_file_utility["Dataset File Utilities<br/>[file.py]"]
  node_ros_services["Start / Stop Services"]
  node_reconstruction_params["Reconstruction Parameters"]
end

node_camera(("RGB-D Camera"))

node_camera -->|"publishes"| node_ros_topics
node_ros_topics -->|"delivers images"| node_image_sync
node_image_sync -->|"looks up pose"| node_pose_lookup
node_camera -->|"provides calibration"| node_camera_calibration
node_ros_topics -->|"provides TF"| node_pose_lookup
node_ros_services -->|"starts / stops"| node_recon_node
node_reconstruction_params -->|"configures"| node_recon_node
node_recon_node -->|"controls integration"| node_tsdf_integration
node_image_sync -->|"supplies frames"| node_tsdf_integration
node_pose_lookup -->|"supplies poses"| node_tsdf_integration
node_camera_calibration -->|"supplies intrinsics"| node_tsdf_integration
node_recon_node -->|"extracts mesh"| node_mesh_export
node_mesh_export -->|"filters mesh"| node_mesh_filtering
node_recon_node -->|"converts mesh"| node_mesh_ros
node_mesh_ros -->|"publishes marker"| node_mesh_visualization
node_mesh_filtering -->|"saves mesh"| node_mesh_file
node_recon_node -->|"archives inputs"| node_archive_writer
node_archive_writer -->|"writes dataset"| node_file_utility
node_archive_writer -->|"stores images and poses"| node_archive_data
node_archive_data -->|"replays dataset"| node_archive_player
node_archive_player -->|"publishes replay"| node_ros_topics

click node_recon_node "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py"
click node_image_sync "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py"
click node_pose_lookup "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py"
click node_camera_calibration "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py"
click node_tsdf_integration "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py"
click node_mesh_export "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py"
click node_mesh_filtering "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py"
click node_mesh_ros "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/src/industrial_reconstruction/utility/ros.py"
click node_archive_writer "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py"
click node_file_utility "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/src/industrial_reconstruction/utility/file.py"
click node_archive_player "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/archive_player.py"
click node_ros_services "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction_msgs/srv/StartReconstruction.srv"
click node_reconstruction_params "https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction_msgs/msg/TSDFVolumeParams.msg"

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_image_sync,node_archive_player,node_archive_data,node_ros_topics toneBlue
class node_recon_node,node_pose_lookup,node_camera_calibration,node_tsdf_integration toneAmber
class node_mesh_export,node_mesh_filtering,node_archive_writer,node_mesh_file,node_mesh_visualization toneMint
class node_mesh_ros,node_file_utility,node_ros_services,node_reconstruction_params toneRose
class node_camera toneIndigo
```

## Components

### Capture and Replay

- [Image Synchronizer](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py): `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`
- [Archive Player](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/archive_player.py): `industrial_reconstruction/industrial_reconstruction/archive_player.py`
- **Archived RGB-D Data**
- **Images, Info, TF**

### Reconstruction

- [Reconstruction Node](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py): `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`
- [Pose Lookup](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py): `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`
- [Camera Calibration](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py): `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`
- [TSDF Integration](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py): `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`

### Mesh and Archive

- [Mesh Extraction](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py): `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`
- [Mesh Filtering](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py): `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`
- [Archive Writer](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py): `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`
- **PLY Mesh File**
- **Mesh Visualization**

### ROS Support

- [Mesh ROS Conversion](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/src/industrial_reconstruction/utility/ros.py): `industrial_reconstruction/src/industrial_reconstruction/utility/ros.py`
- [Dataset File Utilities](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction/src/industrial_reconstruction/utility/file.py): `industrial_reconstruction/src/industrial_reconstruction/utility/file.py`
- [Start / Stop Services](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction_msgs/srv/StartReconstruction.srv): `industrial_reconstruction_msgs/srv/StartReconstruction.srv`
- [Reconstruction Parameters](https://github.com/ros-industrial/industrial_reconstruction/blob/main/industrial_reconstruction_msgs/msg/TSDFVolumeParams.msg): `industrial_reconstruction_msgs/msg/TSDFVolumeParams.msg`

### Other components

- **RGB-D Camera**

## Connections

- RGB-D Camera → Images, Info, TF: publishes (evidence: `README.md`)
- Images, Info, TF → Image Synchronizer: delivers images (evidence: `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`)
- Image Synchronizer → Pose Lookup: looks up pose (evidence: `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`)
- RGB-D Camera → Camera Calibration: provides calibration (evidence: `README.md`)
- Images, Info, TF → Pose Lookup: provides TF (evidence: `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`)
- Start / Stop Services → Reconstruction Node: starts / stops (evidence: `README.md`)
- Reconstruction Parameters → Reconstruction Node: configures (evidence: `README.md`)
- Reconstruction Node → TSDF Integration: controls integration (evidence: `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`)
- Image Synchronizer → TSDF Integration: supplies frames (evidence: `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`)
- Pose Lookup → TSDF Integration: supplies poses (evidence: `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`)
- Camera Calibration → TSDF Integration: supplies intrinsics (evidence: `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`)
- Reconstruction Node → Mesh Extraction: extracts mesh (evidence: `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`)
- Mesh Extraction → Mesh Filtering: filters mesh (evidence: `README.md`)
- Reconstruction Node → Mesh ROS Conversion: converts mesh (evidence: `industrial_reconstruction/src/industrial_reconstruction/utility/ros.py`)
- Mesh ROS Conversion → Mesh Visualization: publishes marker (evidence: `industrial_reconstruction/src/industrial_reconstruction/utility/ros.py`)
- Mesh Filtering → PLY Mesh File: saves mesh (evidence: `README.md`)
- Reconstruction Node → Archive Writer: archives inputs (evidence: `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`)
- Archive Writer → Dataset File Utilities: writes dataset (evidence: `industrial_reconstruction/industrial_reconstruction/industrial_reconstruction.py`)
- Archive Writer → Archived RGB-D Data: stores images and poses (evidence: `README.md`)
- Archived RGB-D Data → Archive Player: replays dataset (evidence: `README.md`)
- Archive Player → Images, Info, TF: publishes replay (evidence: `industrial_reconstruction/industrial_reconstruction/archive_player.py`)
