# ivan-smit/exoskeleton-biomechanics-analysis architecture

> Architecture diagram of the GitHub repository ivan-smit/exoskeleton-biomechanics-analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ivan-smit/exoskeleton-biomechanics-analysis
- Repository: https://github.com/ivan-smit/exoskeleton-biomechanics-analysis

## Overview

This is a MuJoCo-based biomechanics simulator that uses optical motion-capture data to study interaction between a person and a lower-limb exoskeleton. The documented workflow is to provide a data folder and attachment strength, simulate the combined system, then inspect motion and biomechanical results. The implementation is concentrated in `src/main.py`; the README describes capabilities beyond the sampled excerpts, so those links are cited to the README rather than inferred from unseen code.

Main entry points: [`src/main.py`](https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py) (Simulation entry), [`data`](https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/tree/main/data) (Motion capture data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs_model["Inputs and model"]
  node_mocap_data[("Motion capture data")]
  node_entry["Simulation entry<br/>[main.py]"]
  node_mocap_import["Mocap import<br/>[main.py]"]
  node_human_exo["Human-exoskeleton model<br/>[main.py]"]
end

subgraph group_simulation["Simulation"]
  node_mujoco["MuJoCo engine"]
  node_motion_view["Motion visualization<br/>[main.py]"]
end

subgraph group_analysis["Biomechanical analysis"]
  node_deviation_monitor["Deviation monitor<br/>[main.py]"]
  node_kinematics["Kinematic metrics<br/>[main.py]"]
  node_dynamics_energy["Dynamics and energy<br/>[main.py]"]
  node_optimization["Attachment optimization<br/>[main.py]"]
  node_plots["Analysis plots<br/>[main.py]"]
end

node_user(("Analyst"))

node_user -->|"starts with inputs"| node_entry
node_mocap_data -->|"supplies marker data"| node_mocap_import
node_entry -->|"imports data"| node_mocap_import
node_entry -->|"configures attachment"| node_human_exo
node_entry -->|"runs simulation"| node_mujoco
node_human_exo -->|"forms combined system"| node_mujoco
node_mujoco -->|"visualizes motion"| node_motion_view
node_mujoco -->|"updates deviations"| node_deviation_monitor
node_mujoco -->|"provides marker positions"| node_kinematics
node_mujoco -.->|"produces measures"| node_dynamics_energy
node_entry -->|"varies attachment strength"| node_optimization
node_deviation_monitor -->|"saves deviation plots"| node_plots
node_kinematics -->|"plots angles and RMS"| node_plots
node_dynamics_energy -.->|"reports metrics"| node_plots

click node_mocap_data "https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/tree/main/data"
click node_entry "https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py"
click node_mocap_import "https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py"
click node_human_exo "https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py"
click node_motion_view "https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py"
click node_deviation_monitor "https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py"
click node_kinematics "https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py"
click node_dynamics_energy "https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py"
click node_optimization "https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py"
click node_plots "https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.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_mocap_data,node_entry,node_mocap_import,node_human_exo toneBlue
class node_mujoco,node_motion_view toneAmber
class node_deviation_monitor,node_kinematics,node_dynamics_energy,node_optimization,node_plots toneMint
class node_user toneIndigo
```

## Components

### Inputs and model

- [Motion capture data](https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/tree/main/data): `data`
- [Simulation entry](https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py): `src/main.py`
- [Mocap import](https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py): `src/main.py`
- [Human-exoskeleton model](https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py): `src/main.py`

### Simulation

- **MuJoCo engine**
- [Motion visualization](https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py): `src/main.py`

### Biomechanical analysis

- [Deviation monitor](https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py): `src/main.py`
- [Kinematic metrics](https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py): `src/main.py`
- [Dynamics and energy](https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py): `src/main.py`
- [Attachment optimization](https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py): `src/main.py`
- [Analysis plots](https://github.com/ivan-smit/exoskeleton-biomechanics-analysis/blob/main/src/main.py): `src/main.py`

### Other components

- **Analyst**

## Connections

- Analyst → Simulation entry: starts with inputs (evidence: `README.md`)
- Motion capture data → Mocap import: supplies marker data (evidence: `README.md`)
- Simulation entry → Mocap import: imports data (evidence: `README.md`)
- Simulation entry → Human-exoskeleton model: configures attachment (evidence: `README.md`)
- Simulation entry → MuJoCo engine: runs simulation (evidence: `README.md`)
- Human-exoskeleton model → MuJoCo engine: forms combined system (evidence: `README.md`)
- MuJoCo engine → Motion visualization: visualizes motion (evidence: `README.md`)
- MuJoCo engine → Deviation monitor: updates deviations (evidence: `src/main.py`)
- MuJoCo engine → Kinematic metrics: provides marker positions (evidence: `src/main.py`)
- MuJoCo engine → Dynamics and energy: produces measures
- Simulation entry → Attachment optimization: varies attachment strength (evidence: `README.md`)
- Deviation monitor → Analysis plots: saves deviation plots (evidence: `src/main.py`)
- Kinematic metrics → Analysis plots: plots angles and RMS (evidence: `src/main.py`)
- Dynamics and energy → Analysis plots: reports metrics (evidence: `src/main.py`)
