# acea15/feniax architecture

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

- Interactive diagram: https://gitdiagram.com/acea15/feniax
- Repository: https://github.com/acea15/feniax

## Overview

FENIAX is a JAX-based nonlinear intrinsic aeroelastic analysis and post-processing toolbox for finite-element models, commonly prepared with commercial solvers such as MSC Nastran. Users provide configuration and model data; the intrinsic driver builds modal data and systems, runs static or dynamic simulations (including concurrent cases), and stores results for recovery and visualization. The README also documents aerodynamic, gust, flight-dynamics, GPU, and algorithm-differentiation capabilities. Several branches are supported by README statements or indexed references rather than inspected implementations, so their links are omitted where call ownership is not evidenced.

Main entry points: [`feniax/systems/intrinsic_system.py`](https://github.com/acea15/feniax/blob/master/feniax/systems/intrinsic_system.py) (Intrinsic systems), [`feniax/drivers/intrinsic_driver.py`](https://github.com/acea15/feniax/blob/master/feniax/drivers/intrinsic_driver.py) (Intrinsic driver), [`feniax/intrinsic/dq_dynamic.py`](https://github.com/acea15/feniax/blob/master/feniax/intrinsic/dq_dynamic.py) (Dynamic response), [`feniax/intrinsic/galerkinmodes.py`](https://github.com/acea15/feniax/blob/master/feniax/intrinsic/galerkinmodes.py) (Modal preparation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Inputs and modal preparation"]
  node_config["Configuration<br/>[configuration.py]"]
  node_model_import["Nastran processing"]
  node_modal["Modal preparation<br/>[galerkinmodes.py]"]
  node_modal_data["Model containers<br/>[intrinsicmodal.py]"]
end

subgraph group_runtime["Analysis runtime"]
  node_driver["Intrinsic driver"]
  node_simulation["Simulation orchestration"]
  node_system["Intrinsic systems"]
  node_parallel["Concurrent cases"]
  node_solver["ODE solver<br/>[jax.py]"]
end

subgraph group_physics["Intrinsic physics"]
  node_arguments["Solver arguments<br/>[args.py]"]
  node_static["Static response<br/>[dq_static.py]"]
  node_dynamic["Dynamic response<br/>[dq_dynamic.py]"]
  node_loads["Loads and gusts<br/>[xloads.py]"]
  node_aero["Aerodynamic models<br/>[aero.py]"]
  node_aeromodal["Aero modal tools"]
  node_ad["AD and shard solvers"]
end

subgraph group_results["Results and visualization"]
  node_solution[("Solution store<br/>[solution.py]")]
  node_recovery["Response recovery<br/>[postprocess.py]"]
  node_grid["Grid mapping<br/>[grid.py]"]
  node_visualization["Plots and views"]
  node_streamlit["Interactive explorer<br/>[intrinsic.py]"]
end

node_user(("Analyst"))
node_nastran["FE model"]

node_user -->|"sets inputs"| node_config
node_nastran -.->|"provides FE data"| node_model_import
node_user -->|"runs analysis"| node_driver
node_config -->|"configures"| node_driver
node_driver -->|"prepares modes"| node_modal
node_driver -->|"creates systems"| node_system
node_driver -->|"selects simulation"| node_simulation
node_driver -->|"spawns cases"| node_parallel
node_model_import -.->|"supplies model data"| node_modal
node_modal -->|"builds modal data"| node_modal_data
node_simulation -->|"runs systems"| node_system
node_system -->|"builds arguments"| node_arguments
node_system -->|"calls static response"| node_static
node_system -->|"calls dynamic response"| node_dynamic
node_system -->|"uses load data"| node_loads
node_system -->|"builds aero model"| node_aero
node_dynamic -->|"integrates response"| node_solver
node_dynamic -->|"uses loads"| node_loads
node_static -->|"uses loads"| node_loads
node_aeromodal -->|"uses JAX solver"| node_solver
node_system -.->|"supports differentiated modes"| node_ad
node_system -->|"saves responses"| node_solution
node_system -->|"recovers fields"| node_recovery
node_recovery -->|"uses solution data"| node_solution
node_solution -->|"provides results"| node_grid
node_grid -.->|"feeds visualization"| node_visualization
node_user -->|"explores results"| node_streamlit

click node_config "https://github.com/acea15/feniax/blob/master/feniax/preprocessor/configuration.py"
click node_model_import "https://github.com/acea15/feniax/tree/master/feniax/unastran"
click node_modal "https://github.com/acea15/feniax/blob/master/feniax/intrinsic/galerkinmodes.py"
click node_modal_data "https://github.com/acea15/feniax/blob/master/feniax/preprocessor/containers/intrinsicmodal.py"
click node_driver "https://github.com/acea15/feniax/blob/master/feniax/drivers/intrinsic_driver.py"
click node_simulation "https://github.com/acea15/feniax/tree/master/feniax/simulations"
click node_system "https://github.com/acea15/feniax/blob/master/feniax/systems/intrinsic_system.py"
click node_parallel "https://github.com/acea15/feniax/blob/master/feniax/foragers/intrinsic_forager.py"
click node_solver "https://github.com/acea15/feniax/blob/master/feniax/systems/sollibs/jax.py"
click node_arguments "https://github.com/acea15/feniax/blob/master/feniax/intrinsic/args.py"
click node_static "https://github.com/acea15/feniax/blob/master/feniax/intrinsic/dq_static.py"
click node_dynamic "https://github.com/acea15/feniax/blob/master/feniax/intrinsic/dq_dynamic.py"
click node_loads "https://github.com/acea15/feniax/blob/master/feniax/intrinsic/xloads.py"
click node_aero "https://github.com/acea15/feniax/blob/master/feniax/intrinsic/aero.py"
click node_aeromodal "https://github.com/acea15/feniax/tree/master/feniax/aeromodal"
click node_ad "https://github.com/acea15/feniax/tree/master/feniax/systems"
click node_solution "https://github.com/acea15/feniax/blob/master/feniax/preprocessor/solution.py"
click node_recovery "https://github.com/acea15/feniax/blob/master/feniax/intrinsic/postprocess.py"
click node_grid "https://github.com/acea15/feniax/blob/master/feniax/plotools/grid.py"
click node_visualization "https://github.com/acea15/feniax/tree/master/feniax/plotools"
click node_streamlit "https://github.com/acea15/feniax/blob/master/feniax/plotools/streamlit/intrinsic.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_config,node_model_import,node_modal,node_modal_data toneBlue
class node_driver,node_simulation,node_system,node_parallel,node_solver toneAmber
class node_arguments,node_static,node_dynamic,node_loads,node_aero,node_aeromodal,node_ad toneMint
class node_solution,node_recovery,node_grid,node_visualization,node_streamlit toneRose
class node_user,node_nastran toneIndigo
```

## Components

### Inputs and modal preparation

- [Configuration](https://github.com/acea15/feniax/blob/master/feniax/preprocessor/configuration.py): `feniax/preprocessor/configuration.py`
- [Nastran processing](https://github.com/acea15/feniax/tree/master/feniax/unastran): `feniax/unastran`
- [Modal preparation](https://github.com/acea15/feniax/blob/master/feniax/intrinsic/galerkinmodes.py): `feniax/intrinsic/galerkinmodes.py`
- [Model containers](https://github.com/acea15/feniax/blob/master/feniax/preprocessor/containers/intrinsicmodal.py): `feniax/preprocessor/containers/intrinsicmodal.py`

### Analysis runtime

- [Intrinsic driver](https://github.com/acea15/feniax/blob/master/feniax/drivers/intrinsic_driver.py): `feniax/drivers/intrinsic_driver.py`
- [Simulation orchestration](https://github.com/acea15/feniax/tree/master/feniax/simulations): `feniax/simulations`
- [Intrinsic systems](https://github.com/acea15/feniax/blob/master/feniax/systems/intrinsic_system.py): `feniax/systems/intrinsic_system.py`
- [Concurrent cases](https://github.com/acea15/feniax/blob/master/feniax/foragers/intrinsic_forager.py): `feniax/foragers/intrinsic_forager.py`
- [ODE solver](https://github.com/acea15/feniax/blob/master/feniax/systems/sollibs/jax.py): `feniax/systems/sollibs/jax.py`

### Intrinsic physics

- [Solver arguments](https://github.com/acea15/feniax/blob/master/feniax/intrinsic/args.py): `feniax/intrinsic/args.py`
- [Static response](https://github.com/acea15/feniax/blob/master/feniax/intrinsic/dq_static.py): `feniax/intrinsic/dq_static.py`
- [Dynamic response](https://github.com/acea15/feniax/blob/master/feniax/intrinsic/dq_dynamic.py): `feniax/intrinsic/dq_dynamic.py`
- [Loads and gusts](https://github.com/acea15/feniax/blob/master/feniax/intrinsic/xloads.py): `feniax/intrinsic/xloads.py`
- [Aerodynamic models](https://github.com/acea15/feniax/blob/master/feniax/intrinsic/aero.py): `feniax/intrinsic/aero.py`
- [Aero modal tools](https://github.com/acea15/feniax/tree/master/feniax/aeromodal): `feniax/aeromodal`
- [AD and shard solvers](https://github.com/acea15/feniax/tree/master/feniax/systems): `feniax/systems`

### Results and visualization

- [Solution store](https://github.com/acea15/feniax/blob/master/feniax/preprocessor/solution.py): `feniax/preprocessor/solution.py`
- [Response recovery](https://github.com/acea15/feniax/blob/master/feniax/intrinsic/postprocess.py): `feniax/intrinsic/postprocess.py`
- [Grid mapping](https://github.com/acea15/feniax/blob/master/feniax/plotools/grid.py): `feniax/plotools/grid.py`
- [Plots and views](https://github.com/acea15/feniax/tree/master/feniax/plotools): `feniax/plotools`
- [Interactive explorer](https://github.com/acea15/feniax/blob/master/feniax/plotools/streamlit/intrinsic.py): `feniax/plotools/streamlit/intrinsic.py`

### Other components

- **Analyst**
- **FE model**

## Connections

- Analyst → Configuration: sets inputs (evidence: `feniax/preprocessor/configuration.py`)
- FE model → Nastran processing: provides FE data (evidence: `README.md`)
- Analyst → Intrinsic driver: runs analysis (evidence: `feniax/drivers/intrinsic_driver.py`)
- Configuration → Intrinsic driver: configures (evidence: `feniax/drivers/intrinsic_driver.py`)
- Intrinsic driver → Modal preparation: prepares modes (evidence: `feniax/drivers/intrinsic_driver.py`)
- Intrinsic driver → Intrinsic systems: creates systems (evidence: `feniax/drivers/intrinsic_driver.py`)
- Intrinsic driver → Simulation orchestration: selects simulation (evidence: `feniax/drivers/intrinsic_driver.py`)
- Intrinsic driver → Concurrent cases: spawns cases (evidence: `feniax/drivers/intrinsic_driver.py`)
- Nastran processing → Modal preparation: supplies model data
- Modal preparation → Model containers: builds modal data (evidence: `feniax/intrinsic/galerkinmodes.py`)
- Simulation orchestration → Intrinsic systems: runs systems (evidence: `feniax/simulations/simulation.py`)
- Intrinsic systems → Solver arguments: builds arguments (evidence: `feniax/systems/intrinsic_system.py`)
- Intrinsic systems → Static response: calls static response (evidence: `feniax/systems/intrinsic_system.py`)
- Intrinsic systems → Dynamic response: calls dynamic response (evidence: `feniax/systems/intrinsic_system.py`)
- Intrinsic systems → Loads and gusts: uses load data (evidence: `feniax/systems/intrinsic_system.py`)
- Intrinsic systems → Aerodynamic models: builds aero model (evidence: `feniax/systems/intrinsic_system.py`)
- Dynamic response → ODE solver: integrates response (evidence: `feniax/intrinsic/dq_dynamic.py`)
- Dynamic response → Loads and gusts: uses loads (evidence: `feniax/intrinsic/dq_dynamic.py`)
- Static response → Loads and gusts: uses loads (evidence: `feniax/intrinsic/dq_static.py`)
- Aero modal tools → ODE solver: uses JAX solver (evidence: `feniax/aeromodal/roger.py`)
- Intrinsic systems → AD and shard solvers: supports differentiated modes (evidence: `README.md`)
- Intrinsic systems → Solution store: saves responses (evidence: `feniax/systems/intrinsic_system.py`)
- Intrinsic systems → Response recovery: recovers fields (evidence: `feniax/systems/intrinsic_system.py`)
- Response recovery → Solution store: uses solution data (evidence: `feniax/intrinsic/postprocess.py`)
- Solution store → Grid mapping: provides results (evidence: `feniax/plotools/grid.py`)
- Grid mapping → Plots and views: feeds visualization (evidence: `feniax/plotools/grid.py`)
- Analyst → Interactive explorer: explores results (evidence: `feniax/plotools/streamlit/intrinsic.py`)
