# yasinghazaly/fe-solver architecture

> Architecture diagram of the GitHub repository yasinghazaly/fe-solver, 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/yasinghazaly/fe-solver
- Repository: https://github.com/yasinghazaly/fe-solver

## Overview

fe-solver is a Python package for linear-elastic 2D plane-stress finite-element analysis. A user defines a mesh, material, supports and loads; assembles stiffness, solves for displacements, then recovers and visualizes stresses or evaluates error norms. The graph retains both element families and the verification/error-analysis branch. Relationships among the analysis stages follow the README usage example; implementation details are limited to the supplied excerpts and source index.

Main entry points: [`fesolver/assembly.py`](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/assembly.py) (Stiffness assembly), [`fesolver/solver.py`](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/solver.py) (Constrained solve), [`fesolver/mesh.py`](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/mesh.py) (Mesh), [`fesolver/postprocess.py`](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/postprocess.py) (Stress recovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_model["Model setup"]
  node_mesh["Mesh<br/>[mesh.py]"]
  node_material["Plane-stress material<br/>[materials.py]"]
  node_loads["Edge traction<br/>[loads.py]"]
end

subgraph group_mechanics["Element mechanics"]
  node_base["Element base<br/>[base.py]"]
  node_quad8["Quad8 element<br/>[quad8.py]"]
  node_cst["CST element<br/>[cst.py]"]
  node_quadrature["Gauss quadrature<br/>[quadrature.py]"]
end

subgraph group_analysis["Analysis"]
  node_assembly["Stiffness assembly<br/>[assembly.py]"]
  node_solver["Constrained solve<br/>[solver.py]"]
end

subgraph group_results["Results"]
  node_stress_recovery["Stress recovery<br/>[postprocess.py]"]
  node_stress_extrapolation["Nodal extrapolation<br/>[postprocess.py]"]
  node_stress_averaging["Nodal averaging<br/>[postprocess.py]"]
  node_stress_plot["Stress and shape plots<br/>[postprocess.py]"]
  node_error_norms["Error norms<br/>[errors.py]"]
end

node_user(("Analyst"))

node_user -->|"defines mesh"| node_mesh
node_user -->|"chooses material"| node_material
node_user -->|"defines traction"| node_loads
node_user -->|"requests assembly"| node_assembly
node_assembly -->|"reads topology"| node_mesh
node_assembly -->|"uses stiffness"| node_material
node_assembly -->|"instantiates"| node_quad8
node_assembly -->|"instantiates"| node_cst
node_assembly -->|"provides stiffness"| node_solver
node_loads -->|"provides load vector"| node_solver
node_user -->|"sets supports"| node_solver
node_base -->|"integrates with"| node_quadrature
node_quad8 -->|"inherits"| node_base
node_cst -->|"inherits"| node_base
node_cst -->|"uses edge rule"| node_quadrature
node_user -->|"requests recovery"| node_stress_recovery
node_solver -->|"returns displacement"| node_stress_recovery
node_mesh -->|"supplies geometry"| node_stress_recovery
node_stress_recovery -->|"feeds Gauss stresses"| node_stress_extrapolation
node_stress_extrapolation -->|"feeds element nodal stresses"| node_stress_averaging
node_stress_averaging -->|"feeds von Mises plot"| node_stress_plot
node_user -->|"requests plots"| node_stress_plot
node_user -->|"requests error measures"| node_error_norms
node_solver -->|"provides displacement"| node_error_norms
node_mesh -->|"supplies geometry"| node_error_norms
node_quadrature -->|"integrates norms"| node_error_norms

click node_mesh "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/mesh.py"
click node_material "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/materials.py"
click node_loads "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/loads.py"
click node_assembly "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/assembly.py"
click node_solver "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/solver.py"
click node_base "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/elements/base.py"
click node_quad8 "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/elements/quad8.py"
click node_cst "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/elements/cst.py"
click node_quadrature "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/quadrature.py"
click node_stress_recovery "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/postprocess.py"
click node_stress_extrapolation "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/postprocess.py"
click node_stress_averaging "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/postprocess.py"
click node_stress_plot "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/postprocess.py"
click node_error_norms "https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/errors.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_mesh,node_material,node_loads toneBlue
class node_base,node_quad8,node_cst,node_quadrature toneAmber
class node_assembly,node_solver toneMint
class node_stress_recovery,node_stress_extrapolation,node_stress_averaging,node_stress_plot,node_error_norms toneRose
class node_user toneIndigo
```

## Components

### Model setup

- [Mesh](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/mesh.py): `fesolver/mesh.py`
- [Plane-stress material](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/materials.py): `fesolver/materials.py`
- [Edge traction](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/loads.py): `fesolver/loads.py`

### Element mechanics

- [Element base](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/elements/base.py): `fesolver/elements/base.py`
- [Quad8 element](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/elements/quad8.py): `fesolver/elements/quad8.py`
- [CST element](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/elements/cst.py): `fesolver/elements/cst.py`
- [Gauss quadrature](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/quadrature.py): `fesolver/quadrature.py`

### Analysis

- [Stiffness assembly](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/assembly.py): `fesolver/assembly.py`
- [Constrained solve](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/solver.py): `fesolver/solver.py`

### Results

- [Stress recovery](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/postprocess.py): `fesolver/postprocess.py`
- [Nodal extrapolation](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/postprocess.py): `fesolver/postprocess.py`
- [Nodal averaging](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/postprocess.py): `fesolver/postprocess.py`
- [Stress and shape plots](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/postprocess.py): `fesolver/postprocess.py`
- [Error norms](https://github.com/yasinghazaly/fe-solver/blob/main/fesolver/errors.py): `fesolver/errors.py`

### Other components

- **Analyst**

## Connections

- Analyst → Mesh: defines mesh (evidence: `README.md`)
- Analyst → Plane-stress material: chooses material (evidence: `README.md`)
- Analyst → Edge traction: defines traction (evidence: `README.md`)
- Analyst → Stiffness assembly: requests assembly (evidence: `README.md`)
- Stiffness assembly → Mesh: reads topology (evidence: `fesolver/assembly.py`)
- Stiffness assembly → Plane-stress material: uses stiffness (evidence: `fesolver/assembly.py`)
- Stiffness assembly → Quad8 element: instantiates (evidence: `fesolver/assembly.py`)
- Stiffness assembly → CST element: instantiates (evidence: `fesolver/assembly.py`)
- Stiffness assembly → Constrained solve: provides stiffness (evidence: `README.md`)
- Edge traction → Constrained solve: provides load vector (evidence: `README.md`)
- Analyst → Constrained solve: sets supports (evidence: `README.md`)
- Element base → Gauss quadrature: integrates with (evidence: `fesolver/elements/base.py`)
- Quad8 element → Element base: inherits (evidence: `fesolver/elements/quad8.py`)
- CST element → Element base: inherits (evidence: `fesolver/elements/cst.py`)
- CST element → Gauss quadrature: uses edge rule (evidence: `fesolver/elements/cst.py`)
- Analyst → Stress recovery: requests recovery (evidence: `README.md`)
- Constrained solve → Stress recovery: returns displacement (evidence: `README.md`)
- Mesh → Stress recovery: supplies geometry (evidence: `README.md`)
- Stress recovery → Nodal extrapolation: feeds Gauss stresses (evidence: `README.md`)
- Nodal extrapolation → Nodal averaging: feeds element nodal stresses (evidence: `README.md`)
- Nodal averaging → Stress and shape plots: feeds von Mises plot (evidence: `README.md`)
- Analyst → Stress and shape plots: requests plots (evidence: `README.md`)
- Analyst → Error norms: requests error measures (evidence: `README.md`)
- Constrained solve → Error norms: provides displacement (evidence: `README.md`)
- Mesh → Error norms: supplies geometry (evidence: `README.md`)
- Gauss quadrature → Error norms: integrates norms (evidence: `fesolver/errors.py`)
