# vipy18/2-dof-arm architecture

> Architecture diagram of the GitHub repository vipy18/2-dof-arm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vipy18/2-dof-arm
- Repository: https://github.com/vipy18/2-dof-arm

## Overview

Robstride is a 2-DOF robotic-arm control and dynamics suite. Its principal live workflow is an operator launching MATLAB Mission Control, which uses the arm controller to command actuators and present monitoring/logging; the repository also provides Python torque-sizing interfaces and standalone motor drivers. The README documents the MATLAB roles and capabilities, while sampled Python code confirms the web API’s calculation call. MATLAB implementation files were not sampled, so those internal connections are documented or left unverified.

Main entry points: [`matlab/ArmControl.m`](https://github.com/vipy18/2-dof-arm/blob/main/matlab/ArmControl.m) (Arm Controller), [`matlab/run_arm_live.m`](https://github.com/vipy18/2-dof-arm/blob/main/matlab/run_arm_live.m) (Live Launcher), [`matlab/ArmMonitor.m`](https://github.com/vipy18/2-dof-arm/blob/main/matlab/ArmMonitor.m) (Mission Control UI), [`python/web/torque_ui.py`](https://github.com/vipy18/2-dof-arm/blob/main/python/web/torque_ui.py) (Torque Calculator UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_matlab["MATLAB Mission Control"]
  node_live_launcher["Live Launcher<br/>[run_arm_live.m]"]
  node_arm_control["Arm Controller<br/>[ArmControl.m]"]
  node_mission_ui["Mission Control UI<br/>[ArmMonitor.m]"]
  node_pid_tuner["PID Tuner<br/>[ArmTuner.m]"]
end

subgraph group_python["Python Tools"]
  node_torque_ui["Torque Calculator UI<br/>[torque_ui.py]"]
  node_web_dashboard["Web Dashboard<br/>[app.py]"]
  node_torque_engine["Torque Engine<br/>[torque_math.py]"]
  node_motor_cli["Motor CLI<br/>[run_motor.py]"]
  node_motor_oscillator["Motor Oscillator"]
end

subgraph group_hardware["Motor Hardware"]
  node_actuators{{"RS02 Actuators"}}
  node_can_adapter{{"USB-CAN Adapter"}}
end

node_operator(("Arm Operator"))

node_operator -->|"launches"| node_live_launcher
node_live_launcher -.->|"starts control"| node_arm_control
node_operator -.->|"operates"| node_mission_ui
node_mission_ui -.->|"uses controller"| node_arm_control
node_operator -.->|"tunes joints"| node_pid_tuner
node_arm_control -.->|"communicates via"| node_can_adapter
node_can_adapter -.->|"carries CAN"| node_actuators
node_operator -.->|"enters parameters"| node_torque_ui
node_operator -.->|"submits inputs"| node_web_dashboard
node_web_dashboard -->|"calculates with"| node_torque_engine
node_torque_ui -.->|"calculates with"| node_torque_engine
node_operator -.->|"runs driver"| node_motor_cli
node_motor_cli -->|"writes serial"| node_can_adapter
node_operator -.->|"runs driver"| node_motor_oscillator
node_motor_oscillator -->|"writes serial"| node_can_adapter

click node_live_launcher "https://github.com/vipy18/2-dof-arm/blob/main/matlab/run_arm_live.m"
click node_arm_control "https://github.com/vipy18/2-dof-arm/blob/main/matlab/ArmControl.m"
click node_mission_ui "https://github.com/vipy18/2-dof-arm/blob/main/matlab/ArmMonitor.m"
click node_pid_tuner "https://github.com/vipy18/2-dof-arm/blob/main/matlab/ArmTuner.m"
click node_torque_ui "https://github.com/vipy18/2-dof-arm/blob/main/python/web/torque_ui.py"
click node_web_dashboard "https://github.com/vipy18/2-dof-arm/blob/main/python/web/app.py"
click node_torque_engine "https://github.com/vipy18/2-dof-arm/blob/main/python/torque_math.py"
click node_motor_cli "https://github.com/vipy18/2-dof-arm/blob/main/python/run_motor.py"
click node_motor_oscillator "https://github.com/vipy18/2-dof-arm/blob/main/python/oscillate_motors.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_live_launcher,node_arm_control,node_mission_ui,node_pid_tuner toneBlue
class node_torque_ui,node_web_dashboard,node_torque_engine,node_motor_cli,node_motor_oscillator toneAmber
class node_actuators,node_can_adapter toneMint
class node_operator toneIndigo
```

## Components

### MATLAB Mission Control

- [Live Launcher](https://github.com/vipy18/2-dof-arm/blob/main/matlab/run_arm_live.m): `matlab/run_arm_live.m`
- [Arm Controller](https://github.com/vipy18/2-dof-arm/blob/main/matlab/ArmControl.m): `matlab/ArmControl.m`
- [Mission Control UI](https://github.com/vipy18/2-dof-arm/blob/main/matlab/ArmMonitor.m): `matlab/ArmMonitor.m`
- [PID Tuner](https://github.com/vipy18/2-dof-arm/blob/main/matlab/ArmTuner.m): `matlab/ArmTuner.m`

### Python Tools

- [Torque Calculator UI](https://github.com/vipy18/2-dof-arm/blob/main/python/web/torque_ui.py): `python/web/torque_ui.py`
- [Web Dashboard](https://github.com/vipy18/2-dof-arm/blob/main/python/web/app.py): `python/web/app.py`
- [Torque Engine](https://github.com/vipy18/2-dof-arm/blob/main/python/torque_math.py): `python/torque_math.py`
- [Motor CLI](https://github.com/vipy18/2-dof-arm/blob/main/python/run_motor.py): `python/run_motor.py`
- [Motor Oscillator](https://github.com/vipy18/2-dof-arm/blob/main/python/oscillate_motors.py): `python/oscillate_motors.py`

### Motor Hardware

- **RS02 Actuators**
- **USB-CAN Adapter**

### Other components

- **Arm Operator**

## Connections

- Arm Operator → Live Launcher: launches (evidence: `README.md`)
- Live Launcher → Arm Controller: starts control
- Arm Operator → Mission Control UI: operates
- Mission Control UI → Arm Controller: uses controller
- Arm Operator → PID Tuner: tunes joints
- Arm Controller → USB-CAN Adapter: communicates via
- USB-CAN Adapter → RS02 Actuators: carries CAN
- Arm Operator → Torque Calculator UI: enters parameters
- Arm Operator → Web Dashboard: submits inputs
- Web Dashboard → Torque Engine: calculates with (evidence: `python/web/app.py`)
- Torque Calculator UI → Torque Engine: calculates with (evidence: `python/web/torque_ui.py`)
- Arm Operator → Motor CLI: runs driver
- Motor CLI → USB-CAN Adapter: writes serial (evidence: `python/run_motor.py`)
- Arm Operator → Motor Oscillator: runs driver
- Motor Oscillator → USB-CAN Adapter: writes serial (evidence: `python/oscillate_motors.py`)
