# nihal-prakash/statisticalarbitrage-c-backtester architecture

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

- Interactive diagram: https://gitdiagram.com/nihal-prakash/statisticalarbitrage-c-backtester
- Repository: https://github.com/nihal-prakash/statisticalarbitrage-c-backtester

## Overview

This repository combines market-data acquisition, statistical-arbitrage research, and an early C++ backtester. The main workflow downloads intraday Yahoo or historical NSE data into CSVs, then runs correlation or pair analysis to produce research outputs. Python also contains a separate strategy interface, SMA-cross implementation, data loader, and performance metrics; the sampled C++ executable currently only prints a banner. README-described capabilities are included, but unsampled implementation details and runtime links are not inferred.

Main entry points: [`datasets`](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/tree/master/datasets) (Market CSVs), [`python/data/download_intraday_yfinance.py`](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/data/download_intraday_yfinance.py) (Intraday downloader), [`python/data/download_historical_jugaad.py`](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/data/download_historical_jugaad.py) (Historical downloader), [`python/research/analyze_intraday.py`](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/research/analyze_intraday.py) (Intraday correlations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_acquisition["Market data"]
  node_intraday_dl["Intraday downloader"]
  node_historical_dl["Historical downloader"]
  node_csv_common["CSV utilities"]
  node_data_store[("Market CSVs")]
end

subgraph group_research["Research analysis"]
  node_intraday_analysis["Intraday correlations"]
  node_historical_analysis["Historical correlations"]
  node_pair_analysis["Pair analysis<br/>[analyze_pairs.py]"]
  node_research_results[("Research outputs")]
end

subgraph group_runtime["Python trading components"]
  node_data_loader["Data loader<br/>[loader.py]"]
  node_strategy_api["Strategy interface<br/>[base.py]"]
  node_sma_strategy["SMA crossover<br/>[sma_cross.py]"]
  node_performance["Performance metrics<br/>[performance.py]"]
end

subgraph group_cpp["C++ backtester"]
  node_backtester["C++ executable<br/>[main.cpp]"]
end

node_researcher(("Researcher"))
node_yahoo{{"Yahoo Finance"}}
node_nse{{"NSE data"}}

node_researcher -->|"runs"| node_intraday_dl
node_researcher -->|"runs"| node_historical_dl
node_yahoo -->|"provides bars"| node_intraday_dl
node_nse -->|"provides history"| node_historical_dl
node_intraday_dl -->|"uses"| node_csv_common
node_historical_dl -->|"uses"| node_csv_common
node_intraday_dl -->|"writes CSVs"| node_data_store
node_historical_dl -->|"writes CSVs"| node_data_store
node_researcher -->|"runs"| node_intraday_analysis
node_researcher -->|"runs"| node_historical_analysis
node_researcher -->|"runs"| node_pair_analysis
node_data_store -->|"reads prices"| node_intraday_analysis
node_data_store -->|"reads prices"| node_historical_analysis
node_data_store -->|"reads pair data"| node_pair_analysis
node_intraday_analysis -->|"writes correlations"| node_research_results
node_historical_analysis -->|"writes correlations"| node_research_results
node_pair_analysis -->|"writes stats and plot"| node_research_results
node_sma_strategy -->|"implements"| node_strategy_api

click node_intraday_dl "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/data/download_intraday_yfinance.py"
click node_historical_dl "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/data/download_historical_jugaad.py"
click node_csv_common "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/data/_download_common.py"
click node_data_store "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/tree/master/datasets"
click node_intraday_analysis "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/research/analyze_intraday.py"
click node_historical_analysis "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/research/analyze_historical.py"
click node_pair_analysis "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/research/analyze_pairs.py"
click node_research_results "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/tree/master/results"
click node_data_loader "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/src/data/loader.py"
click node_strategy_api "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/src/strategies/base.py"
click node_sma_strategy "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/src/strategies/sma_cross.py"
click node_performance "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/src/metrics/performance.py"
click node_backtester "https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/cpp/src/main.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_intraday_dl,node_historical_dl,node_csv_common,node_data_store toneBlue
class node_intraday_analysis,node_historical_analysis,node_pair_analysis,node_research_results toneAmber
class node_data_loader,node_strategy_api,node_sma_strategy,node_performance toneMint
class node_backtester toneRose
class node_researcher,node_yahoo,node_nse toneIndigo
```

## Components

### Market data

- [Intraday downloader](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/data/download_intraday_yfinance.py): `python/data/download_intraday_yfinance.py`
- [Historical downloader](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/data/download_historical_jugaad.py): `python/data/download_historical_jugaad.py`
- [CSV utilities](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/data/_download_common.py): `python/data/_download_common.py`
- [Market CSVs](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/tree/master/datasets): `datasets`

### Research analysis

- [Intraday correlations](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/research/analyze_intraday.py): `python/research/analyze_intraday.py`
- [Historical correlations](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/research/analyze_historical.py): `python/research/analyze_historical.py`
- [Pair analysis](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/research/analyze_pairs.py): `python/research/analyze_pairs.py`
- [Research outputs](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/tree/master/results): `results`

### Python trading components

- [Data loader](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/src/data/loader.py): `python/src/data/loader.py`
- [Strategy interface](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/src/strategies/base.py): `python/src/strategies/base.py`
- [SMA crossover](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/src/strategies/sma_cross.py): `python/src/strategies/sma_cross.py`
- [Performance metrics](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/python/src/metrics/performance.py): `python/src/metrics/performance.py`

### C++ backtester

- [C++ executable](https://github.com/nihal-prakash/statisticalarbitrage-c-backtester/blob/master/cpp/src/main.cpp): `cpp/src/main.cpp`

### Other components

- **Researcher**
- **Yahoo Finance**
- **NSE data**

## Connections

- Researcher → Intraday downloader: runs (evidence: `README.md`)
- Researcher → Historical downloader: runs (evidence: `README.md`)
- Yahoo Finance → Intraday downloader: provides bars (evidence: `README.md`)
- NSE data → Historical downloader: provides history (evidence: `README.md`)
- Intraday downloader → CSV utilities: uses (evidence: `python/data/download_intraday_yfinance.py`)
- Historical downloader → CSV utilities: uses (evidence: `python/data/download_historical_jugaad.py`)
- Intraday downloader → Market CSVs: writes CSVs (evidence: `README.md`)
- Historical downloader → Market CSVs: writes CSVs (evidence: `README.md`)
- Researcher → Intraday correlations: runs (evidence: `README.md`)
- Researcher → Historical correlations: runs (evidence: `README.md`)
- Researcher → Pair analysis: runs (evidence: `README.md`)
- Market CSVs → Intraday correlations: reads prices (evidence: `README.md`)
- Market CSVs → Historical correlations: reads prices (evidence: `README.md`)
- Market CSVs → Pair analysis: reads pair data (evidence: `python/research/analyze_pairs.py`)
- Intraday correlations → Research outputs: writes correlations (evidence: `README.md`)
- Historical correlations → Research outputs: writes correlations (evidence: `README.md`)
- Pair analysis → Research outputs: writes stats and plot (evidence: `README.md`)
- SMA crossover → Strategy interface: implements (evidence: `python/src/strategies/sma_cross.py`)
