# juanscelyg/mur architecture

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

- Interactive diagram: https://gitdiagram.com/juanscelyg/mur
- Repository: https://github.com/juanscelyg/mur

## Overview

##### Project type and purpose
- This “MUR” repo is a modular ROS-based robotics system. It includes:
- mur_arm: firmware and launch files for the robot’s manipulator arm (Arduino + ROS)
- mur_control: ROS control nodes, topic definitions, config files and launch scripts for real and simulated operation
- mur_description: URDF/XACRO models, meshes, and upload launches for robot visualization/simulation
- mur_navigation: SLAM and mapping launch files (gmapping, hector_slam)
- mur_server: a WebSocket/rosbridge server and an Angular web GUI to monitor/control the robot remotely

##### File structure
- Top-level packages correspond to logical subsystems: arm firmware, control logic, robot description, navigation, server/GUI
- mur_control is organized into cfg (dynamic_reconfigure), config (YAML/JSON), launch (sim/real/experiment), msg (custom ROS msgs), scripts (Python ROS nodes), src (common PID+utilities)
- mur_server/gui/udrobot is a standard Angular front-end, talking to ROS via rosbridge (launched by websocket.launch)
- Presence of CMakeLists.xml, package.xml, setup.py indicates pure ROS/Catkin Python and C++ packages

##### README for additional insights
- But naming and file layout imply a classic ROS multi-node distributed architecture

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Layers and components
    subgraph "Hardware Layer"
        Sensors["Sensors\n(sonar, camera, IMU, encoders)"]:::hardware
        Actuators["Actuators\n(thrusters, joints)"]:::hardware
        Arduino["Arduino Firmware"]:::hardware
    end

    subgraph "ROS Middleware"
        Master["roscore\n/ros_master"]:::middleware
        Roslaunch["roslaunch"]:::middleware
    end

    subgraph "Control Layer"
        Parsing["Sensor Parsing Nodes"]:::control
        Estimation["State Estimation\n(mur_ekf)"]:::control
        Controllers["Controllers"]:::control
        Supervisor["Supervisor & Missions"]:::control
    end

    subgraph "Navigation Layer"
        GMapping["GMapping"]:::navigation
        Hector["Hector SLAM"]:::navigation
    end

    subgraph "Description / Simulation Layer"
        URDF["URDF/XACRO Models"]:::description
        Meshes["Mesh Assets"]:::description
        Upload["Model Upload"]:::description
    end

    subgraph "Server / GUI Layer"
        Rosbridge["rosbridge WS Server"]:::server
        GUI["Angular Client"]:::server
    end

    %% Relationships
    Sensors -->|"/scan, /imu, etc."| Master
    Arduino -->|"/arm_cmd"| Master
    Roslaunch -.-> Master

    Master --> Parsing
    Parsing --> Estimation
    Estimation --> Controllers
    Controllers -->|"/cmd_vel"| Master
    Supervisor --> Controllers

    Master --> GMapping
    Master --> Hector
    GMapping -->|"/map"| Master
    Hector -->|"/map"| Master

    Roslaunch --> URDF
    Roslaunch --> Upload

    Master --> Rosbridge
    Rosbridge --> GUI

    %% Click Events - Hardware
    click Arduino "https://github.com/juanscelyg/mur/blob/master/mur_arm/arm_firmware/arm_firmware.ino"
    click Arduino "https://github.com/juanscelyg/mur/blob/master/mur_arm/launch/start_mur_arm.launch"
    click Sensors "https://github.com/juanscelyg/mur/blob/master/mur_arm/package.xml"
    click Actuators "https://github.com/juanscelyg/mur/blob/master/mur_arm/package.xml"

    %% Click Events - Control Layer
    click Parsing "https://github.com/juanscelyg/mur/blob/master/mur_control/scripts/mur_imu_parse.py"
    click Parsing "https://github.com/juanscelyg/mur/blob/master/mur_control/scripts/mur_sonar_converter.py"
    click Parsing "https://github.com/juanscelyg/mur/blob/master/mur_control/scripts/mur_barometer_parse.py"
    click Parsing "https://github.com/juanscelyg/mur/blob/master/mur_control/scripts/mur_pose2d_parse.py"
    click Estimation "https://github.com/juanscelyg/mur/blob/master/mur_control/scripts/mur_ekf.py"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/scripts/mur_attitude_control.py"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/scripts/mur_pid_acc.py"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/scripts/mur_control_mixer.py"
    click Supervisor "https://github.com/juanscelyg/mur/blob/master/mur_control/scripts/mur_supervisor.py"
    click Supervisor "https://github.com/juanscelyg/mur/blob/master/mur_control/scripts/mur_test_paths.py"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/cfg/MurControlMixer.cfg"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/cfg/Sonar_Scan.cfg"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/config/configuration.json"
    click Controllers "https://github.com/juanscelyg/mur/tree/master/mur_control/config"
    click Controllers "https://github.com/juanscelyg/mur/tree/master/mur_control/launch/real"
    click Controllers "https://github.com/juanscelyg/mur/tree/master/mur_control/launch/sim"
    click Controllers "https://github.com/juanscelyg/mur/tree/master/mur_control/launch/experiments"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/launch/start_mur_gamepad.launch"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/msg/BoolStamped.msg"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/msg/FloatStamped.msg"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/src/common/mur_PID.py"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/src/common/mur_common.py"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/CMakeLists.txt"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/package.xml"
    click Controllers "https://github.com/juanscelyg/mur/blob/master/mur_control/setup.py"
    click Controllers "https://github.com/juanscelyg/mur/tree/master/mur_control/rviz"

    %% Click Events - Navigation
    click GMapping "https://github.com/juanscelyg/mur/blob/master/mur_navigation/launch/gmapping.launch"
    click Hector "https://github.com/juanscelyg/mur/blob/master/mur_navigation/launch/hector_slam.launch"
    click GMapping "https://github.com/juanscelyg/mur/blob/master/mur_navigation/launch/slam_gmapping_pr2.launch"
    click GMapping "https://github.com/juanscelyg/mur/blob/master/mur_navigation/CMakeLists.txt"
    click GMapping "https://github.com/juanscelyg/mur/blob/master/mur_navigation/package.xml"

    %% Click Events - Description
    click URDF "https://github.com/juanscelyg/mur/tree/master/mur_description/robots"
    click URDF "https://github.com/juanscelyg/mur/tree/master/mur_description/urdf"
    click Meshes "https://github.com/juanscelyg/mur/tree/master/mur_description/meshes"
    click Upload "https://github.com/juanscelyg/mur/blob/master/mur_description/launch/upload_mur*.launch"
    click Upload "https://github.com/juanscelyg/mur/blob/master/mur_description/src/simtools/mur_simtools.py"
    click URDF "https://github.com/juanscelyg/mur/blob/master/mur_description/CMakeLists.txt"
    click URDF "https://github.com/juanscelyg/mur/blob/master/mur_description/package.xml"
    click URDF "https://github.com/juanscelyg/mur/blob/master/mur_description/setup.py"
    click URDF "https://github.com/juanscelyg/mur/blob/master/mur_description/config/config.yaml"

    %% Click Events - Server/GUI
    click Rosbridge "https://github.com/juanscelyg/mur/blob/master/mur_server/launch/websocket.launch"
    click GUI "https://github.com/juanscelyg/mur/tree/master/mur_server/gui/udrobot"
    click GUI "https://github.com/juanscelyg/mur/blob/master/mur_server/CMakeLists.txt"
    click GUI "https://github.com/juanscelyg/mur/blob/master/mur_server/package.xml"

    %% Styles
    classDef hardware fill:#a3d5d3,stroke:#333
    classDef middleware fill:#d3d3d3,stroke:#333
    classDef control fill:#b3e5fc,stroke:#333
    classDef navigation fill:#ffe0b2,stroke:#333
    classDef description fill:#e1bee7,stroke:#333
    classDef server fill:#c8e6c9,stroke:#333
```
