# dhondtguido/calculix architecture

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

- Interactive diagram: https://gitdiagram.com/dhondtguido/calculix
- Repository: https://github.com/dhondtguido/calculix

## Overview

CalculiX is a three-dimensional structural finite-element solver. The principal workflow is a user supplying an analysis model, the solver performing an analysis, and results being written for review. The source also identifies dynamic, electromagnetic, nonlinear, cyclic-modal, contact, and design-sensitivity capabilities. The graph highlights those domain stages and the sparse-solver layer. Several runtime relationships are omitted or shown as unverified because the available excerpts do not expose their call sites; the README provides product context, not detailed execution flow.

Main entry points: [`src/CalculiX.c`](https://github.com/dhondtguido/calculix/blob/master/src/CalculiX.c) (CalculiX driver), [`src/nonlingeo.c`](https://github.com/dhondtguido/calculix/blob/master/src/nonlingeo.c) (Nonlinear analysis), [`src/CalculiXstep.c`](https://github.com/dhondtguido/calculix/blob/master/src/CalculiXstep.c) (Step orchestration), [`src/arpackcs.c`](https://github.com/dhondtguido/calculix/blob/master/src/arpackcs.c) (Cyclic eigenanalysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Analysis workflows"]
  node_driver["CalculiX driver<br/>[CalculiX.c]"]
  node_step["Step orchestration<br/>[CalculiXstep.c]"]
  node_linear["Linear statics<br/>[linstatic.c]"]
  node_nonlinear["Nonlinear analysis<br/>[nonlingeo.c]"]
  node_cyclic["Cyclic eigenanalysis<br/>[arpackcs.c]"]
  node_steadystate["Steady-state response<br/>[steadystate.c]"]
end

subgraph group_physics["Physics and contact"]
  node_dynamics["Dynamics<br/>[dyna.c]"]
  node_electromagnetics["Electromagnetics<br/>[electromagnetics.c]"]
  node_contact["Mortar contact<br/>[multimortar.c]"]
  node_crack["Crack propagation<br/>[crackpropagation.c]"]
end

subgraph group_numerics["Numerical solvers"]
  node_matrix_structure["Matrix structure<br/>[mastruct.c]"]
  node_matrix_storage["Matrix storage<br/>[matrixstorage.c]"]
  node_spooles["SPOOLES solver<br/>[spooles.c]"]
  node_pardiso["PARDISO interface<br/>[pardiso.h]"]
  node_pastix["PaStiX interface<br/>[pastix.c]"]
end

subgraph group_results["Results and design"]
  node_frd["FRD results writer<br/>[frd.c]"]
  node_results_calc["Result calculations<br/>[results.c]"]
  node_objective["Design objectives<br/>[objectivemain_se.c]"]
  node_sensitivity["Coordinate sensitivity<br/>[sensi_coor.c]"]
end

node_user(("Analyst"))

node_user -.->|"runs analysis"| node_driver
node_driver -.->|"dispatches steps"| node_step
node_step -.->|"selects procedure"| node_linear
node_step -.->|"selects procedure"| node_nonlinear
node_nonlinear -->|"writes output"| node_frd
node_nonlinear -->|"calls results"| node_results_calc
node_cyclic -->|"builds structure"| node_matrix_structure
node_cyclic -->|"factors matrix"| node_spooles
node_steadystate -->|"solves system"| node_spooles
node_objective -->|"solves system"| node_pardiso
node_nonlinear -.->|"uses contact"| node_contact
node_objective -.->|"computes gradients"| node_sensitivity
node_driver -.->|"dispatches analysis"| node_dynamics
node_driver -.->|"dispatches analysis"| node_electromagnetics
node_driver -.->|"dispatches analysis"| node_cyclic
node_driver -.->|"dispatches analysis"| node_steadystate
node_driver -.->|"dispatches analysis"| node_crack

click node_driver "https://github.com/dhondtguido/calculix/blob/master/src/CalculiX.c"
click node_step "https://github.com/dhondtguido/calculix/blob/master/src/CalculiXstep.c"
click node_linear "https://github.com/dhondtguido/calculix/blob/master/src/linstatic.c"
click node_nonlinear "https://github.com/dhondtguido/calculix/blob/master/src/nonlingeo.c"
click node_dynamics "https://github.com/dhondtguido/calculix/blob/master/src/dyna.c"
click node_electromagnetics "https://github.com/dhondtguido/calculix/blob/master/src/electromagnetics.c"
click node_contact "https://github.com/dhondtguido/calculix/blob/master/src/multimortar.c"
click node_cyclic "https://github.com/dhondtguido/calculix/blob/master/src/arpackcs.c"
click node_steadystate "https://github.com/dhondtguido/calculix/blob/master/src/steadystate.c"
click node_matrix_structure "https://github.com/dhondtguido/calculix/blob/master/src/mastruct.c"
click node_matrix_storage "https://github.com/dhondtguido/calculix/blob/master/src/matrixstorage.c"
click node_spooles "https://github.com/dhondtguido/calculix/blob/master/src/spooles.c"
click node_pardiso "https://github.com/dhondtguido/calculix/blob/master/src/pardiso.h"
click node_pastix "https://github.com/dhondtguido/calculix/blob/master/src/pastix.c"
click node_frd "https://github.com/dhondtguido/calculix/blob/master/src/frd.c"
click node_results_calc "https://github.com/dhondtguido/calculix/blob/master/src/results.c"
click node_objective "https://github.com/dhondtguido/calculix/blob/master/src/objectivemain_se.c"
click node_sensitivity "https://github.com/dhondtguido/calculix/blob/master/src/sensi_coor.c"
click node_crack "https://github.com/dhondtguido/calculix/blob/master/src/crackpropagation.c"

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_driver,node_step,node_linear,node_nonlinear,node_cyclic,node_steadystate toneBlue
class node_dynamics,node_electromagnetics,node_contact,node_crack toneAmber
class node_matrix_structure,node_matrix_storage,node_spooles,node_pardiso,node_pastix toneMint
class node_frd,node_results_calc,node_objective,node_sensitivity toneRose
class node_user toneIndigo
```

## Components

### Analysis workflows

- [CalculiX driver](https://github.com/dhondtguido/calculix/blob/master/src/CalculiX.c): `src/CalculiX.c`
- [Step orchestration](https://github.com/dhondtguido/calculix/blob/master/src/CalculiXstep.c): `src/CalculiXstep.c`
- [Linear statics](https://github.com/dhondtguido/calculix/blob/master/src/linstatic.c): `src/linstatic.c`
- [Nonlinear analysis](https://github.com/dhondtguido/calculix/blob/master/src/nonlingeo.c): `src/nonlingeo.c`
- [Cyclic eigenanalysis](https://github.com/dhondtguido/calculix/blob/master/src/arpackcs.c): `src/arpackcs.c`
- [Steady-state response](https://github.com/dhondtguido/calculix/blob/master/src/steadystate.c): `src/steadystate.c`

### Physics and contact

- [Dynamics](https://github.com/dhondtguido/calculix/blob/master/src/dyna.c): `src/dyna.c`
- [Electromagnetics](https://github.com/dhondtguido/calculix/blob/master/src/electromagnetics.c): `src/electromagnetics.c`
- [Mortar contact](https://github.com/dhondtguido/calculix/blob/master/src/multimortar.c): `src/multimortar.c`
- [Crack propagation](https://github.com/dhondtguido/calculix/blob/master/src/crackpropagation.c): `src/crackpropagation.c`

### Numerical solvers

- [Matrix structure](https://github.com/dhondtguido/calculix/blob/master/src/mastruct.c): `src/mastruct.c`
- [Matrix storage](https://github.com/dhondtguido/calculix/blob/master/src/matrixstorage.c): `src/matrixstorage.c`
- [SPOOLES solver](https://github.com/dhondtguido/calculix/blob/master/src/spooles.c): `src/spooles.c`
- [PARDISO interface](https://github.com/dhondtguido/calculix/blob/master/src/pardiso.h): `src/pardiso.h`
- [PaStiX interface](https://github.com/dhondtguido/calculix/blob/master/src/pastix.c): `src/pastix.c`

### Results and design

- [FRD results writer](https://github.com/dhondtguido/calculix/blob/master/src/frd.c): `src/frd.c`
- [Result calculations](https://github.com/dhondtguido/calculix/blob/master/src/results.c): `src/results.c`
- [Design objectives](https://github.com/dhondtguido/calculix/blob/master/src/objectivemain_se.c): `src/objectivemain_se.c`
- [Coordinate sensitivity](https://github.com/dhondtguido/calculix/blob/master/src/sensi_coor.c): `src/sensi_coor.c`

### Other components

- **Analyst**

## Connections

- Analyst → CalculiX driver: runs analysis (evidence: `README.md`)
- CalculiX driver → Step orchestration: dispatches steps
- Step orchestration → Linear statics: selects procedure
- Step orchestration → Nonlinear analysis: selects procedure
- Nonlinear analysis → FRD results writer: writes output (evidence: `src/nonlingeo.c`)
- Nonlinear analysis → Result calculations: calls results (evidence: `src/nonlingeo.c`)
- Cyclic eigenanalysis → Matrix structure: builds structure (evidence: `src/arpackcs.c`)
- Cyclic eigenanalysis → SPOOLES solver: factors matrix (evidence: `src/arpackcs.c`)
- Steady-state response → SPOOLES solver: solves system (evidence: `src/steadystate.c`)
- Design objectives → PARDISO interface: solves system (evidence: `src/objectivemain_se.c`)
- Nonlinear analysis → Mortar contact: uses contact
- Design objectives → Coordinate sensitivity: computes gradients
- CalculiX driver → Dynamics: dispatches analysis
- CalculiX driver → Electromagnetics: dispatches analysis
- CalculiX driver → Cyclic eigenanalysis: dispatches analysis
- CalculiX driver → Steady-state response: dispatches analysis
- CalculiX driver → Crack propagation: dispatches analysis
