# adelajim/tfm_adelajimenez architecture

> Architecture diagram of the GitHub repository adelajim/tfm_adelajimenez, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adelajim/tfm_adelajimenez
- Repository: https://github.com/adelajim/tfm_adelajimenez

## Overview

Para elaborar un diagrama de arquitectura preciso y ajustado a este proyecto, sigue estos pasos:

##### Identificación del proyecto y propósito
- Tipo: Sistema de control e integración robótica compuesto por dos grandes subsistemas:
a) Control a bajo nivel (unidades Arduino para extrusor y termorregulador).
b) Plataforma ROS2 con drivers UR, planificación de trayectorias, logging y herramientas de procesamiento de datos.
- Objetivo: Orquestar el robot UR10 (hardware), añadir elementos de disipación de calor/extrusión, generar trayectorias, simular/planificar con MoveIt2 y registrar/análisis de datos.

##### Análisis de la estructura de carpetas
- Top-level:
- control_unit/: código Arduino (.ino, .h) para controladores de extrusor y termorregulador.
- workspace/ros_ur_driver/: ROS2 workspace con múltiples paquetes:
– Universal_Robots_ROS2_Description (URDF, meshes, configs)
– Universal_Robots_ROS2_Driver (nodos de comunicación con el robot)
– ur_bringup, ur_robot_driver, ur_controllers, ur_calibration, ur_dashboard_msgs, ur_moveit_config.
- Otras herramientas en src/:
- build_platform/: scripts Python para comunicación serie con Arduino.
- conversion_datos/: de G-Code y poses a formatos articulados.
- data_logger/: módulos Python para subscribirse a topics y guardar datos.
- routine_launcher/: orquestador de ejecuciones periódicas.
- trayectories/: generación y parseo de trayectorias/G-Code.

##### Información clave del README
- Se usa ROS2 Humble + MoveIt2.
- El workspace está diseñado para añadir más sistemas robóticos.
- El directorio control_unit gestiona periféricos externos (extrusor, termorregulador) ligados al robot.

##### Componentes principales y sus relaciones
a) Hardware físico:
– UR10 Robot (joints, drivers nativos).
– Placa Arduino (Fire Beetle 2) con:
- Módulo Extrusor
- Termorregulador
b) Capa de comunicación serie:
– build_platform/arduino_communicator.py: puente Python ↔ Arduino.
c) Middleware ROS2 (DDS) con:
– ur_robot_driver: nodo ROS2 de control del robot vía RTDE/urscript.
– ur_controllers: plugins de controlador (joint trajectory, GPIO, speed scaling).
– ur_dashboard_msgs: mensajes/servicios para el dashboard UR.
– ur_bringup: launch files para inicializar robot, simulación y nodos auxiliares.
– ur_calibration: nodos ROS2 para calibración de zero-offsets.
– Universal_Robots_ROS2_Description: URDF/Xacro, meshes y launch de visualización en RViz.
– ur_moveit_config: configuración MoveIt2 (kinematics, controllers, planning).
d) Herramientas de post-proceso y orquestación:
– data_logger: suscripción a topics (/joint_states, /sensor_data, etc.) y almacenamiento CSV.
– conversion_datos: scripts para convertir datos a formatos de entrada de otros módulos.
– trayectories: generación de trayectorias en joint-space y Cartesian-space, exportación G-Code.
– routine_launcher: scheduler Python para ejecutar flujos automáticos (logging, conversiones, lanzamientos).

##### Patrón arquitectónico y flujo de datos
- Publicador-Suscriptor ROS2 central: Topics para sensores, estados y comandos.
- Servicios/Acciones ROS2 para control puntual (SetMode, LoadProgram, MoveJ, MoveL).
- Serial bridging: Arduino → Python → ROS2 topic “/extruder_status” y → ROS2 topic “/extruder_command”.
- MoveIt2 consume “/joint_states” y publica “/joint_trajectory” para planificar y visualizar.

##### Guía de dibujo del diagrama
a) Crea tres capas horizontales:
1. Hardware (UR10, Arduino Extrusor/Termorregulador).
2. Middleware (ROS2 DDS, topics, servicios).
3. Herramientas de aplicación (MoveIt2, RViz, data_logger, conversion_datos, trayectories).
b) Dentro de cada capa, dibuja cajas para cada componente: paquete ROS2, script Python, firmware Arduino.
c) Con flechas direccionales:
– Sensores → Arduino → Python Bridge → ROS2 Topics
– ROS2 Topics → ur_robot_driver → UR10
– ROS2 Topics → ur_controllers → hardware interfaces
– ur_moveit_config → MoveIt2 Planning → ROS2 Topics
– data_logger / conversion_datos / trayectories consumen topics → generan ficheros/resultados
d) Usa colores o formas distintas para:
e) Etiqueta cada conexión con el nombre del topic o servicio (por ejemplo, “/joint_states”, “/extruder_cmd_srv”).

##### Recomendaciones finales
- Sé detallado: incluye puertos serie, brokers DDS, tipos de mensajes principales.
- Muestra configuraciones clave (archivos .yaml) cerca de los nodos correspondientes.
- Añade en un lateral la pila de software: Ubuntu 22.04 → ROS2 Humble → MoveIt2.
- Verifica que todos los componentes del file tree queden mapeados en el diagrama.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Hardware Layer
    subgraph "1. Hardware Layer"
        UR10["UR10 Robot"]:::hardware
        ArduinoExtruder["Extruder Firmware"]:::arduino
        ArduinoThermo["Thermoregulator Firmware"]:::arduino
    end

    %% Middleware Layer
    subgraph "2. Middleware Layer"
        DDS["ROS2 DDS Middleware"]:::ros2
        ur_driver["ur_robot_driver"]:::ros2
        ur_controllers["ur_controllers"]:::ros2
        ur_dashboard["ur_dashboard_msgs"]:::ros2
        ur_bringup["ur_bringup"]:::ros2
        ur_calibration["ur_calibration"]:::ros2
        description_urdf["URDF"]:::model
        description_mesh["Meshes"]:::model
        ur_moveit_config["ur_moveit_config"]:::ros2
        arduino_comm["arduino_communicator.py"]:::tool
    end

    %% Application Tools
    subgraph "3. Application Tools"
        MoveIt["MoveIt2 Planning"]:::tool
        RViz["RViz Visualizer"]:::tool
        data_logger["data_logger"]:::tool
        conversion["conversion_datos"]:::tool
        trajectories["trayectories"]:::tool
        routine["rutine_launcher"]:::tool
    end

    %% Software Stack
    subgraph "Software Stack"
        Ubuntu["Ubuntu 22.04"]:::stack
        ROS2Humble["ROS2 Humble"]:::stack
        MoveItVersion["MoveIt2"]:::stack
    end

    %% Connections
    UR10 -->|"joints/drivers"| ur_driver
    ArduinoExtruder -->|serial| arduino_comm
    ArduinoThermo -->|serial| arduino_comm
    arduino_comm -->|publish /extruder_status| DDS
    DDS -->|subscribe /extruder_command| arduino_comm

    DDS -->|topics & services| ur_driver
    DDS -->|topics| ur_controllers
    DDS -->|services/actions| ur_dashboard
    DDS -->|launch| ur_bringup
    DDS -->|topics| ur_calibration

    description_urdf -->|model| RViz
    description_mesh -->|mesh| RViz

    ur_moveit_config -->|config| MoveIt
    DDS -->|/joint_states| MoveIt
    MoveIt -->|/joint_trajectory| DDS

    data_logger -->|subscribe topics| DDS
    conversion -->|consume data| DDS
    trajectories -->|consume topics| DDS
    routine -->|orchestrate flows| data_logger
    routine -->|orchestrate flows| conversion
    routine -->|orchestrate flows| trajectories
    routine -->|launch| ur_bringup

    Ubuntu --> ROS2Humble --> MoveItVersion

    %% Click Events
    click ArduinoExtruder "https://github.com/adelajim/tfm_adelajimenez/tree/main/control_unit/controlador_extrusor"
    click ArduinoThermo "https://github.com/adelajim/tfm_adelajimenez/tree/main/control_unit/main_thermoregulator_s_program"
    click arduino_comm "https://github.com/adelajim/tfm_adelajimenez/blob/main/workspace/ros_ur_driver/src/build_platform/build_platform/arduino_communicator.py"
    click data_logger "https://github.com/adelajim/tfm_adelajimenez/tree/main/workspace/ros_ur_driver/src/data_logger/data_logger"
    click conversion "https://github.com/adelajim/tfm_adelajimenez/tree/main/workspace/ros_ur_driver/src/conversion_datos/conversion_datos"
    click trajectories "https://github.com/adelajim/tfm_adelajimenez/tree/main/workspace/ros_ur_driver/src/trayectories/trayectories"
    click routine "https://github.com/adelajim/tfm_adelajimenez/tree/main/workspace/ros_ur_driver/src/rutine_launcher/rutine_launcher"
    click description_urdf "https://github.com/adelajim/tfm_adelajimenez/tree/main/workspace/ros_ur_driver/src/Universal_Robots_ROS2_Description/urdf"
    click description_mesh "https://github.com/adelajim/tfm_adelajimenez/tree/main/workspace/ros_ur_driver/src/Universal_Robots_ROS2_Description/meshes"
    click ur_driver "https://github.com/adelajim/tfm_adelajimenez/tree/main/workspace/ros_ur_driver/src/Universal_Robots_ROS2_Driver/ur_robot_driver"
    click ur_bringup "https://github.com/adelajim/tfm_adelajimenez/tree/main/workspace/ros_ur_driver/src/Universal_Robots_ROS2_Driver/ur_bringup"
    click ur_controllers "https://github.com/adelajim/tfm_adelajimenez/tree/main/workspace/ros_ur_driver/src/Universal_Robots_ROS2_Driver/ur_controllers"
    click ur_calibration "https://github.com/adelajim/tfm_adelajimenez/tree/main/workspace/ros_ur_driver/src/Universal_Robots_ROS2_Driver/ur_calibration"
    click ur_dashboard "https://github.com/adelajim/tfm_adelajimenez/tree/main/workspace/ros_ur_driver/src/Universal_Robots_ROS2_Driver/ur_dashboard_msgs"
    click ur_moveit_config "https://github.com/adelajim/tfm_adelajimenez/tree/main/workspace/ros_ur_driver/src/Universal_Robots_ROS2_Driver/ur_moveit_config"

    %% Styles
    classDef hardware fill:#cccccc,stroke:#333,stroke-width:1px
    classDef arduino fill:#999999,stroke:#333,stroke-width:1px
    classDef ros2 fill:#82b1ff,stroke:#333,stroke-width:1px
    classDef tool fill:#b9f6ca,stroke:#333,stroke-width:1px
    classDef model fill:#ffab40,stroke:#333,stroke-width:1px
    classDef stack fill:#e0e0e0,stroke:#333,stroke-width:1px
```
