# xiotechnologies/fusion architecture

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

- Interactive diagram: https://gitdiagram.com/xiotechnologies/fusion
- Repository: https://github.com/xiotechnologies/fusion

## Overview

Fusion is an embedded-oriented IMU sensor-fusion library, with a Python package exposing its C algorithms. The principal workflow accepts gyroscope, accelerometer, and optionally magnetometer or external-heading measurements; the AHRS updates orientation and exposes quaternion, gravity, and acceleration outputs. The repository also provides bias estimation, compass heading, coordinate conventions, sensor-axis remapping, and magnetic model utilities. Python bindings convert NumPy inputs and expose these capabilities. Relationships among unsampled C subsystems are omitted unless documented; the graph reflects only shown calls, indexed references, and README descriptions.

Main entry points: [`Python/imufusion/imufusion.c`](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/imufusion.c) (imufusion API), [`Python/imufusion/Ahrs.h`](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Ahrs.h) (AHRS Binding), [`Python/imufusion/NpArray.h`](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/NpArray.h) (NumPy Conversion), [`Fusion/FusionMath.h`](https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionMath.h) (Vector Quaternion Math)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["C Fusion Core"]
  node_ahrs["AHRS Algorithm<br/>[FusionAhrs.c]"]
  node_bias["Gyroscope Bias<br/>[FusionBias.c]"]
end

subgraph group_py["Python Package"]
  node_python["imufusion API<br/>[imufusion.c]"]
  node_ahrs_binding["AHRS Binding<br/>[Ahrs.h]"]
  node_array["NumPy Conversion<br/>[NpArray.h]"]
  node_settings["AHRS Settings<br/>[AhrsSettings.h]"]
  node_states["AHRS State Views"]
  node_flags["AHRS Flags<br/>[AhrsFlags.h]"]
  node_bias_binding["Bias Binding<br/>[Bias.h]"]
  node_bias_settings["Bias Settings<br/>[BiasSettings.h]"]
  node_compass_binding["Compass Binding<br/>[Compass.h]"]
  node_convention_binding["Convention Binding<br/>[Convention.h]"]
  node_convert_binding["Conversion Binding<br/>[Convert.h]"]
  node_model_binding["Magnetic Model Binding<br/>[Model.h]"]
  node_remap_binding["Remap Binding<br/>[Remap.h]"]
end

subgraph group_support["Sensor Utilities"]
  node_compass["Compass Heading<br/>[FusionCompass.c]"]
  node_convention["Axes Convention<br/>[FusionConvention.c]"]
  node_remap["Sensor Axis Remap<br/>[FusionRemap.c]"]
  node_model["Magnetic Model<br/>[FusionModel.h]"]
  node_math["Vector Quaternion Math<br/>[FusionMath.h]"]
end

node_sensors(("IMU Measurements"))
node_outputs["Orientation and Motion Outputs"]

node_python -->|"registers"| node_ahrs_binding
node_python -->|"registers"| node_bias_binding
node_python -->|"registers"| node_compass_binding
node_python -->|"registers"| node_convention_binding
node_python -->|"registers"| node_convert_binding
node_python -->|"registers"| node_model_binding
node_python -->|"registers"| node_remap_binding
node_python -->|"registers"| node_settings
node_python -->|"registers"| node_states
node_python -->|"registers"| node_flags
node_python -->|"registers"| node_bias_settings
node_sensors -.->|"provides samples"| node_ahrs_binding
node_ahrs_binding -->|"converts arrays"| node_array
node_ahrs_binding -->|"updates and queries"| node_ahrs
node_settings -.->|"configures"| node_ahrs_binding
node_ahrs_binding -->|"returns states"| node_states
node_ahrs_binding -->|"returns flags"| node_flags
node_ahrs -->|"produces"| node_outputs
node_bias_binding -->|"wraps"| node_bias
node_bias_binding -->|"converts arrays"| node_array
node_compass_binding -->|"wraps"| node_compass
node_compass_binding -->|"converts arrays"| node_array
node_convention_binding -->|"wraps"| node_convention
node_convert_binding -->|"uses conversions"| node_math
node_model_binding -->|"wraps"| node_model
node_model_binding -->|"converts arrays"| node_array
node_remap_binding -->|"wraps"| node_remap
node_remap_binding -->|"converts arrays"| node_array
node_ahrs -->|"uses math"| node_math
node_ahrs -->|"uses convention"| node_convention
node_bias -->|"uses math"| node_math
node_compass -->|"uses math"| node_math
node_compass -->|"uses convention"| node_convention
node_remap -->|"uses math"| node_math

click node_python "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/imufusion.c"
click node_ahrs_binding "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Ahrs.h"
click node_array "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/NpArray.h"
click node_settings "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/AhrsSettings.h"
click node_states "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/AhrsInternalStates.h"
click node_flags "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/AhrsFlags.h"
click node_bias_binding "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Bias.h"
click node_bias_settings "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/BiasSettings.h"
click node_compass_binding "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Compass.h"
click node_convention_binding "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Convention.h"
click node_convert_binding "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Convert.h"
click node_model_binding "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Model.h"
click node_remap_binding "https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Remap.h"
click node_ahrs "https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionAhrs.c"
click node_bias "https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionBias.c"
click node_compass "https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionCompass.c"
click node_convention "https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionConvention.c"
click node_remap "https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionRemap.c"
click node_model "https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionModel.h"
click node_math "https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionMath.h"

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_ahrs,node_bias toneBlue
class node_python,node_ahrs_binding,node_array,node_settings,node_states,node_flags,node_bias_binding,node_bias_settings,node_compass_binding,node_convention_binding,node_convert_binding,node_model_binding,node_remap_binding toneAmber
class node_compass,node_convention,node_remap,node_model,node_math toneMint
class node_sensors,node_outputs toneIndigo
```

## Components

### C Fusion Core

- [AHRS Algorithm](https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionAhrs.c): `Fusion/FusionAhrs.c`
- [Gyroscope Bias](https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionBias.c): `Fusion/FusionBias.c`

### Python Package

- [imufusion API](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/imufusion.c): `Python/imufusion/imufusion.c`
- [AHRS Binding](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Ahrs.h): `Python/imufusion/Ahrs.h`
- [NumPy Conversion](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/NpArray.h): `Python/imufusion/NpArray.h`
- [AHRS Settings](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/AhrsSettings.h): `Python/imufusion/AhrsSettings.h`
- [AHRS State Views](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/AhrsInternalStates.h): `Python/imufusion/AhrsInternalStates.h`
- [AHRS Flags](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/AhrsFlags.h): `Python/imufusion/AhrsFlags.h`
- [Bias Binding](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Bias.h): `Python/imufusion/Bias.h`
- [Bias Settings](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/BiasSettings.h): `Python/imufusion/BiasSettings.h`
- [Compass Binding](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Compass.h): `Python/imufusion/Compass.h`
- [Convention Binding](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Convention.h): `Python/imufusion/Convention.h`
- [Conversion Binding](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Convert.h): `Python/imufusion/Convert.h`
- [Magnetic Model Binding](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Model.h): `Python/imufusion/Model.h`
- [Remap Binding](https://github.com/xiotechnologies/fusion/blob/main/Python/imufusion/Remap.h): `Python/imufusion/Remap.h`

### Sensor Utilities

- [Compass Heading](https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionCompass.c): `Fusion/FusionCompass.c`
- [Axes Convention](https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionConvention.c): `Fusion/FusionConvention.c`
- [Sensor Axis Remap](https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionRemap.c): `Fusion/FusionRemap.c`
- [Magnetic Model](https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionModel.h): `Fusion/FusionModel.h`
- [Vector Quaternion Math](https://github.com/xiotechnologies/fusion/blob/main/Fusion/FusionMath.h): `Fusion/FusionMath.h`

### Other components

- **IMU Measurements**
- **Orientation and Motion Outputs**

## Connections

- imufusion API → AHRS Binding: registers (evidence: `Python/imufusion/imufusion.c`)
- imufusion API → Bias Binding: registers (evidence: `Python/imufusion/imufusion.c`)
- imufusion API → Compass Binding: registers (evidence: `Python/imufusion/imufusion.c`)
- imufusion API → Convention Binding: registers (evidence: `Python/imufusion/imufusion.c`)
- imufusion API → Conversion Binding: registers (evidence: `Python/imufusion/imufusion.c`)
- imufusion API → Magnetic Model Binding: registers (evidence: `Python/imufusion/imufusion.c`)
- imufusion API → Remap Binding: registers (evidence: `Python/imufusion/imufusion.c`)
- imufusion API → AHRS Settings: registers (evidence: `Python/imufusion/imufusion.c`)
- imufusion API → AHRS State Views: registers (evidence: `Python/imufusion/imufusion.c`)
- imufusion API → AHRS Flags: registers (evidence: `Python/imufusion/imufusion.c`)
- imufusion API → Bias Settings: registers (evidence: `Python/imufusion/imufusion.c`)
- IMU Measurements → AHRS Binding: provides samples (evidence: `README.md`)
- AHRS Binding → NumPy Conversion: converts arrays (evidence: `Python/imufusion/Ahrs.h`)
- AHRS Binding → AHRS Algorithm: updates and queries (evidence: `Python/imufusion/Ahrs.h`)
- AHRS Settings → AHRS Binding: configures (evidence: `Python/imufusion/Ahrs.h`)
- AHRS Binding → AHRS State Views: returns states (evidence: `Python/imufusion/Ahrs.h`)
- AHRS Binding → AHRS Flags: returns flags (evidence: `Python/imufusion/Ahrs.h`)
- AHRS Algorithm → Orientation and Motion Outputs: produces (evidence: `README.md`)
- Bias Binding → Gyroscope Bias: wraps (evidence: `Python/imufusion/Bias.h`)
- Bias Binding → NumPy Conversion: converts arrays (evidence: `Python/imufusion/Bias.h`)
- Compass Binding → Compass Heading: wraps (evidence: `Python/imufusion/Compass.h`)
- Compass Binding → NumPy Conversion: converts arrays (evidence: `Python/imufusion/Compass.h`)
- Convention Binding → Axes Convention: wraps (evidence: `Python/imufusion/Convention.h`)
- Conversion Binding → Vector Quaternion Math: uses conversions (evidence: `Python/imufusion/Convert.h`)
- Magnetic Model Binding → Magnetic Model: wraps (evidence: `Python/imufusion/Model.h`)
- Magnetic Model Binding → NumPy Conversion: converts arrays (evidence: `Python/imufusion/Model.h`)
- Remap Binding → Sensor Axis Remap: wraps (evidence: `Python/imufusion/Remap.h`)
- Remap Binding → NumPy Conversion: converts arrays (evidence: `Python/imufusion/Remap.h`)
- AHRS Algorithm → Vector Quaternion Math: uses math
- AHRS Algorithm → Axes Convention: uses convention
- Gyroscope Bias → Vector Quaternion Math: uses math
- Compass Heading → Vector Quaternion Math: uses math
- Compass Heading → Axes Convention: uses convention
- Sensor Axis Remap → Vector Quaternion Math: uses math
