# neerajbalachandar/varflexi-solver architecture

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

- Interactive diagram: https://gitdiagram.com/neerajbalachandar/varflexi-solver
- Repository: https://github.com/neerajbalachandar/varflexi-solver

## Overview

VarFlExI is a partitioned aeroelastic FSI framework exchanging data between FLOWUnsteady and a FEniCS structural solver across non-conforming interfaces. The principal workflow couples fluid-side loads to the solid solver, transfers forces and displacements using either Wendland RBF or common-refinement operators, and returns structural data for the next coupled step. The graph also preserves the shell/FEM support and case-sweep entry point. Some runtime wiring is not excerpted; only documented or source-index-supported relationships are shown.

Main entry points: [`solid/structural_solver.py`](https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/structural_solver.py) (Structural solver), [`coupling.py`](https://github.com/neerajbalachandar/varflexi-solver/blob/final/coupling.py) (Coupling runtime), [`coupling/utils/coupling_transfer.py`](https://github.com/neerajbalachandar/varflexi-solver/blob/final/coupling/utils/coupling_transfer.py) (Coupling transfer), [`solid/utils/reisner_mindlin_model.py`](https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/utils/reisner_mindlin_model.py) (Reissner-Mindlin model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Coupled runtime"]
  node_coupling_server["Coupling runtime<br/>[coupling.py]"]
  node_varflexi["VarFlExI interface<br/>[varflexi.py]"]
  node_solid_solver["Structural solver"]
  node_case_runner["Case runner<br/>[run_case.py]"]
end

subgraph group_transfer["Interface transfer"]
  node_transfer_ops["Coupling transfer"]
  node_crm["Common refinement"]
  node_rbf["Wendland RBF<br/>[rbf_transfer.py]"]
end

subgraph group_structure["Structural mechanics"]
  node_domain["Solid domain"]
  node_plate_model["Reissner-Mindlin model"]
  node_time_integrator["Generalized-alpha"]
end

subgraph group_shells["Shell FEM support"]
  node_shell_spaces["Shell function spaces<br/>[functionspace.py]"]
  node_rm_spaces["Reissner-Mindlin spaces<br/>[function_spaces.py]"]
  node_shell_forms["Shell formulations<br/>[forms.py]"]
  node_shell_assembly["FEM assembly<br/>[assembling.py]"]
  node_shell_solve["FEM solving<br/>[solving.py]"]
  node_probes["Probe utilities<br/>[Probe.py]"]
end

node_flow(("FLOWUnsteady"))

node_flow -.->|"exchanges data"| node_coupling_server
node_coupling_server -.->|"exchanges data"| node_flow
node_coupling_server -.->|"coordinates"| node_varflexi
node_solid_solver -->|"sends loads"| node_flow
node_flow -.->|"returns loads"| node_solid_solver
node_solid_solver -->|"builds domain"| node_domain
node_solid_solver -->|"uses model"| node_plate_model
node_solid_solver -->|"transfers forces"| node_transfer_ops
node_transfer_ops -->|"builds operator"| node_crm
node_transfer_ops -->|"uses operator"| node_rbf
node_plate_model -->|"uses integrator"| node_time_integrator
node_rm_spaces -->|"uses spaces"| node_shell_spaces
node_case_runner -.->|"launches run"| node_solid_solver

click node_coupling_server "https://github.com/neerajbalachandar/varflexi-solver/blob/final/coupling.py"
click node_varflexi "https://github.com/neerajbalachandar/varflexi-solver/blob/final/coupling/varflexi.py"
click node_solid_solver "https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/structural_solver.py"
click node_case_runner "https://github.com/neerajbalachandar/varflexi-solver/blob/final/scripts/run_case.py"
click node_domain "https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/utils/make_solid_domain.py"
click node_plate_model "https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/utils/reisner_mindlin_model.py"
click node_time_integrator "https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/utils/generalized_alpha.py"
click node_transfer_ops "https://github.com/neerajbalachandar/varflexi-solver/blob/final/coupling/utils/coupling_transfer.py"
click node_crm "https://github.com/neerajbalachandar/varflexi-solver/blob/final/coupling/utils/common_refinement_mesh.py"
click node_rbf "https://github.com/neerajbalachandar/varflexi-solver/blob/final/coupling/utils/rbf_transfer.py"
click node_shell_spaces "https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/fenics_shells/functions/functionspace.py"
click node_rm_spaces "https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/fenics_shells/reissner_mindlin/function_spaces.py"
click node_shell_forms "https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/fenics_shells/reissner_mindlin/forms.py"
click node_shell_assembly "https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/fenics_shells/fem/assembling.py"
click node_shell_solve "https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/fenics_shells/fem/solving.py"
click node_probes "https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/fenics_shells/utils/Probe.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_coupling_server,node_varflexi,node_solid_solver,node_case_runner toneBlue
class node_transfer_ops,node_crm,node_rbf toneAmber
class node_domain,node_plate_model,node_time_integrator toneMint
class node_shell_spaces,node_rm_spaces,node_shell_forms,node_shell_assembly,node_shell_solve,node_probes toneRose
class node_flow toneIndigo
```

## Components

### Coupled runtime

- [Coupling runtime](https://github.com/neerajbalachandar/varflexi-solver/blob/final/coupling.py): `coupling.py`
- [VarFlExI interface](https://github.com/neerajbalachandar/varflexi-solver/blob/final/coupling/varflexi.py): `coupling/varflexi.py`
- [Structural solver](https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/structural_solver.py): `solid/structural_solver.py`
- [Case runner](https://github.com/neerajbalachandar/varflexi-solver/blob/final/scripts/run_case.py): `scripts/run_case.py`

### Interface transfer

- [Coupling transfer](https://github.com/neerajbalachandar/varflexi-solver/blob/final/coupling/utils/coupling_transfer.py): `coupling/utils/coupling_transfer.py`
- [Common refinement](https://github.com/neerajbalachandar/varflexi-solver/blob/final/coupling/utils/common_refinement_mesh.py): `coupling/utils/common_refinement_mesh.py`
- [Wendland RBF](https://github.com/neerajbalachandar/varflexi-solver/blob/final/coupling/utils/rbf_transfer.py): `coupling/utils/rbf_transfer.py`

### Structural mechanics

- [Solid domain](https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/utils/make_solid_domain.py): `solid/utils/make_solid_domain.py`
- [Reissner-Mindlin model](https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/utils/reisner_mindlin_model.py): `solid/utils/reisner_mindlin_model.py`
- [Generalized-alpha](https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/utils/generalized_alpha.py): `solid/utils/generalized_alpha.py`

### Shell FEM support

- [Shell function spaces](https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/fenics_shells/functions/functionspace.py): `solid/fenics_shells/functions/functionspace.py`
- [Reissner-Mindlin spaces](https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/fenics_shells/reissner_mindlin/function_spaces.py): `solid/fenics_shells/reissner_mindlin/function_spaces.py`
- [Shell formulations](https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/fenics_shells/reissner_mindlin/forms.py): `solid/fenics_shells/reissner_mindlin/forms.py`
- [FEM assembly](https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/fenics_shells/fem/assembling.py): `solid/fenics_shells/fem/assembling.py`
- [FEM solving](https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/fenics_shells/fem/solving.py): `solid/fenics_shells/fem/solving.py`
- [Probe utilities](https://github.com/neerajbalachandar/varflexi-solver/blob/final/solid/fenics_shells/utils/Probe.py): `solid/fenics_shells/utils/Probe.py`

### Other components

- **FLOWUnsteady**

## Connections

- FLOWUnsteady → Coupling runtime: exchanges data
- Coupling runtime → FLOWUnsteady: exchanges data
- Coupling runtime → VarFlExI interface: coordinates
- Structural solver → FLOWUnsteady: sends loads (evidence: `solid/structural_solver.py`)
- FLOWUnsteady → Structural solver: returns loads
- Structural solver → Solid domain: builds domain (evidence: `solid/structural_solver.py`)
- Structural solver → Reissner-Mindlin model: uses model
- Structural solver → Coupling transfer: transfers forces (evidence: `solid/structural_solver.py`)
- Coupling transfer → Common refinement: builds operator (evidence: `coupling/utils/coupling_transfer.py`)
- Coupling transfer → Wendland RBF: uses operator (evidence: `coupling/utils/coupling_transfer.py`)
- Reissner-Mindlin model → Generalized-alpha: uses integrator (evidence: `solid/utils/reisner_mindlin_model.py`)
- Reissner-Mindlin spaces → Shell function spaces: uses spaces (evidence: `solid/fenics_shells/reissner_mindlin/function_spaces.py`)
- Case runner → Structural solver: launches run
