# starlequint/project2d_eng654 architecture

> Architecture diagram of the GitHub repository starlequint/project2d_eng654, 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/starlequint/project2d_eng654
- Repository: https://github.com/starlequint/project2d_eng654

## Overview

This repository is a research project on a kinematically redundant planar parallel manipulator, not a packaged application. Its documented work centers on solving forward and inverse kinematics, exploring the robot’s geometry, and animating rotational motion; reports preserve the derivations and results. The README identifies the main artifacts but provides few implementation links, and no source excerpts were available, so the graph shows only documented relationships and leaves the animation script’s specific notebook input unresolved.

Main entry points: [`animate_parallel_robot_rotation_simscape.m`](https://github.com/starlequint/project2d_eng654/blob/main/animate_parallel_robot_rotation_simscape.m) (Simscape Animation), [`forward_kinematic_complete.ipynb`](https://github.com/starlequint/project2d_eng654/blob/main/forward_kinematic_complete.ipynb) (Forward Kinematics), [`Kinematically_Redundant_Planar_Parallel_Manipulator_six_input_rotation.slx`](https://github.com/starlequint/project2d_eng654/blob/main/Kinematically_Redundant_Planar_Parallel_Manipulator_six_input_rotation.slx) (Rotation Model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_kinematics["Kinematics"]
  node_forward["Forward Kinematics"]
  node_inverse["Inverse Kinematics"]
  node_exploration["5-Bar Exploration"]
  node_geometry["Geometry Plotting"]
end

subgraph group_animation["Motion and Animation"]
  node_animation_script["Simscape Animation"]
  node_rotation_model["Rotation Model"]
end

subgraph group_reports["Project Reports"]
  node_jacobian["Jacobian Derivation<br/>[Jacobian.pdf]"]
  node_report["Project Report<br/>[project_2D.pdf]"]
end

node_researcher(("Project Researcher"))

node_animation_script -->|"builds model"| node_rotation_model
node_animation_script -.->|"replays trajectory"| node_forward

click node_forward "https://github.com/starlequint/project2d_eng654/blob/main/forward_kinematic_complete.ipynb"
click node_inverse "https://github.com/starlequint/project2d_eng654/blob/main/reverse_kinematic_complete.ipynb"
click node_exploration "https://github.com/starlequint/project2d_eng654/blob/main/parallel_5L_robot2.mlx"
click node_geometry "https://github.com/starlequint/project2d_eng654/blob/main/project_kinematics.m"
click node_animation_script "https://github.com/starlequint/project2d_eng654/blob/main/animate_parallel_robot_rotation_simscape.m"
click node_rotation_model "https://github.com/starlequint/project2d_eng654/blob/main/Kinematically_Redundant_Planar_Parallel_Manipulator_six_input_rotation.slx"
click node_jacobian "https://github.com/starlequint/project2d_eng654/blob/main/Jacobian.pdf"
click node_report "https://github.com/starlequint/project2d_eng654/blob/main/project_2D.pdf"

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_forward,node_inverse,node_exploration,node_geometry toneBlue
class node_animation_script,node_rotation_model toneAmber
class node_jacobian,node_report toneMint
class node_researcher toneIndigo
```

## Components

### Kinematics

- [Forward Kinematics](https://github.com/starlequint/project2d_eng654/blob/main/forward_kinematic_complete.ipynb): `forward_kinematic_complete.ipynb`
- [Inverse Kinematics](https://github.com/starlequint/project2d_eng654/blob/main/reverse_kinematic_complete.ipynb): `reverse_kinematic_complete.ipynb`
- [5-Bar Exploration](https://github.com/starlequint/project2d_eng654/blob/main/parallel_5L_robot2.mlx): `parallel_5L_robot2.mlx`
- [Geometry Plotting](https://github.com/starlequint/project2d_eng654/blob/main/project_kinematics.m): `project_kinematics.m`

### Motion and Animation

- [Simscape Animation](https://github.com/starlequint/project2d_eng654/blob/main/animate_parallel_robot_rotation_simscape.m): `animate_parallel_robot_rotation_simscape.m`
- [Rotation Model](https://github.com/starlequint/project2d_eng654/blob/main/Kinematically_Redundant_Planar_Parallel_Manipulator_six_input_rotation.slx): `Kinematically_Redundant_Planar_Parallel_Manipulator_six_input_rotation.slx`

### Project Reports

- [Jacobian Derivation](https://github.com/starlequint/project2d_eng654/blob/main/Jacobian.pdf): `Jacobian.pdf`
- [Project Report](https://github.com/starlequint/project2d_eng654/blob/main/project_2D.pdf): `project_2D.pdf`

### Other components

- **Project Researcher**

## Connections

- Simscape Animation → Rotation Model: builds model (evidence: `README.md`)
- Simscape Animation → Forward Kinematics: replays trajectory
