# jronayne/pytransport architecture

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

- Interactive diagram: https://gitdiagram.com/jronayne/pytransport
- Repository: https://github.com/jronayne/pytransport

## Overview

PyTransport is a Python/C++ toolkit for calculating inflationary perturbation power spectra and bispectra in canonical and non-canonical multi-field models. A user defines a model, generates and compiles a model-specific Python module, then uses its evolution functions and Python analysis scripts to compute results. The C++ layer evolves background and perturbation moments using model physics and a Runge–Kutta integrator. README capabilities include MPI distribution, configurable tolerances and evolution endpoints, and plotting; those branches are shown where documented. Some connections are documented only at product level because their source was not sampled.

Main entry points: [`PyTransport/PyTrans/PyTrans.cpp`](https://github.com/jronayne/pytransport/blob/master/PyTransport/PyTrans/PyTrans.cpp) (Python module API), [`PyTransport/CppTrans/evolve.h`](https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/evolve.h) (Canonical evolution), [`PyTransport/CppTrans/NC/evolve.h`](https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/NC/evolve.h) (Noncanonical evolution), [`PyTransport/PyTransScripts.py`](https://github.com/jronayne/pytransport/blob/master/PyTransport/PyTransScripts.py) (Spectrum analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_model_setup["Model setup"]
  node_model_definition["Model definition"]
  node_setup_generator["Module generator<br/>[PyTransSetup.py]"]
  node_python_module["Python module API<br/>[PyTrans.cpp]"]
end

subgraph group_physics["Physics kernels"]
  node_canonical_model["Canonical model<br/>[model.h]"]
  node_nc_model["Noncanonical model<br/>[model.h]"]
  node_potential["Potential physics<br/>[potential.h]"]
  node_field_metric["Field geometry<br/>[fieldmetric.h]"]
end

subgraph group_evolution["Evolution"]
  node_canonical_evolution["Canonical evolution<br/>[evolve.h]"]
  node_nc_evolution["Noncanonical evolution<br/>[evolve.h]"]
  node_canonical_moments["Canonical moments<br/>[moments.h]"]
  node_nc_moments["Noncanonical moments<br/>[moments.h]"]
  node_rk_integrator["RKF45 integrator<br/>[rkf45.cpp]"]
  node_rk_interface["Integrator interface<br/>[rkf45.hpp]"]
end

subgraph group_analysis["Analysis"]
  node_analysis_scripts["Spectrum analysis<br/>[PyTransScripts.py]"]
  node_mpi["MPI computing<br/>[PyTransScripts.py]"]
  node_plots["Scientific plots<br/>[Plots.py]"]
  node_results["Power and bispectra"]
end

node_user(("Researcher"))
node_compiler["C++ compiler"]

node_user -->|"defines model"| node_model_definition
node_model_definition -->|"configures"| node_setup_generator
node_setup_generator -->|"generates wrapper"| node_python_module
node_setup_generator -->|"compiles module"| node_compiler
node_user -->|"imports module"| node_python_module
node_python_module -.->|"dispatches evolution"| node_canonical_evolution
node_python_module -.->|"dispatches evolution"| node_nc_evolution
node_canonical_evolution -->|"evaluates dynamics"| node_canonical_model
node_canonical_evolution -->|"evolves moments"| node_canonical_moments
node_nc_evolution -->|"evaluates dynamics"| node_nc_model
node_nc_evolution -->|"evolves moments"| node_nc_moments
node_canonical_model -->|"evaluates potential"| node_potential
node_nc_model -->|"evaluates potential"| node_potential
node_nc_model -->|"uses geometry"| node_field_metric
node_canonical_moments -->|"computes moments"| node_canonical_model
node_nc_moments -->|"computes moments"| node_nc_model
node_canonical_evolution -.->|"integrates states"| node_rk_integrator
node_nc_evolution -.->|"integrates states"| node_rk_integrator
node_rk_integrator -->|"implements interface"| node_rk_interface
node_user -->|"requests spectra"| node_analysis_scripts
node_analysis_scripts -->|"calls evolution API"| node_python_module
node_analysis_scripts -->|"distributes work"| node_mpi
node_analysis_scripts -->|"computes spectra"| node_results
node_user -.->|"plots results"| node_plots
node_plots -.->|"visualizes spectra"| node_results

click node_setup_generator "https://github.com/jronayne/pytransport/blob/master/PyTransport/PyTransSetup.py"
click node_python_module "https://github.com/jronayne/pytransport/blob/master/PyTransport/PyTrans/PyTrans.cpp"
click node_canonical_evolution "https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/evolve.h"
click node_nc_evolution "https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/NC/evolve.h"
click node_canonical_model "https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/model.h"
click node_nc_model "https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/NC/model.h"
click node_potential "https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/potential.h"
click node_field_metric "https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/fieldmetric.h"
click node_canonical_moments "https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/moments.h"
click node_nc_moments "https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/NC/moments.h"
click node_rk_integrator "https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/stepper/rkf45.cpp"
click node_rk_interface "https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/stepper/rkf45.hpp"
click node_analysis_scripts "https://github.com/jronayne/pytransport/blob/master/PyTransport/PyTransScripts.py"
click node_mpi "https://github.com/jronayne/pytransport/blob/master/PyTransport/PyTransScripts.py"
click node_plots "https://github.com/jronayne/pytransport/blob/master/Examples/DoubleQuad/Plots.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_model_definition,node_setup_generator,node_python_module toneBlue
class node_canonical_model,node_nc_model,node_potential,node_field_metric toneAmber
class node_canonical_evolution,node_nc_evolution,node_canonical_moments,node_nc_moments,node_rk_integrator,node_rk_interface toneMint
class node_analysis_scripts,node_mpi,node_plots,node_results toneRose
class node_user,node_compiler toneIndigo
```

## Components

### Model setup

- **Model definition**
- [Module generator](https://github.com/jronayne/pytransport/blob/master/PyTransport/PyTransSetup.py): `PyTransport/PyTransSetup.py`
- [Python module API](https://github.com/jronayne/pytransport/blob/master/PyTransport/PyTrans/PyTrans.cpp): `PyTransport/PyTrans/PyTrans.cpp`

### Physics kernels

- [Canonical model](https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/model.h): `PyTransport/CppTrans/model.h`
- [Noncanonical model](https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/NC/model.h): `PyTransport/CppTrans/NC/model.h`
- [Potential physics](https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/potential.h): `PyTransport/CppTrans/potential.h`
- [Field geometry](https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/fieldmetric.h): `PyTransport/CppTrans/fieldmetric.h`

### Evolution

- [Canonical evolution](https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/evolve.h): `PyTransport/CppTrans/evolve.h`
- [Noncanonical evolution](https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/NC/evolve.h): `PyTransport/CppTrans/NC/evolve.h`
- [Canonical moments](https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/moments.h): `PyTransport/CppTrans/moments.h`
- [Noncanonical moments](https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/NC/moments.h): `PyTransport/CppTrans/NC/moments.h`
- [RKF45 integrator](https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/stepper/rkf45.cpp): `PyTransport/CppTrans/stepper/rkf45.cpp`
- [Integrator interface](https://github.com/jronayne/pytransport/blob/master/PyTransport/CppTrans/stepper/rkf45.hpp): `PyTransport/CppTrans/stepper/rkf45.hpp`

### Analysis

- [Spectrum analysis](https://github.com/jronayne/pytransport/blob/master/PyTransport/PyTransScripts.py): `PyTransport/PyTransScripts.py`
- [MPI computing](https://github.com/jronayne/pytransport/blob/master/PyTransport/PyTransScripts.py): `PyTransport/PyTransScripts.py`
- [Scientific plots](https://github.com/jronayne/pytransport/blob/master/Examples/DoubleQuad/Plots.py): `Examples/DoubleQuad/Plots.py`
- **Power and bispectra**

### Other components

- **Researcher**
- **C++ compiler**

## Connections

- Researcher → Model definition: defines model (evidence: `README.md`)
- Model definition → Module generator: configures (evidence: `README.md`)
- Module generator → Python module API: generates wrapper
- Module generator → C++ compiler: compiles module (evidence: `README.md`)
- Researcher → Python module API: imports module (evidence: `README.md`)
- Python module API → Canonical evolution: dispatches evolution
- Python module API → Noncanonical evolution: dispatches evolution
- Canonical evolution → Canonical model: evaluates dynamics (evidence: `PyTransport/CppTrans/evolve.h`)
- Canonical evolution → Canonical moments: evolves moments (evidence: `PyTransport/CppTrans/evolve.h`)
- Noncanonical evolution → Noncanonical model: evaluates dynamics (evidence: `PyTransport/CppTrans/NC/evolve.h`)
- Noncanonical evolution → Noncanonical moments: evolves moments (evidence: `PyTransport/CppTrans/NC/evolve.h`)
- Canonical model → Potential physics: evaluates potential (evidence: `PyTransport/CppTrans/model.h`)
- Noncanonical model → Potential physics: evaluates potential (evidence: `PyTransport/CppTrans/NC/model.h`)
- Noncanonical model → Field geometry: uses geometry (evidence: `PyTransport/CppTrans/NC/model.h`)
- Canonical moments → Canonical model: computes moments (evidence: `PyTransport/CppTrans/moments.h`)
- Noncanonical moments → Noncanonical model: computes moments (evidence: `PyTransport/CppTrans/NC/moments.h`)
- Canonical evolution → RKF45 integrator: integrates states
- Noncanonical evolution → RKF45 integrator: integrates states
- RKF45 integrator → Integrator interface: implements interface (evidence: `PyTransport/CppTrans/stepper/rkf45.cpp`)
- Researcher → Spectrum analysis: requests spectra
- Spectrum analysis → Python module API: calls evolution API
- Spectrum analysis → MPI computing: distributes work (evidence: `PyTransport/PyTransScripts.py`)
- Spectrum analysis → Power and bispectra: computes spectra (evidence: `PyTransport/PyTransScripts.py`)
- Researcher → Scientific plots: plots results
- Scientific plots → Power and bispectra: visualizes spectra
