# ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales architecture

> Architecture diagram of the GitHub repository ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales
- Repository: https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales

## Overview

This repository is a wearable-sensor gait-analysis system: ESP32 devices stream inertial measurements, and a Python application calibrates and processes two sensors to drive a subject-scaled OpenSim gait model. A separate utility inspects model muscles and segment geometry. The main script excerpt shows profile handling, sensor threads, Madgwick orientation updates, model scaling, and motion-file writing; the README documents the end-to-end Bluetooth-to-OpenSim workflow. Some intermediate calculations are omitted from the excerpt, so the graph avoids asserting unsupported internal call sequences.

Main entry points: [`python_simulation/opensim_kinematics_streamer.py`](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py) (Analysis runner), [`python_simulation/forceset_extractor.py`](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/forceset_extractor.py) (Model inspector), [`opensim_tools/GaitModel.osim`](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/opensim_tools/GaitModel.osim) (Gait model), [`esp32_firmware/IMU_CalibratedStreamer/IMU_CalibratedStreamer.ino`](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/esp32_firmware/IMU_CalibratedStreamer/IMU_CalibratedStreamer.ino) (ESP32 IMUs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sensing["Sensor acquisition"]
  node_imu["ESP32 IMUs"]
  node_bt{{"Bluetooth link"}}
end

subgraph group_processing["Python analysis"]
  node_main["Analysis runner"]
  node_profile["Subject profile"]
  node_scaling["Model scaling"]
  node_sensor_reader["Sensor threads"]
  node_orientation["Orientation fusion"]
  node_kinematics["Joint kinematics"]
  node_motion_file["Motion output"]
end

subgraph group_biomechanics["OpenSim biomechanics"]
  node_opensim{{"OpenSim runtime"}}
  node_gait_model["Gait model<br/>[GaitModel.osim]"]
  node_geometry["3D geometry"]
end

subgraph group_inspection["Model inspection"]
  node_extractor["Model inspector"]
end

node_user(("Operator"))

node_user -->|"starts analysis"| node_main
node_imu -->|"streams packets"| node_bt
node_bt -->|"sends measurements"| node_sensor_reader
node_main -->|"loads or creates"| node_profile
node_main -->|"generates model"| node_scaling
node_scaling -->|"runs ScaleTool"| node_opensim
node_main -->|"starts threads"| node_sensor_reader
node_sensor_reader -->|"updates filter"| node_orientation
node_main -.->|"computes angles"| node_kinematics
node_main -->|"updates posture"| node_opensim
node_opensim -->|"loads model"| node_gait_model
node_opensim -->|"uses assets"| node_geometry
node_main -->|"writes motion"| node_motion_file
node_user -.->|"runs inspection"| node_extractor
node_extractor -->|"loads and inspects"| node_opensim
node_extractor -.->|"reads model"| node_gait_model

click node_imu "https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/esp32_firmware/IMU_CalibratedStreamer/IMU_CalibratedStreamer.ino"
click node_main "https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py"
click node_profile "https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py"
click node_scaling "https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py"
click node_sensor_reader "https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py"
click node_orientation "https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py"
click node_kinematics "https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py"
click node_motion_file "https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py"
click node_gait_model "https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/opensim_tools/GaitModel.osim"
click node_geometry "https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/tree/main/opensim_tools/geometry"
click node_extractor "https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/forceset_extractor.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_imu,node_bt toneBlue
class node_main,node_profile,node_scaling,node_sensor_reader,node_orientation,node_kinematics,node_motion_file toneAmber
class node_opensim,node_gait_model,node_geometry toneMint
class node_extractor toneRose
class node_user toneIndigo
```

## Components

### Sensor acquisition

- [ESP32 IMUs](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/esp32_firmware/IMU_CalibratedStreamer/IMU_CalibratedStreamer.ino): `esp32_firmware/IMU_CalibratedStreamer/IMU_CalibratedStreamer.ino`
- **Bluetooth link**

### Python analysis

- [Analysis runner](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py): `python_simulation/opensim_kinematics_streamer.py`
- [Subject profile](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py): `python_simulation/opensim_kinematics_streamer.py`
- [Model scaling](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py): `python_simulation/opensim_kinematics_streamer.py`
- [Sensor threads](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py): `python_simulation/opensim_kinematics_streamer.py`
- [Orientation fusion](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py): `python_simulation/opensim_kinematics_streamer.py`
- [Joint kinematics](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py): `python_simulation/opensim_kinematics_streamer.py`
- [Motion output](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/opensim_kinematics_streamer.py): `python_simulation/opensim_kinematics_streamer.py`

### OpenSim biomechanics

- **OpenSim runtime**
- [Gait model](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/opensim_tools/GaitModel.osim): `opensim_tools/GaitModel.osim`
- [3D geometry](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/tree/main/opensim_tools/geometry): `opensim_tools/geometry`

### Model inspection

- [Model inspector](https://github.com/ferminjosue-epo9/analisis-dinamico-de-la-pierna-haciendo-uso-de-sensores-inerciales/blob/main/python_simulation/forceset_extractor.py): `python_simulation/forceset_extractor.py`

### Other components

- **Operator**

## Connections

- Operator → Analysis runner: starts analysis (evidence: `README.md`)
- ESP32 IMUs → Bluetooth link: streams packets (evidence: `README.md`)
- Bluetooth link → Sensor threads: sends measurements (evidence: `README.md`)
- Analysis runner → Subject profile: loads or creates (evidence: `python_simulation/opensim_kinematics_streamer.py`)
- Analysis runner → Model scaling: generates model (evidence: `python_simulation/opensim_kinematics_streamer.py`)
- Model scaling → OpenSim runtime: runs ScaleTool (evidence: `python_simulation/opensim_kinematics_streamer.py`)
- Analysis runner → Sensor threads: starts threads (evidence: `python_simulation/opensim_kinematics_streamer.py`)
- Sensor threads → Orientation fusion: updates filter (evidence: `python_simulation/opensim_kinematics_streamer.py`)
- Analysis runner → Joint kinematics: computes angles (evidence: `python_simulation/opensim_kinematics_streamer.py`)
- Analysis runner → OpenSim runtime: updates posture (evidence: `README.md`)
- OpenSim runtime → Gait model: loads model (evidence: `README.md`)
- OpenSim runtime → 3D geometry: uses assets (evidence: `README.md`)
- Analysis runner → Motion output: writes motion (evidence: `python_simulation/opensim_kinematics_streamer.py`)
- Operator → Model inspector: runs inspection
- Model inspector → OpenSim runtime: loads and inspects (evidence: `python_simulation/forceset_extractor.py`)
- Model inspector → Gait model: reads model
