# aelmaghawry/pick-and-place-abb-1600 architecture

> Architecture diagram of the GitHub repository aelmaghawry/pick-and-place-abb-1600, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aelmaghawry/pick-and-place-abb-1600
- Repository: https://github.com/aelmaghawry/pick-and-place-abb-1600

## Overview

##### Project type and purpose
- This is an academic/research robotics system for “Visual Servoing” applied to aerospace maintenance and inspection of aero-engine blades.
- It combines kinematics computation (MATLAB), coordinate transformations (Jupyter/Python), vision (YOLO, image processing) and robot control (ROS, serial manipulator).

##### File structure
- Top-level:
- README.md (project overview & curriculum)
- RobotKinematics/Code – MATLAB GUI for forward/inverse kinematics
- RobotKinematics/refrences – PDF on planning & control
- TranfomrmationMatrix/Task1.ipynb – Jupyter notebook on transformation matrices
- No explicit “src/backend” or “frontend,” but clear separation between:
- Offline analysis modules (kinematics & transformations)
- Vision/training modules (listed in README tasks)
- ROS integration (to be developed per tasks)
- Build/deployment config is implied via ROS package definitions in the tasks list.

##### README for additional insights
- Describes system components: serial robot, RGB-D camera, laser scanner, gripper
- Specifies software components: Python/C++ for ROS, YOLO for detection, MATLAB GUI for kinematics
- Outlines workflow: image capture → vision module → servoing algorithms → robot actuation

## Diagram (Mermaid)

```mermaid
flowchart TD
    PROJECT["Project Overview (README.md)"]:::documentation

    subgraph "Hardware"
        HC1["Serial Robot Manipulator"]:::hardware
        HC2["Robotic Gripper"]:::hardware
        HC3["RGB-D Camera + Laser Scanner"]:::hardware
        HC4["Control PC"]:::hardware
    end

    subgraph "Software - Offline Analysis"
        MAT["MATLAB GUI (FK/IK)"]:::software
        GUI_fig["GUI Layout File (.fig)"]:::software
        Module_README["MATLAB Kinematics Module README"]:::documentation
        JNB["Jupyter Notebook (Transformations)"]:::software
    end

    subgraph "Software - Runtime (ROS)"
        ROSCore["ROS Core & Middleware"]:::software
        Vision["Vision Processing Node (YOLO8)"]:::software
        Servo["Servo Controller Node"]:::software
        Planner["Trajectory Planner Node"]:::software
    end

    subgraph "Data & Models"
        DS1["Annotated Datasets"]:::data
        DS2["Kinematic Parameters (DH Tables)"]:::data
        DS3["Reference Trajectories & Calibration"]:::data
        DOC["Kinematics Planning & Control Doc"]:::documentation
    end

    subgraph "External Libraries/Services"
        LIB1["OpenCV/PyTorch"]:::external
        LIB2["MATLAB Runtime"]:::external
    end

    PROJECT -->|overview| HC4

    HC3 -->|streams image data| Vision
    Vision -->|publishes DetectedObject topic| ROSCore
    ROSCore -->|subscribes| Servo
    Servo -->|requests trajectory plan| Planner
    Planner -->|sends joint commands| ROSCore
    ROSCore -->|controls| HC1
    HC1 -->|encoder feedback| ROSCore

    HC4 -->|runs| MAT
    HC4 -->|runs| JNB

    MAT -->|uses| DS2
    MAT -->|uses| DS3
    MAT -->|requires| LIB2
    GUI_fig -->|defines layout| MAT
    Module_README -->|documents| MAT

    JNB -->|uses| DS2

    Vision -->|uses| DS1
    Vision -->|uses| LIB1

    Planner -->|uses| DS3

    MAT -->|previews trajectories| Planner

    classDef hardware fill:#d3d3d3,stroke:#333,stroke-width:1px
    classDef software fill:#add8e6,stroke:#333,stroke-width:1px
    classDef data fill:#90ee90,stroke:#333,stroke-width:1px
    classDef external fill:#f0e68c,stroke:#333,stroke-width:1px
    classDef documentation fill:#ffe4e1,stroke:#333,stroke-width:1px

    click MAT "https://github.com/aelmaghawry/pick-and-place-abb-1600/blob/master/RobotKinematics/Code/gui.m"
    click GUI_fig "https://github.com/aelmaghawry/pick-and-place-abb-1600/blob/master/RobotKinematics/Code/gui.fig"
    click Module_README "https://github.com/aelmaghawry/pick-and-place-abb-1600/blob/master/RobotKinematics/Code/README.md"
    click JNB "https://github.com/aelmaghawry/pick-and-place-abb-1600/blob/master/TranfomrmationMatrix/Task1.ipynb"
    click DOC "https://github.com/aelmaghawry/pick-and-place-abb-1600/blob/master/RobotKinematics/refrences/Planning and Control of Energy Efficient.pdf"
    click PROJECT "https://github.com/aelmaghawry/pick-and-place-abb-1600/blob/master/README.md"
```
