# abcoding/pxml_k-hessian architecture

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

- Interactive diagram: https://gitdiagram.com/abcoding/pxml_k-hessian
- Repository: https://github.com/abcoding/pxml_k-hessian

## Overview

This repository is a numerical research application for computing radial k-Hessian eigenvalues and comparing them with asymptotic bounds and limiting eigenfunctions. The main workflow runs adaptive continuation, saves computed histories, then generates eigenvalue, residual, eigenfunction, and L1-convergence plots. The graph separates the solver’s ODE model from continuation and theoretical calculations. Plotting and persistence details are based on the shown excerpts; the README documents the result types, but not every internal plotting step.

Main entry points: [`run.py`](https://github.com/abcoding/pxml_k-hessian/blob/main/run.py) (Run entry point), [`continuation.py`](https://github.com/abcoding/pxml_k-hessian/blob/main/continuation.py) (Computed histories), [`plotting.py`](https://github.com/abcoding/pxml_k-hessian/blob/main/plotting.py) (Bounds comparison plot), [`math_utils.py`](https://github.com/abcoding/pxml_k-hessian/blob/main/math_utils.py) (Math utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Run workflow"]
  node_run["Run entry point<br/>[run.py]"]
  node_continuation["Adaptive continuation<br/>[continuation.py]"]
end

subgraph group_numerics["Numerical solver"]
  node_bvp["BVP solver<br/>[solver.py]"]
  node_radialode["Radial ODE<br/>[ode_system.py]"]
end

subgraph group_theory["Theory and bounds"]
  node_math["Math utilities<br/>[math_utils.py]"]
  node_bounds["Eigenvalue bounds<br/>[bounds.py]"]
  node_limitfunction["Limit eigenfunction<br/>[math_utils.py]"]
  node_limit["Asymptotic limit<br/>[math_utils.py]"]
end

subgraph group_outputs["Results and plots"]
  node_dataset["Computed histories<br/>[continuation.py]"]
  node_boundplots["Bounds comparison plot<br/>[plotting.py]"]
  node_residualplots["Bound residual plots<br/>[plotting.py]"]
  node_eigenplots["Eigenfunction plots<br/>[plotting.py]"]
  node_l1plots["L1 convergence plot<br/>[plotting.py]"]
end

node_researcher(("Researcher"))

node_researcher -->|"executes"| node_run
node_run -->|"runs"| node_continuation
node_run -->|"plots"| node_boundplots
node_run -->|"plots"| node_residualplots
node_run -->|"plots"| node_eigenplots
node_continuation -->|"solves steps"| node_bvp
node_bvp -->|"uses"| node_radialode
node_bvp -->|"estimates with"| node_math
node_radialode -->|"computes with"| node_math
node_bounds -->|"computes with"| node_math
node_continuation -->|"writes"| node_dataset
node_boundplots -->|"reads"| node_dataset
node_residualplots -->|"reads"| node_dataset
node_eigenplots -->|"reads"| node_dataset
node_l1plots -->|"reads"| node_dataset
node_boundplots -->|"evaluates"| node_bounds
node_residualplots -->|"evaluates"| node_bounds
node_boundplots -->|"shows"| node_limit
node_eigenplots -->|"overlays"| node_limitfunction
node_limitfunction -.->|"defined in"| node_math
node_l1plots -.->|"summarizes errors"| node_eigenplots

click node_run "https://github.com/abcoding/pxml_k-hessian/blob/main/run.py"
click node_continuation "https://github.com/abcoding/pxml_k-hessian/blob/main/continuation.py"
click node_bvp "https://github.com/abcoding/pxml_k-hessian/blob/main/solver.py"
click node_radialode "https://github.com/abcoding/pxml_k-hessian/blob/main/ode_system.py"
click node_math "https://github.com/abcoding/pxml_k-hessian/blob/main/math_utils.py"
click node_bounds "https://github.com/abcoding/pxml_k-hessian/blob/main/bounds.py"
click node_limitfunction "https://github.com/abcoding/pxml_k-hessian/blob/main/math_utils.py"
click node_limit "https://github.com/abcoding/pxml_k-hessian/blob/main/math_utils.py"
click node_dataset "https://github.com/abcoding/pxml_k-hessian/blob/main/continuation.py"
click node_boundplots "https://github.com/abcoding/pxml_k-hessian/blob/main/plotting.py"
click node_residualplots "https://github.com/abcoding/pxml_k-hessian/blob/main/plotting.py"
click node_eigenplots "https://github.com/abcoding/pxml_k-hessian/blob/main/plotting.py"
click node_l1plots "https://github.com/abcoding/pxml_k-hessian/blob/main/plotting.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_run,node_continuation toneBlue
class node_bvp,node_radialode toneAmber
class node_math,node_bounds,node_limitfunction,node_limit toneMint
class node_dataset,node_boundplots,node_residualplots,node_eigenplots,node_l1plots toneRose
class node_researcher toneIndigo
```

## Components

### Run workflow

- [Run entry point](https://github.com/abcoding/pxml_k-hessian/blob/main/run.py): `run.py`
- [Adaptive continuation](https://github.com/abcoding/pxml_k-hessian/blob/main/continuation.py): `continuation.py`

### Numerical solver

- [BVP solver](https://github.com/abcoding/pxml_k-hessian/blob/main/solver.py): `solver.py`
- [Radial ODE](https://github.com/abcoding/pxml_k-hessian/blob/main/ode_system.py): `ode_system.py`

### Theory and bounds

- [Math utilities](https://github.com/abcoding/pxml_k-hessian/blob/main/math_utils.py): `math_utils.py`
- [Eigenvalue bounds](https://github.com/abcoding/pxml_k-hessian/blob/main/bounds.py): `bounds.py`
- [Limit eigenfunction](https://github.com/abcoding/pxml_k-hessian/blob/main/math_utils.py): `math_utils.py`
- [Asymptotic limit](https://github.com/abcoding/pxml_k-hessian/blob/main/math_utils.py): `math_utils.py`

### Results and plots

- [Computed histories](https://github.com/abcoding/pxml_k-hessian/blob/main/continuation.py): `continuation.py`
- [Bounds comparison plot](https://github.com/abcoding/pxml_k-hessian/blob/main/plotting.py): `plotting.py`
- [Bound residual plots](https://github.com/abcoding/pxml_k-hessian/blob/main/plotting.py): `plotting.py`
- [Eigenfunction plots](https://github.com/abcoding/pxml_k-hessian/blob/main/plotting.py): `plotting.py`
- [L1 convergence plot](https://github.com/abcoding/pxml_k-hessian/blob/main/plotting.py): `plotting.py`

### Other components

- **Researcher**

## Connections

- Researcher → Run entry point: executes (evidence: `README.md`)
- Run entry point → Adaptive continuation: runs (evidence: `run.py`)
- Run entry point → Bounds comparison plot: plots (evidence: `run.py`)
- Run entry point → Bound residual plots: plots (evidence: `run.py`)
- Run entry point → Eigenfunction plots: plots (evidence: `run.py`)
- Adaptive continuation → BVP solver: solves steps (evidence: `continuation.py`)
- BVP solver → Radial ODE: uses (evidence: `solver.py`)
- BVP solver → Math utilities: estimates with (evidence: `solver.py`)
- Radial ODE → Math utilities: computes with (evidence: `ode_system.py`)
- Eigenvalue bounds → Math utilities: computes with (evidence: `bounds.py`)
- Adaptive continuation → Computed histories: writes (evidence: `continuation.py`)
- Bounds comparison plot → Computed histories: reads (evidence: `plotting.py`)
- Bound residual plots → Computed histories: reads (evidence: `plotting.py`)
- Eigenfunction plots → Computed histories: reads (evidence: `plotting.py`)
- L1 convergence plot → Computed histories: reads (evidence: `plotting.py`)
- Bounds comparison plot → Eigenvalue bounds: evaluates (evidence: `plotting.py`)
- Bound residual plots → Eigenvalue bounds: evaluates (evidence: `plotting.py`)
- Bounds comparison plot → Asymptotic limit: shows (evidence: `plotting.py`)
- Eigenfunction plots → Limit eigenfunction: overlays (evidence: `plotting.py`)
- Limit eigenfunction → Math utilities: defined in (evidence: `math_utils.py`)
- L1 convergence plot → Eigenfunction plots: summarizes errors (evidence: `plotting.py`)
