# anthonymakarewicz/option-pricer architecture

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

- Interactive diagram: https://gitdiagram.com/anthonymakarewicz/option-pricer
- Repository: https://github.com/anthonymakarewicz/option-pricer

## Overview

Option Pricing Library is a C++ library for defining financial options and calculating their prices, principally through Monte Carlo simulation and finite-difference methods. The user workflow initializes market data, creates an option through a factory, selects a model and pricing method, and obtains a price. Its other documented capabilities include multiple stochastic models, pseudo- and quasi-random generation, tree pricing, and numerical-analysis tools. The graph combines sampled call relationships with README-documented capabilities; several solver and option-family details are unsampled, so their internal links are omitted where evidence is unavailable.

Main entry points: [`src/solver/monte_carlo/mc_american.cpp`](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/monte_carlo/mc_american.cpp) (Monte Carlo Pricers), [`include/option/base_factory_option.h`](https://github.com/anthonymakarewicz/option-pricer/blob/main/include/option/base_factory_option.h) (Option Factories), [`src/model/bates_model.cpp`](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/model/bates_model.cpp) (Stock Models), [`src/solver/finite_difference_method/solver/one_factor/crank_nicolson_fdm_solver.cpp`](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/finite_difference_method/solver/one_factor/crank_nicolson_fdm_solver.cpp) (Finite Difference Solvers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_market["Market Data"]
  node_marketdata[("Market Data<br/>[market_data.cpp]")]
  node_stockdata[("Stock Data<br/>[stock_data.cpp]")]
end

subgraph group_contracts["Options and Payoffs"]
  node_optionfactory["Option Factories"]
  node_optiontypes["Option Types<br/>[barrier_option.cpp]"]
  node_parameters["Option Parameters"]
  node_payoffs["Payoff Functions<br/>[payoff_vanilla.cpp]"]
end

subgraph group_simulation["Models and Randomness"]
  node_models["Stock Models<br/>[bates_model.cpp]"]
  node_cir["CIR Discretization"]
  node_generators["Random Generators"]
  node_distributions["Distributions"]
end

subgraph group_pricing["Pricing Solvers"]
  node_mcbuilders["MC Builders"]
  node_mcpricers["Monte Carlo Pricers<br/>[mc_american.cpp]"]
  node_mcsolver["MC Solver<br/>[mc_solver.cpp]"]
  node_pde["Pricing PDEs"]
  node_fdm["Finite Difference Solvers"]
  node_tree["Binomial Tree<br/>[binomial_tree.cpp]"]
end

subgraph group_numerics["Numerical Analysis"]
  node_basis["Basis Functions<br/>[laguerre.cpp]"]
  node_regression["Regression<br/>[least_squares.cpp]"]
  node_interpolation["Interpolation"]
  node_linearalgebra["Matrix Solvers"]
end

node_user(("Library User"))

node_user -->|"initializes"| node_marketdata
node_user -->|"creates option"| node_optionfactory
node_optionfactory -->|"gets singleton"| node_marketdata
node_optionfactory -.->|"creates"| node_optiontypes
node_optionfactory -.->|"creates payoff"| node_payoffs
node_optionfactory -->|"reads"| node_parameters
node_marketdata -->|"updates and reads"| node_stockdata
node_user -->|"configures"| node_mcbuilders
node_mcbuilders -->|"builds"| node_mcpricers
node_mcpricers -->|"simulates paths"| node_models
node_mcpricers -->|"evaluates payoff"| node_optiontypes
node_mcpricers -->|"generates basis"| node_basis
node_mcpricers -->|"fits continuation"| node_regression
node_mcsolver -.->|"solves with"| node_mcpricers
node_models -->|"reads inputs"| node_marketdata
node_models -->|"draws variates"| node_generators
node_models -->|"samples"| node_distributions
node_models -->|"updates variance"| node_cir
node_user -->|"selects scheme"| node_fdm
node_fdm -.->|"solves PDE"| node_pde
node_fdm -.->|"uses interpolation"| node_interpolation
node_fdm -.->|"uses matrix solver"| node_linearalgebra
node_user -.->|"may price with"| node_tree
node_user -->|"selects sequence"| node_generators

click node_marketdata "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/market_data/market_data.cpp"
click node_stockdata "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/market_data/stock_data.cpp"
click node_optionfactory "https://github.com/anthonymakarewicz/option-pricer/blob/main/include/option/base_factory_option.h"
click node_optiontypes "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/option/path_dependent/barrier_option.cpp"
click node_parameters "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/option/parameter_object.cpp"
click node_payoffs "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/payoff/single_strike/payoff_vanilla.cpp"
click node_models "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/model/bates_model.cpp"
click node_cir "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/model/discretization/explicit_euler_cir_discretization.cpp"
click node_generators "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/random/number_generator/sobol_quasi_random_generator.cpp"
click node_distributions "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/random/distribution/standard_normal_distribution.cpp"
click node_mcbuilders "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/monte_carlo/builder/mc_builder_american.cpp"
click node_mcpricers "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/monte_carlo/mc_american.cpp"
click node_mcsolver "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/monte_carlo/mc_solver.cpp"
click node_pde "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/finite_difference_method/pde/one_factor/black_scholes_pde.cpp"
click node_fdm "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/finite_difference_method/solver/one_factor/crank_nicolson_fdm_solver.cpp"
click node_tree "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/tree/binomial_tree.cpp"
click node_basis "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/numerical_analysis/basis_function/laguerre.cpp"
click node_regression "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/numerical_analysis/regression/least_squares.cpp"
click node_interpolation "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/numerical_analysis/interpolation/quadratic_interpolation.cpp"
click node_linearalgebra "https://github.com/anthonymakarewicz/option-pricer/blob/main/src/numerical_analysis/linear_algebra/matrix_solver/thomas_algorithm.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_marketdata,node_stockdata,node_user toneBlue
class node_optionfactory,node_optiontypes,node_parameters,node_payoffs toneAmber
class node_models,node_cir,node_generators,node_distributions toneMint
class node_mcbuilders,node_mcpricers,node_mcsolver,node_pde,node_fdm,node_tree toneRose
class node_basis,node_regression,node_interpolation,node_linearalgebra toneIndigo
```

## Components

### Market Data

- [Market Data](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/market_data/market_data.cpp): `src/market_data/market_data.cpp`
- [Stock Data](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/market_data/stock_data.cpp): `src/market_data/stock_data.cpp`

### Options and Payoffs

- [Option Factories](https://github.com/anthonymakarewicz/option-pricer/blob/main/include/option/base_factory_option.h): `include/option/base_factory_option.h`
- [Option Types](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/option/path_dependent/barrier_option.cpp): `src/option/path_dependent/barrier_option.cpp`
- [Option Parameters](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/option/parameter_object.cpp): `src/option/parameter_object.cpp`
- [Payoff Functions](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/payoff/single_strike/payoff_vanilla.cpp): `src/payoff/single_strike/payoff_vanilla.cpp`

### Models and Randomness

- [Stock Models](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/model/bates_model.cpp): `src/model/bates_model.cpp`
- [CIR Discretization](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/model/discretization/explicit_euler_cir_discretization.cpp): `src/model/discretization/explicit_euler_cir_discretization.cpp`
- [Random Generators](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/random/number_generator/sobol_quasi_random_generator.cpp): `src/random/number_generator/sobol_quasi_random_generator.cpp`
- [Distributions](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/random/distribution/standard_normal_distribution.cpp): `src/random/distribution/standard_normal_distribution.cpp`

### Pricing Solvers

- [MC Builders](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/monte_carlo/builder/mc_builder_american.cpp): `src/solver/monte_carlo/builder/mc_builder_american.cpp`
- [Monte Carlo Pricers](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/monte_carlo/mc_american.cpp): `src/solver/monte_carlo/mc_american.cpp`
- [MC Solver](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/monte_carlo/mc_solver.cpp): `src/solver/monte_carlo/mc_solver.cpp`
- [Pricing PDEs](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/finite_difference_method/pde/one_factor/black_scholes_pde.cpp): `src/solver/finite_difference_method/pde/one_factor/black_scholes_pde.cpp`
- [Finite Difference Solvers](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/finite_difference_method/solver/one_factor/crank_nicolson_fdm_solver.cpp): `src/solver/finite_difference_method/solver/one_factor/crank_nicolson_fdm_solver.cpp`
- [Binomial Tree](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/solver/tree/binomial_tree.cpp): `src/solver/tree/binomial_tree.cpp`

### Numerical Analysis

- [Basis Functions](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/numerical_analysis/basis_function/laguerre.cpp): `src/numerical_analysis/basis_function/laguerre.cpp`
- [Regression](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/numerical_analysis/regression/least_squares.cpp): `src/numerical_analysis/regression/least_squares.cpp`
- [Interpolation](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/numerical_analysis/interpolation/quadratic_interpolation.cpp): `src/numerical_analysis/interpolation/quadratic_interpolation.cpp`
- [Matrix Solvers](https://github.com/anthonymakarewicz/option-pricer/blob/main/src/numerical_analysis/linear_algebra/matrix_solver/thomas_algorithm.cpp): `src/numerical_analysis/linear_algebra/matrix_solver/thomas_algorithm.cpp`

### Other components

- **Library User**

## Connections

- Library User → Market Data: initializes (evidence: `README.md`)
- Library User → Option Factories: creates option (evidence: `README.md`)
- Option Factories → Market Data: gets singleton (evidence: `include/option/base_factory_option.h`)
- Option Factories → Option Types: creates
- Option Factories → Payoff Functions: creates payoff
- Option Factories → Option Parameters: reads (evidence: `include/option/base_factory_option.h`)
- Market Data → Stock Data: updates and reads (evidence: `src/market_data/market_data.cpp`)
- Library User → MC Builders: configures
- MC Builders → Monte Carlo Pricers: builds (evidence: `README.md`)
- Monte Carlo Pricers → Stock Models: simulates paths (evidence: `src/solver/monte_carlo/mc_american.cpp`)
- Monte Carlo Pricers → Option Types: evaluates payoff (evidence: `src/solver/monte_carlo/mc_american.cpp`)
- Monte Carlo Pricers → Basis Functions: generates basis (evidence: `src/solver/monte_carlo/mc_american.cpp`)
- Monte Carlo Pricers → Regression: fits continuation (evidence: `src/solver/monte_carlo/mc_american.cpp`)
- MC Solver → Monte Carlo Pricers: solves with
- Stock Models → Market Data: reads inputs (evidence: `src/model/bates_model.cpp`)
- Stock Models → Random Generators: draws variates (evidence: `src/model/bates_model.cpp`)
- Stock Models → Distributions: samples (evidence: `src/model/bates_model.cpp`)
- Stock Models → CIR Discretization: updates variance (evidence: `src/model/bates_model.cpp`)
- Library User → Finite Difference Solvers: selects scheme (evidence: `README.md`)
- Finite Difference Solvers → Pricing PDEs: solves PDE
- Finite Difference Solvers → Interpolation: uses interpolation
- Finite Difference Solvers → Matrix Solvers: uses matrix solver
- Library User → Binomial Tree: may price with
- Library User → Random Generators: selects sequence (evidence: `README.md`)
