# fatimazouhour/robotics-matlab-ros-course architecture

> Architecture diagram of the GitHub repository fatimazouhour/robotics-matlab-ros-course, 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/fatimazouhour/robotics-matlab-ros-course
- Repository: https://github.com/fatimazouhour/robotics-matlab-ros-course

## Overview

This repository is a collection of MATLAB, Simulink, and ROS robotics course exercises, not a single runtime application. The principal workflow is for a learner to choose a course area and work through its models, analyses, or labs. The README documents six areas and their capabilities; the graph preserves those branches without implying an execution pipeline. Source excerpts were unavailable, so relationships are limited to the README’s documented course-area mapping.

Main entry points: [`README.md`](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/README.md) (Robotics exercises), [`basic_models/unicycle_model/unicycle_model.m`](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/basic_models/unicycle_model/unicycle_model.m) (Unicycle model), [`basic_models/bicycle_model/bicycle_diffEq.m`](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/basic_models/bicycle_model/bicycle_diffEq.m) (Bicycle model), [`basic_models/diffDrive_model/diffDrive_model.m`](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/basic_models/diffDrive_model/diffDrive_model.m) (Differential drive)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile robot models"]
  node_unicycle["Unicycle model<br/>[unicycle_model.m]"]
  node_bicycle["Bicycle model<br/>[bicycle_diffEq.m]"]
  node_diffdrive["Differential drive<br/>[diffDrive_model.m]"]
end

subgraph group_kinematics["Manipulator kinematics"]
  node_transforms["Transforms and ETS"]
  node_dh["DH parameters<br/>[dh_puma560.m]"]
  node_robot_tree["Robot models<br/>[load_panda.m]"]
  node_ik["Inverse kinematics"]
end

subgraph group_jacobian["Jacobian analysis"]
  node_jacobian["Jacobian methods<br/>[Jacobian_basics.m]"]
  node_singularities["Singularities and ellipsoids"]
end

subgraph group_dynamics["Dynamics and control"]
  node_dynamics["Robot dynamics"]
  node_control["Joint and decentralized control"]
  node_trajectories["Robot trajectories"]
end

subgraph group_planning["Planning and mapping"]
  node_mapping["LiDAR SLAM and maps<br/>[lidar_slam.m]"]
  node_pathplanning["Path planning<br/>[path_planning.m]"]
  node_search["A* and Hybrid A*"]
end

subgraph group_ros["ROS labs"]
  node_ros_topics["Topics and services<br/>[ex1_pub_sub.m]"]
  node_ros_models["ROS models and transforms<br/>[urdf2sim.m]"]
  node_ros_data["Parameters and rosbag<br/>[tut_rosbag.m]"]
  node_turtlebot["TurtleBot3 lab<br/>[tut_turtlebot3.m]"]
end

node_learner(("Learner"))
node_course["Robotics exercises<br/>[README.md]"]

node_learner -->|"studies"| node_course
node_course -->|"covers"| node_unicycle
node_course -->|"covers"| node_bicycle
node_course -->|"covers"| node_diffdrive
node_course -->|"covers"| node_transforms
node_course -->|"covers"| node_dh
node_course -->|"covers"| node_robot_tree
node_course -->|"covers"| node_ik
node_course -->|"covers"| node_jacobian
node_course -->|"covers"| node_singularities
node_course -->|"covers"| node_dynamics
node_course -->|"covers"| node_control
node_course -->|"covers"| node_trajectories
node_course -->|"covers"| node_mapping
node_course -->|"covers"| node_pathplanning
node_course -->|"covers"| node_search
node_course -->|"covers"| node_ros_topics
node_course -->|"covers"| node_ros_models
node_course -->|"covers"| node_ros_data
node_course -->|"covers"| node_turtlebot

click node_course "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/README.md"
click node_unicycle "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/basic_models/unicycle_model/unicycle_model.m"
click node_bicycle "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/basic_models/bicycle_model/bicycle_diffEq.m"
click node_diffdrive "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/basic_models/diffDrive_model/diffDrive_model.m"
click node_transforms "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/definition_and_kinematics/homogenous_transforms/homogenous_transforms.m"
click node_dh "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/definition_and_kinematics/dh_params/dh_puma560.m"
click node_robot_tree "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/definition_and_kinematics/rigidbodytree/load_panda.m"
click node_ik "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/definition_and_kinematics/inverse_kinematics/ik_2link_analytical.m"
click node_jacobian "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/Jacobian/Jacobian_basics.m"
click node_singularities "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/Jacobian/velocity_ellipsoid.m"
click node_dynamics "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/dynamics_and_control/forward_dynamics_ur5.m"
click node_control "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/dynamics_and_control/decentralized_control.m"
click node_trajectories "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/dynamics_and_control/cartesian_trajectory.m"
click node_mapping "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/trajectory_and_pathplanning/lidar_slam.m"
click node_pathplanning "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/trajectory_and_pathplanning/path_planning.m"
click node_search "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/trajectory_and_pathplanning/A_star_path_planning.m"
click node_ros_topics "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/ROS_Exercises/Lab01/ex1_pub_sub.m"
click node_ros_models "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/ROS_Exercises/Lab02/urdf2sim.m"
click node_ros_data "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/ROS_Exercises/Lab02/tut_rosbag.m"
click node_turtlebot "https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/ROS_Exercises/Lab03/tut_turtlebot3.m"

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_unicycle,node_bicycle,node_diffdrive toneBlue
class node_transforms,node_dh,node_robot_tree,node_ik toneAmber
class node_jacobian,node_singularities toneMint
class node_dynamics,node_control,node_trajectories toneRose
class node_mapping,node_pathplanning,node_search,node_learner toneIndigo
class node_ros_topics,node_ros_models,node_ros_data,node_turtlebot,node_course toneTeal
```

## Components

### Mobile robot models

- [Unicycle model](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/basic_models/unicycle_model/unicycle_model.m): `basic_models/unicycle_model/unicycle_model.m`
- [Bicycle model](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/basic_models/bicycle_model/bicycle_diffEq.m): `basic_models/bicycle_model/bicycle_diffEq.m`
- [Differential drive](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/basic_models/diffDrive_model/diffDrive_model.m): `basic_models/diffDrive_model/diffDrive_model.m`

### Manipulator kinematics

- [Transforms and ETS](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/definition_and_kinematics/homogenous_transforms/homogenous_transforms.m): `definition_and_kinematics/homogenous_transforms/homogenous_transforms.m`
- [DH parameters](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/definition_and_kinematics/dh_params/dh_puma560.m): `definition_and_kinematics/dh_params/dh_puma560.m`
- [Robot models](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/definition_and_kinematics/rigidbodytree/load_panda.m): `definition_and_kinematics/rigidbodytree/load_panda.m`
- [Inverse kinematics](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/definition_and_kinematics/inverse_kinematics/ik_2link_analytical.m): `definition_and_kinematics/inverse_kinematics/ik_2link_analytical.m`

### Jacobian analysis

- [Jacobian methods](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/Jacobian/Jacobian_basics.m): `Jacobian/Jacobian_basics.m`
- [Singularities and ellipsoids](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/Jacobian/velocity_ellipsoid.m): `Jacobian/velocity_ellipsoid.m`

### Dynamics and control

- [Robot dynamics](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/dynamics_and_control/forward_dynamics_ur5.m): `dynamics_and_control/forward_dynamics_ur5.m`
- [Joint and decentralized control](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/dynamics_and_control/decentralized_control.m): `dynamics_and_control/decentralized_control.m`
- [Robot trajectories](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/dynamics_and_control/cartesian_trajectory.m): `dynamics_and_control/cartesian_trajectory.m`

### Planning and mapping

- [LiDAR SLAM and maps](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/trajectory_and_pathplanning/lidar_slam.m): `trajectory_and_pathplanning/lidar_slam.m`
- [Path planning](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/trajectory_and_pathplanning/path_planning.m): `trajectory_and_pathplanning/path_planning.m`
- [A* and Hybrid A*](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/trajectory_and_pathplanning/A_star_path_planning.m): `trajectory_and_pathplanning/A_star_path_planning.m`

### ROS labs

- [Topics and services](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/ROS_Exercises/Lab01/ex1_pub_sub.m): `ROS_Exercises/Lab01/ex1_pub_sub.m`
- [ROS models and transforms](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/ROS_Exercises/Lab02/urdf2sim.m): `ROS_Exercises/Lab02/urdf2sim.m`
- [Parameters and rosbag](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/ROS_Exercises/Lab02/tut_rosbag.m): `ROS_Exercises/Lab02/tut_rosbag.m`
- [TurtleBot3 lab](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/ROS_Exercises/Lab03/tut_turtlebot3.m): `ROS_Exercises/Lab03/tut_turtlebot3.m`

### Other components

- **Learner**
- [Robotics exercises](https://github.com/fatimazouhour/robotics-matlab-ros-course/blob/main/README.md): `README.md`

## Connections

- Learner → Robotics exercises: studies (evidence: `README.md`)
- Robotics exercises → Unicycle model: covers (evidence: `README.md`)
- Robotics exercises → Bicycle model: covers (evidence: `README.md`)
- Robotics exercises → Differential drive: covers (evidence: `README.md`)
- Robotics exercises → Transforms and ETS: covers (evidence: `README.md`)
- Robotics exercises → DH parameters: covers (evidence: `README.md`)
- Robotics exercises → Robot models: covers (evidence: `README.md`)
- Robotics exercises → Inverse kinematics: covers (evidence: `README.md`)
- Robotics exercises → Jacobian methods: covers (evidence: `README.md`)
- Robotics exercises → Singularities and ellipsoids: covers (evidence: `README.md`)
- Robotics exercises → Robot dynamics: covers (evidence: `README.md`)
- Robotics exercises → Joint and decentralized control: covers (evidence: `README.md`)
- Robotics exercises → Robot trajectories: covers (evidence: `README.md`)
- Robotics exercises → LiDAR SLAM and maps: covers (evidence: `README.md`)
- Robotics exercises → Path planning: covers (evidence: `README.md`)
- Robotics exercises → A* and Hybrid A*: covers (evidence: `README.md`)
- Robotics exercises → Topics and services: covers (evidence: `README.md`)
- Robotics exercises → ROS models and transforms: covers (evidence: `README.md`)
- Robotics exercises → Parameters and rosbag: covers (evidence: `README.md`)
- Robotics exercises → TurtleBot3 lab: covers (evidence: `README.md`)
