# gkorzeno/rough-volatility-qmc-pricing-engine architecture

> Architecture diagram of the GitHub repository gkorzeno/rough-volatility-qmc-pricing-engine, 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/gkorzeno/rough-volatility-qmc-pricing-engine
- Repository: https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine

## Overview

This is a C++ quantitative-finance library for Monte Carlo/QMC option pricing, with a notable rough-volatility research and calibration suite. A typical rough-volatility workflow generates a model-implied volatility surface, calibrates model parameters to a target surface, then analyzes smiles, term structure, and estimator noise. The broader library also provides stochastic-process simulation, payoffs, pricing, Greeks, and trading strategies. The README gives only the product name; several subsystem relationships below are supported by source-index references, while unsampled implementation details are not asserted.

Main entry points: [`src/simulators/MultiAssetQMCSimulator.hpp`](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/simulators/MultiAssetQMCSimulator.hpp) (Multi-Asset QMC), [`src/roughvol/RoughVolDiagnostics.hpp`](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/RoughVolDiagnostics.hpp) (Model Diagnostics), [`src/roughvol/RoughBergomiModel.hpp`](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/RoughBergomiModel.hpp) (Rough Bergomi), [`src/roughvol/RoughVolatilityResearch.hpp`](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/RoughVolatilityResearch.hpp) (Research API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rough["Rough Volatility"]
  node_research_api["Research API"]
  node_rough_model["Rough Bergomi"]
  node_rough_calibrator["Model Calibrator"]
  node_rough_diagnostics["Model Diagnostics"]
  node_fractional["Fractional Processes"]
end

subgraph group_simulation["Simulation Foundations"]
  node_processes["Stochastic Processes"]
  node_correlated_gbm["Correlated GBM<br/>[CorrelatedGBM.hpp]"]
  node_integrators["SDE Integrators"]
  node_mc_simulator["Monte Carlo Simulators"]
  node_multiasset_qmc["Multi-Asset QMC"]
  node_sobol["Sobol Sequences<br/>[SobolSequence.hpp]"]
  node_brownian_bridge["Brownian Bridge<br/>[BrownianBridge.hpp]"]
end

subgraph group_pricing["Pricing and Risk"]
  node_payoffs["Option Payoffs"]
  node_pricing_engines["Pricing Engines<br/>[BlackScholes.hpp]"]
  node_barrier_pricing["Barrier Pricing<br/>[BarrierPricer.hpp]"]
  node_early_exercise["Early Exercise<br/>[AmericanPricer.hpp]"]
  node_greeks["Greeks Estimation"]
end

subgraph group_surfaces["Volatility Surfaces"]
  node_vol_surface["Volatility Surface<br/>[VolSurface.hpp]"]
  node_svi["SVI Fitting<br/>[SVI.hpp]"]
  node_local_vol["Local Volatility"]
end

subgraph group_strategies["Trading Strategies"]
  node_backtester["Strategy Backtester<br/>[BackTester.hpp]"]
  node_straddle["Straddle Strategy"]
  node_dispersion["Dispersion Strategy"]
  node_term_structure["Term Structure Strategy"]
end

node_research_api -->|"generates surfaces"| node_rough_model
node_research_api -->|"calibrates parameters"| node_rough_calibrator
node_research_api -->|"requests diagnostics"| node_rough_diagnostics
node_research_api -->|"samples paths"| node_fractional
node_rough_model -->|"samples QMC points"| node_sobol
node_rough_model -->|"builds surface"| node_vol_surface
node_rough_calibrator -->|"fits parameters"| node_rough_model
node_rough_calibrator -->|"uses SVI fit"| node_svi
node_rough_diagnostics -->|"studies calibration"| node_rough_calibrator
node_rough_diagnostics -->|"analyzes model"| node_rough_model
node_rough_diagnostics -->|"fits surfaces"| node_svi
node_rough_diagnostics -->|"reads surface"| node_vol_surface
node_correlated_gbm -->|"implements process"| node_processes
node_integrators -->|"evaluates dynamics"| node_processes
node_multiasset_qmc -->|"evolves paths"| node_correlated_gbm
node_multiasset_qmc -->|"draws points"| node_sobol
node_multiasset_qmc -->|"constructs paths"| node_brownian_bridge
node_multiasset_qmc -->|"uses integrator"| node_integrators
node_multiasset_qmc -->|"orders dimensions"| node_payoffs
node_pricing_engines -->|"uses sensitivities"| node_greeks
node_barrier_pricing -->|"evaluates payoff"| node_payoffs
node_barrier_pricing -->|"simulates asset"| node_processes
node_early_exercise -.->|"values exercise"| node_payoffs
node_local_vol -->|"reads surface"| node_vol_surface
node_local_vol -->|"uses SVI"| node_svi
node_term_structure -->|"analyzes surface"| node_vol_surface
node_term_structure -->|"uses SVI"| node_svi
node_straddle -.->|"backtests strategy"| node_backtester
node_dispersion -.->|"backtests strategy"| node_backtester

click node_research_api "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/RoughVolatilityResearch.hpp"
click node_rough_model "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/RoughBergomiModel.hpp"
click node_rough_calibrator "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/RoughBergomiCalibrator.hpp"
click node_rough_diagnostics "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/RoughVolDiagnostics.hpp"
click node_fractional "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/FractionalBrownianMotion.hpp"
click node_processes "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/stochasticProcess/StochasticProcess.hpp"
click node_correlated_gbm "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/stochasticProcess/CorrelatedGBM.hpp"
click node_integrators "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/integrators/MultiDimensionalEulerMaruyama.hpp"
click node_mc_simulator "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/simulators/MonteCarloSimulator.hpp"
click node_multiasset_qmc "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/simulators/MultiAssetQMCSimulator.hpp"
click node_sobol "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/core/SobolSequence.hpp"
click node_brownian_bridge "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/core/BrownianBridge.hpp"
click node_payoffs "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/payoffs/MultiAssetPayoff.hpp"
click node_pricing_engines "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/pricing/BlackScholes.hpp"
click node_barrier_pricing "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/pricing/BarrierPricer.hpp"
click node_early_exercise "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/pricing/lsmc/AmericanPricer.hpp"
click node_greeks "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/greeks/GreekEstimatorStudy.hpp"
click node_vol_surface "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/surface/VolSurface.hpp"
click node_svi "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/surface/SVI.hpp"
click node_local_vol "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/surface/LocalVolSurface.hpp"
click node_backtester "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/strategies/BackTester.hpp"
click node_straddle "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/strategies/DeltaHedgedStraddleStrategy.cpp"
click node_dispersion "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/strategies/dispersion/DispersionStrategy.cpp"
click node_term_structure "https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/strategies/termstructure/TermStructureStrategy.cpp"

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_research_api,node_rough_model,node_rough_calibrator,node_rough_diagnostics,node_fractional toneBlue
class node_processes,node_correlated_gbm,node_integrators,node_mc_simulator,node_multiasset_qmc,node_sobol,node_brownian_bridge toneAmber
class node_payoffs,node_pricing_engines,node_barrier_pricing,node_early_exercise,node_greeks toneMint
class node_vol_surface,node_svi,node_local_vol toneRose
class node_backtester,node_straddle,node_dispersion,node_term_structure toneIndigo
```

## Components

### Rough Volatility

- [Research API](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/RoughVolatilityResearch.hpp): `src/roughvol/RoughVolatilityResearch.hpp`
- [Rough Bergomi](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/RoughBergomiModel.hpp): `src/roughvol/RoughBergomiModel.hpp`
- [Model Calibrator](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/RoughBergomiCalibrator.hpp): `src/roughvol/RoughBergomiCalibrator.hpp`
- [Model Diagnostics](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/RoughVolDiagnostics.hpp): `src/roughvol/RoughVolDiagnostics.hpp`
- [Fractional Processes](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/roughvol/FractionalBrownianMotion.hpp): `src/roughvol/FractionalBrownianMotion.hpp`

### Simulation Foundations

- [Stochastic Processes](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/stochasticProcess/StochasticProcess.hpp): `src/stochasticProcess/StochasticProcess.hpp`
- [Correlated GBM](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/stochasticProcess/CorrelatedGBM.hpp): `src/stochasticProcess/CorrelatedGBM.hpp`
- [SDE Integrators](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/integrators/MultiDimensionalEulerMaruyama.hpp): `src/integrators/MultiDimensionalEulerMaruyama.hpp`
- [Monte Carlo Simulators](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/simulators/MonteCarloSimulator.hpp): `src/simulators/MonteCarloSimulator.hpp`
- [Multi-Asset QMC](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/simulators/MultiAssetQMCSimulator.hpp): `src/simulators/MultiAssetQMCSimulator.hpp`
- [Sobol Sequences](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/core/SobolSequence.hpp): `src/core/SobolSequence.hpp`
- [Brownian Bridge](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/core/BrownianBridge.hpp): `src/core/BrownianBridge.hpp`

### Pricing and Risk

- [Option Payoffs](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/payoffs/MultiAssetPayoff.hpp): `src/payoffs/MultiAssetPayoff.hpp`
- [Pricing Engines](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/pricing/BlackScholes.hpp): `src/pricing/BlackScholes.hpp`
- [Barrier Pricing](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/pricing/BarrierPricer.hpp): `src/pricing/BarrierPricer.hpp`
- [Early Exercise](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/pricing/lsmc/AmericanPricer.hpp): `src/pricing/lsmc/AmericanPricer.hpp`
- [Greeks Estimation](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/greeks/GreekEstimatorStudy.hpp): `src/greeks/GreekEstimatorStudy.hpp`

### Volatility Surfaces

- [Volatility Surface](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/surface/VolSurface.hpp): `src/surface/VolSurface.hpp`
- [SVI Fitting](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/surface/SVI.hpp): `src/surface/SVI.hpp`
- [Local Volatility](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/surface/LocalVolSurface.hpp): `src/surface/LocalVolSurface.hpp`

### Trading Strategies

- [Strategy Backtester](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/strategies/BackTester.hpp): `src/strategies/BackTester.hpp`
- [Straddle Strategy](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/strategies/DeltaHedgedStraddleStrategy.cpp): `src/strategies/DeltaHedgedStraddleStrategy.cpp`
- [Dispersion Strategy](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/strategies/dispersion/DispersionStrategy.cpp): `src/strategies/dispersion/DispersionStrategy.cpp`
- [Term Structure Strategy](https://github.com/gkorzeno/rough-volatility-qmc-pricing-engine/blob/main/src/strategies/termstructure/TermStructureStrategy.cpp): `src/strategies/termstructure/TermStructureStrategy.cpp`

## Connections

- Research API → Rough Bergomi: generates surfaces (evidence: `src/roughvol/RoughVolatilityResearch.hpp`)
- Research API → Model Calibrator: calibrates parameters (evidence: `src/roughvol/RoughVolatilityResearch.hpp`)
- Research API → Model Diagnostics: requests diagnostics (evidence: `src/roughvol/RoughVolatilityResearch.hpp`)
- Research API → Fractional Processes: samples paths (evidence: `src/roughvol/RoughVolatilityResearch.hpp`)
- Rough Bergomi → Sobol Sequences: samples QMC points (evidence: `src/roughvol/RoughBergomiModel.hpp`)
- Rough Bergomi → Volatility Surface: builds surface (evidence: `src/roughvol/RoughBergomiModel.hpp`)
- Model Calibrator → Rough Bergomi: fits parameters (evidence: `src/roughvol/RoughBergomiCalibrator.hpp`)
- Model Calibrator → SVI Fitting: uses SVI fit (evidence: `src/roughvol/RoughBergomiCalibrator.hpp`)
- Model Diagnostics → Model Calibrator: studies calibration (evidence: `src/roughvol/RoughVolDiagnostics.hpp`)
- Model Diagnostics → Rough Bergomi: analyzes model (evidence: `src/roughvol/RoughVolDiagnostics.hpp`)
- Model Diagnostics → SVI Fitting: fits surfaces (evidence: `src/roughvol/RoughVolDiagnostics.hpp`)
- Model Diagnostics → Volatility Surface: reads surface (evidence: `src/roughvol/RoughVolDiagnostics.hpp`)
- Correlated GBM → Stochastic Processes: implements process (evidence: `src/stochasticProcess/CorrelatedGBM.hpp`)
- SDE Integrators → Stochastic Processes: evaluates dynamics (evidence: `src/integrators/MultiDimensionalEulerMaruyama.hpp`)
- Multi-Asset QMC → Correlated GBM: evolves paths (evidence: `src/simulators/MultiAssetQMCSimulator.hpp`)
- Multi-Asset QMC → Sobol Sequences: draws points (evidence: `src/simulators/MultiAssetQMCSimulator.hpp`)
- Multi-Asset QMC → Brownian Bridge: constructs paths (evidence: `src/simulators/MultiAssetQMCSimulator.hpp`)
- Multi-Asset QMC → SDE Integrators: uses integrator (evidence: `src/simulators/MultiAssetQMCSimulator.hpp`)
- Multi-Asset QMC → Option Payoffs: orders dimensions (evidence: `src/simulators/MultiAssetQMCSimulator.hpp`)
- Pricing Engines → Greeks Estimation: uses sensitivities (evidence: `src/pricing/BlackScholes.hpp`)
- Barrier Pricing → Option Payoffs: evaluates payoff (evidence: `src/pricing/BarrierPricer.hpp`)
- Barrier Pricing → Stochastic Processes: simulates asset (evidence: `src/pricing/BarrierPricer.hpp`)
- Early Exercise → Option Payoffs: values exercise
- Local Volatility → Volatility Surface: reads surface (evidence: `src/surface/LocalVolSurface.hpp`)
- Local Volatility → SVI Fitting: uses SVI (evidence: `src/surface/LocalVolSurface.hpp`)
- Term Structure Strategy → Volatility Surface: analyzes surface
- Term Structure Strategy → SVI Fitting: uses SVI
- Straddle Strategy → Strategy Backtester: backtests strategy
- Dispersion Strategy → Strategy Backtester: backtests strategy
