# hassanelq/simulations-montecarlo architecture

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

- Interactive diagram: https://gitdiagram.com/hassanelq/simulations-montecarlo
- Repository: https://github.com/hassanelq/simulations-montecarlo

## Overview

This is a browser-computed financial simulation platform: users choose a simulation, enter model parameters, run local JavaScript calculations, and inspect metrics and charts. Its main domain branches cover probability distributions, investment growth, option valuation, and Brownian-motion processes; a combined Monte Carlo page also offers risk analysis. Results are rendered through chart components, with no persistent store or external computation service shown. Some probability and risk implementations were not excerpted, so their subsystem nodes are represented by exact existing directories and uncertain links are omitted.

Main entry points: [`app/start/monteCarlo/page.jsx`](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/monteCarlo/page.jsx) (Monte Carlo Hub), [`app/start/investment/page.jsx`](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/investment/page.jsx) (Investment Planner), [`app/start/probability/page.jsx`](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/probability/page.jsx) (Distribution Explorer), [`app/start/options/page.jsx`](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/options/page.jsx) (Options Pricer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web Experience"]
  node_home["Home Page<br/>[page.js]"]
  node_start["Simulation Menu<br/>[page.jsx]"]
  node_layout["App Shell<br/>[layout.js]"]
end

subgraph group_probability["Probability Models"]
  node_probpage["Distribution Explorer<br/>[page.jsx]"]
  node_probmodels["Distribution Samplers"]
  node_probhelpers["Sample Statistics"]
  node_probchart["Distribution Chart"]
end

subgraph group_montecarlo["Monte Carlo Finance"]
  node_investpage["Investment Planner<br/>[page.jsx]"]
  node_investmodel["Investment Simulation<br/>[investment.js]"]
  node_optionspage["Options Pricer<br/>[page.jsx]"]
  node_optionsmodel["Options Simulation<br/>[options.js]"]
  node_mcpages["Monte Carlo Hub<br/>[page.jsx]"]
  node_riskmodel["Risk Simulation<br/>[risk.js]"]
  node_linechart["Path Chart<br/>[MCLineChart.jsx]"]
  node_barchart["Outcome Chart<br/>[MCBarChart.jsx]"]
end

subgraph group_stochastic["Stochastic Processes"]
  node_brownpage["Brownian Explorer<br/>[page.jsx]"]
  node_brownmodels["Brownian Models"]
end

node_user(("Learner"))

node_user -->|"opens"| node_home
node_home -.->|"links to"| node_start
node_layout -->|"renders page"| node_home
node_layout -->|"renders page"| node_start
node_user -.->|"selects model"| node_probpage
node_probpage -->|"loads sampler"| node_probmodels
node_probpage -->|"renders results"| node_probchart
node_probmodels -->|"uses statistics"| node_probhelpers
node_user -.->|"sets parameters"| node_investpage
node_investpage -->|"runs simulation"| node_investmodel
node_investpage -->|"renders paths"| node_linechart
node_investpage -->|"renders outcomes"| node_barchart
node_user -.->|"sets parameters"| node_optionspage
node_optionspage -->|"prices options"| node_optionsmodel
node_optionspage -->|"renders paths"| node_linechart
node_user -.->|"chooses analysis"| node_mcpages
node_mcpages -->|"runs investment"| node_investmodel
node_mcpages -->|"runs options"| node_optionsmodel
node_mcpages -->|"runs risk"| node_riskmodel
node_mcpages -->|"renders paths"| node_linechart
node_mcpages -->|"renders outcomes"| node_barchart
node_user -.->|"chooses process"| node_brownpage
node_brownpage -->|"runs selected model"| node_brownmodels

click node_home "https://github.com/hassanelq/simulations-montecarlo/blob/main/app/page.js"
click node_start "https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/page.jsx"
click node_layout "https://github.com/hassanelq/simulations-montecarlo/blob/main/app/layout.js"
click node_probpage "https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/probability/page.jsx"
click node_probmodels "https://github.com/hassanelq/simulations-montecarlo/tree/main/utils/probability"
click node_probhelpers "https://github.com/hassanelq/simulations-montecarlo/blob/main/utils/probability/helper_functions.js"
click node_probchart "https://github.com/hassanelq/simulations-montecarlo/blob/main/app/Components/Charts/ProbabilityBarChart.jsx"
click node_investpage "https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/investment/page.jsx"
click node_investmodel "https://github.com/hassanelq/simulations-montecarlo/blob/main/utils/monteCarlo/investment.js"
click node_optionspage "https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/options/page.jsx"
click node_optionsmodel "https://github.com/hassanelq/simulations-montecarlo/blob/main/utils/monteCarlo/options.js"
click node_mcpages "https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/monteCarlo/page.jsx"
click node_riskmodel "https://github.com/hassanelq/simulations-montecarlo/blob/main/utils/monteCarlo/risk.js"
click node_linechart "https://github.com/hassanelq/simulations-montecarlo/blob/main/app/Components/Charts/MCLineChart.jsx"
click node_barchart "https://github.com/hassanelq/simulations-montecarlo/blob/main/app/Components/Charts/MCBarChart.jsx"
click node_brownpage "https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/brownianMotion/page.jsx"
click node_brownmodels "https://github.com/hassanelq/simulations-montecarlo/tree/main/utils/brownianMotion"

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_home,node_start,node_layout toneBlue
class node_probpage,node_probmodels,node_probhelpers,node_probchart toneAmber
class node_investpage,node_investmodel,node_optionspage,node_optionsmodel,node_mcpages,node_riskmodel,node_linechart,node_barchart toneMint
class node_brownpage,node_brownmodels toneRose
class node_user toneIndigo
```

## Components

### Web Experience

- [Home Page](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/page.js): `app/page.js`
- [Simulation Menu](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/page.jsx): `app/start/page.jsx`
- [App Shell](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/layout.js): `app/layout.js`

### Probability Models

- [Distribution Explorer](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/probability/page.jsx): `app/start/probability/page.jsx`
- [Distribution Samplers](https://github.com/hassanelq/simulations-montecarlo/tree/main/utils/probability): `utils/probability`
- [Sample Statistics](https://github.com/hassanelq/simulations-montecarlo/blob/main/utils/probability/helper_functions.js): `utils/probability/helper_functions.js`
- [Distribution Chart](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/Components/Charts/ProbabilityBarChart.jsx): `app/Components/Charts/ProbabilityBarChart.jsx`

### Monte Carlo Finance

- [Investment Planner](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/investment/page.jsx): `app/start/investment/page.jsx`
- [Investment Simulation](https://github.com/hassanelq/simulations-montecarlo/blob/main/utils/monteCarlo/investment.js): `utils/monteCarlo/investment.js`
- [Options Pricer](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/options/page.jsx): `app/start/options/page.jsx`
- [Options Simulation](https://github.com/hassanelq/simulations-montecarlo/blob/main/utils/monteCarlo/options.js): `utils/monteCarlo/options.js`
- [Monte Carlo Hub](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/monteCarlo/page.jsx): `app/start/monteCarlo/page.jsx`
- [Risk Simulation](https://github.com/hassanelq/simulations-montecarlo/blob/main/utils/monteCarlo/risk.js): `utils/monteCarlo/risk.js`
- [Path Chart](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/Components/Charts/MCLineChart.jsx): `app/Components/Charts/MCLineChart.jsx`
- [Outcome Chart](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/Components/Charts/MCBarChart.jsx): `app/Components/Charts/MCBarChart.jsx`

### Stochastic Processes

- [Brownian Explorer](https://github.com/hassanelq/simulations-montecarlo/blob/main/app/start/brownianMotion/page.jsx): `app/start/brownianMotion/page.jsx`
- [Brownian Models](https://github.com/hassanelq/simulations-montecarlo/tree/main/utils/brownianMotion): `utils/brownianMotion`

### Other components

- **Learner**

## Connections

- Learner → Home Page: opens (evidence: `app/page.js`)
- Home Page → Simulation Menu: links to
- App Shell → Home Page: renders page (evidence: `app/layout.js`)
- App Shell → Simulation Menu: renders page (evidence: `app/layout.js`)
- Learner → Distribution Explorer: selects model
- Distribution Explorer → Distribution Samplers: loads sampler (evidence: `app/start/probability/page.jsx`)
- Distribution Explorer → Distribution Chart: renders results (evidence: `app/start/probability/page.jsx`)
- Distribution Samplers → Sample Statistics: uses statistics (evidence: `utils/probability/beta.js`)
- Learner → Investment Planner: sets parameters
- Investment Planner → Investment Simulation: runs simulation (evidence: `app/start/investment/page.jsx`)
- Investment Planner → Path Chart: renders paths (evidence: `app/start/investment/page.jsx`)
- Investment Planner → Outcome Chart: renders outcomes (evidence: `app/start/investment/page.jsx`)
- Learner → Options Pricer: sets parameters
- Options Pricer → Options Simulation: prices options (evidence: `app/start/options/page.jsx`)
- Options Pricer → Path Chart: renders paths (evidence: `app/start/options/page.jsx`)
- Learner → Monte Carlo Hub: chooses analysis
- Monte Carlo Hub → Investment Simulation: runs investment (evidence: `app/start/monteCarlo/page.jsx`)
- Monte Carlo Hub → Options Simulation: runs options (evidence: `app/start/monteCarlo/page.jsx`)
- Monte Carlo Hub → Risk Simulation: runs risk (evidence: `app/start/monteCarlo/page.jsx`)
- Monte Carlo Hub → Path Chart: renders paths (evidence: `app/start/monteCarlo/page.jsx`)
- Monte Carlo Hub → Outcome Chart: renders outcomes (evidence: `app/start/monteCarlo/page.jsx`)
- Learner → Brownian Explorer: chooses process
- Brownian Explorer → Brownian Models: runs selected model (evidence: `app/start/brownianMotion/page.jsx`)
