# aziziguidre/kinovacraft architecture

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

- Interactive diagram: https://gitdiagram.com/aziziguidre/kinovacraft
- Repository: https://github.com/aziziguidre/kinovacraft

## Overview

KinovaCraft plans and evaluates Cartesian drawing trajectories for a Kinova Gen3 arm, then animates them and can stream joint states and a path to ROS 2/RViz2. The principal workflow is shape generation, robot-model loading, IK waypoint solving, interpolation benchmarking, and visualization or co-simulation. ROS launch support supplies the robot description and starts the state publisher and RViz2. MATLAB source was not included in the excerpts, so its internal stage connections reflect the README’s documented pipeline rather than inspected call sites.

Main entry points: [`kinova_trajectory_matlab/main.m`](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/main.m) (Pipeline Entry), [`src/trajectory_planner_g6/launch/matlab_rviz.launch.py`](https://github.com/aziziguidre/kinovacraft/blob/main/src/trajectory_planner_g6/launch/matlab_rviz.launch.py) (Co-sim Launch), [`kinova_trajectory_matlab/src/publish_ros2_trajectory.m`](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/publish_ros2_trajectory.m) (ROS Publisher), [`kinova_trajectory_matlab/params.m`](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/params.m) (Configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_matlab["MATLAB Planning"]
  node_main["Pipeline Entry<br/>[main.m]"]
  node_params["Configuration<br/>[params.m]"]
  node_shape["Shape Generator<br/>[generate_shape.m]"]
  node_model["Robot Model<br/>[load_robot_model.m]"]
  node_ik["IK Solver"]
  node_planner["Trajectory Planner"]
end

subgraph group_evaluation["Evaluation &amp; Visualization"]
  node_metrics["Metric Evaluator<br/>[evaluate_metrics.m]"]
  node_shapeplot["Shape Plot<br/>[plot_shape_3d.m]"]
  node_profiles["Joint Profiles"]
  node_comparison["Method Comparison"]
  node_animation["Robot Animation<br/>[animate_robot.m]"]
end

subgraph group_robot["Robot Description"]
  node_description["Gen3 Description<br/>[kinova.urdf.xacro]"]
end

subgraph group_ros["ROS 2 Co-simulation"]
  node_publisher["ROS Publisher"]
  node_launch["Co-sim Launch"]
  node_statepub["State Publisher"]
  node_rviz["RViz2"]
  node_jointstates["Joint States"]
  node_trajectorypath["Trajectory Path"]
end

node_user(("Operator"))

node_user -->|"runs"| node_main
node_main -->|"loads settings"| node_params
node_main -->|"generates waypoints"| node_shape
node_main -->|"loads robot"| node_model
node_main -->|"solves waypoints"| node_ik
node_main -->|"plans motion"| node_planner
node_main -->|"evaluates methods"| node_metrics
node_main -->|"plots shape"| node_shapeplot
node_main -->|"plots profiles"| node_profiles
node_main -->|"plots comparison"| node_comparison
node_main -->|"renders motion"| node_animation
node_main -->|"streams trajectory"| node_publisher
node_user -->|"starts visualizer"| node_launch
node_launch -->|"loads description"| node_description
node_launch -->|"starts"| node_statepub
node_launch -->|"starts"| node_rviz
node_publisher -->|"publishes"| node_jointstates
node_publisher -->|"publishes"| node_trajectorypath
node_jointstates -->|"updates joints"| node_statepub
node_trajectorypath -->|"visualizes path"| node_rviz

click node_main "https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/main.m"
click node_params "https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/params.m"
click node_shape "https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/generate_shape.m"
click node_model "https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/load_robot_model.m"
click node_ik "https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/solve_ik_for_shape.m"
click node_planner "https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/plan_trajectories.m"
click node_metrics "https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/evaluate_metrics.m"
click node_shapeplot "https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/plot_shape_3d.m"
click node_profiles "https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/plot_joint_profiles.m"
click node_comparison "https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/plot_comparison_bar.m"
click node_animation "https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/animate_robot.m"
click node_publisher "https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/publish_ros2_trajectory.m"
click node_launch "https://github.com/aziziguidre/kinovacraft/blob/main/src/trajectory_planner_g6/launch/matlab_rviz.launch.py"
click node_description "https://github.com/aziziguidre/kinovacraft/blob/main/src/ros2_kortex/kortex_description/robots/kinova.urdf.xacro"

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_main,node_params,node_shape,node_model,node_ik,node_planner toneBlue
class node_metrics,node_shapeplot,node_profiles,node_comparison,node_animation toneAmber
class node_description toneMint
class node_publisher,node_launch,node_statepub,node_rviz,node_jointstates,node_trajectorypath toneRose
class node_user toneIndigo
```

## Components

### MATLAB Planning

- [Pipeline Entry](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/main.m): `kinova_trajectory_matlab/main.m`
- [Configuration](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/params.m): `kinova_trajectory_matlab/params.m`
- [Shape Generator](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/generate_shape.m): `kinova_trajectory_matlab/src/generate_shape.m`
- [Robot Model](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/load_robot_model.m): `kinova_trajectory_matlab/src/load_robot_model.m`
- [IK Solver](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/solve_ik_for_shape.m): `kinova_trajectory_matlab/src/solve_ik_for_shape.m`
- [Trajectory Planner](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/plan_trajectories.m): `kinova_trajectory_matlab/src/plan_trajectories.m`

### Evaluation & Visualization

- [Metric Evaluator](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/evaluate_metrics.m): `kinova_trajectory_matlab/src/evaluate_metrics.m`
- [Shape Plot](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/plot_shape_3d.m): `kinova_trajectory_matlab/src/plot_shape_3d.m`
- [Joint Profiles](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/plot_joint_profiles.m): `kinova_trajectory_matlab/src/plot_joint_profiles.m`
- [Method Comparison](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/plot_comparison_bar.m): `kinova_trajectory_matlab/src/plot_comparison_bar.m`
- [Robot Animation](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/animate_robot.m): `kinova_trajectory_matlab/src/animate_robot.m`

### Robot Description

- [Gen3 Description](https://github.com/aziziguidre/kinovacraft/blob/main/src/ros2_kortex/kortex_description/robots/kinova.urdf.xacro): `src/ros2_kortex/kortex_description/robots/kinova.urdf.xacro`

### ROS 2 Co-simulation

- [ROS Publisher](https://github.com/aziziguidre/kinovacraft/blob/main/kinova_trajectory_matlab/src/publish_ros2_trajectory.m): `kinova_trajectory_matlab/src/publish_ros2_trajectory.m`
- [Co-sim Launch](https://github.com/aziziguidre/kinovacraft/blob/main/src/trajectory_planner_g6/launch/matlab_rviz.launch.py): `src/trajectory_planner_g6/launch/matlab_rviz.launch.py`
- **State Publisher**
- **RViz2**
- **Joint States**
- **Trajectory Path**

### Other components

- **Operator**

## Connections

- Operator → Pipeline Entry: runs (evidence: `README.md`)
- Pipeline Entry → Configuration: loads settings (evidence: `README.md`)
- Pipeline Entry → Shape Generator: generates waypoints (evidence: `README.md`)
- Pipeline Entry → Robot Model: loads robot (evidence: `README.md`)
- Pipeline Entry → IK Solver: solves waypoints (evidence: `README.md`)
- Pipeline Entry → Trajectory Planner: plans motion (evidence: `README.md`)
- Pipeline Entry → Metric Evaluator: evaluates methods (evidence: `README.md`)
- Pipeline Entry → Shape Plot: plots shape (evidence: `README.md`)
- Pipeline Entry → Joint Profiles: plots profiles (evidence: `README.md`)
- Pipeline Entry → Method Comparison: plots comparison (evidence: `README.md`)
- Pipeline Entry → Robot Animation: renders motion (evidence: `README.md`)
- Pipeline Entry → ROS Publisher: streams trajectory (evidence: `README.md`)
- Operator → Co-sim Launch: starts visualizer (evidence: `README.md`)
- Co-sim Launch → Gen3 Description: loads description (evidence: `src/trajectory_planner_g6/launch/matlab_rviz.launch.py`)
- Co-sim Launch → State Publisher: starts (evidence: `src/trajectory_planner_g6/launch/matlab_rviz.launch.py`)
- Co-sim Launch → RViz2: starts (evidence: `src/trajectory_planner_g6/launch/matlab_rviz.launch.py`)
- ROS Publisher → Joint States: publishes (evidence: `README.md`)
- ROS Publisher → Trajectory Path: publishes (evidence: `README.md`)
- Joint States → State Publisher: updates joints
- Trajectory Path → RViz2: visualizes path (evidence: `README.md`)
