How aziziguidre/kinovacraft works
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: main.m Pipeline Entry · matlab_rviz.launch.py Co-sim Launch · publish_ros2_trajectory.m ROS Publisher · params.m Configuration
Components 19
MATLAB Planning
- Pipeline Entry
kinova_trajectory_matlab/main.m - Configuration
kinova_trajectory_matlab/params.m - Shape Generator
kinova_trajectory_matlab/src/generate_shape.m - Robot Model
kinova_trajectory_matlab/src/load_robot_model.m - IK Solver
kinova_trajectory_matlab/src/solve_ik_for_shape.m - Trajectory Planner
kinova_trajectory_matlab/src/plan_trajectories.m
Evaluation & Visualization
- Metric Evaluator
kinova_trajectory_matlab/src/evaluate_metrics.m - Shape Plot
kinova_trajectory_matlab/src/plot_shape_3d.m - Joint Profiles
kinova_trajectory_matlab/src/plot_joint_profiles.m - Method Comparison
kinova_trajectory_matlab/src/plot_comparison_bar.m - Robot Animation
kinova_trajectory_matlab/src/animate_robot.m
Robot Description
- Gen3 Description
src/ros2_kortex/kortex_description/robots/kinova.urdf.xacro
ROS 2 Co-simulation
- ROS Publisher
kinova_trajectory_matlab/src/publish_ros2_trajectory.m - Co-sim Launch
src/trajectory_planner_g6/launch/matlab_rviz.launch.py - State Publisher
- RViz2
- Joint States
- Trajectory Path
Other components
- Operator
Connections 20
- Operator → Pipeline Entry: runs
README.md - Pipeline Entry → Configuration: loads settings
README.md - Pipeline Entry → Shape Generator: generates waypoints
README.md - Pipeline Entry → Robot Model: loads robot
README.md - Pipeline Entry → IK Solver: solves waypoints
README.md - Pipeline Entry → Trajectory Planner: plans motion
README.md - Pipeline Entry → Metric Evaluator: evaluates methods
README.md - Pipeline Entry → Shape Plot: plots shape
README.md - Pipeline Entry → Joint Profiles: plots profiles
README.md - Pipeline Entry → Method Comparison: plots comparison
README.md - Pipeline Entry → Robot Animation: renders motion
README.md - Pipeline Entry → ROS Publisher: streams trajectory
README.md - Operator → Co-sim Launch: starts visualizer
README.md - Co-sim Launch → Gen3 Description: loads description
src/trajectory_planner_g6/launch/matlab_rviz.launch.py - Co-sim Launch → State Publisher: starts
src/trajectory_planner_g6/launch/matlab_rviz.launch.py - Co-sim Launch → RViz2: starts
src/trajectory_planner_g6/launch/matlab_rviz.launch.py - ROS Publisher → Joint States: publishes
README.md - ROS Publisher → Trajectory Path: publishes
README.md - Joint States → State Publisher: updates joints
- Trajectory Path → RViz2: visualizes path
README.md