quantum-hybrid-portfolio / docs /DASHBOARD_GUIDE.md
rocRevyAreGoals15's picture
Initial HF Space deployment
9e89154
|
Raw
History Blame Contribute Delete
2.92 kB
# Dashboard User Guide
The Quantum Hybrid Portfolio Dashboard is a React application for portfolio optimization, backtesting, risk analysis, and scenario testing.
## Data Modes
- **LIVE (API)** β€” Real market data from the backend. Select tickers, dates, and run optimization.
- **SIM (Simulation)** β€” Synthetic market data from regime parameters. Ideal for experimentation.
## Tabs
### Holdings
- **Portfolio Holdings** β€” Optimized weights and sector allocation
- **Sector Breakdown** β€” Pie chart by GICS sector
- **Trade Blotter** β€” Dollar amounts and share counts for execution
- **Benchmark Weight Comparison** β€” QSW vs Equal Weight, Min Variance, Risk Parity, HRP
### Performance
- **Backtest Panel** β€” Run historical backtest with tickers and dates
- **Drawdown Chart** β€” Drawdown from peak
- **Cumulative Performance** β€” Equity curve (backtest or simulated)
- **Strategy Comparison** β€” QSW vs benchmarks (bar chart and table)
### Risk
- **Correlation Heatmap** β€” Pairwise correlation between assets
- **Efficient Frontier** β€” Risk-return frontier with current portfolio
- **Value at Risk** β€” Daily VaR and CVaR at 95% confidence
- **Sector Exposure** β€” Radar chart (portfolio vs equal-weight)
- **Stress Test Scenarios** β€” Impact under 2008 GFC, COVID Crash, 2022 Rate Shock, Flash Crash
### Analysis
- **What-If Weight Adjuster** β€” Sliders to tweak weights; see impact on metrics
- **Regime Comparison** β€” Optimize under bull, bear, normal, volatile regimes
### Sensitivity
- **Omega Sensitivity** β€” Sharpe vs omega
- **Max Weight / Evolution Time Sensitivity** β€” How constraints affect Sharpe
- **Correlation Matrix** β€” Holdings correlation
- **Omega Impact Breakdown** β€” Return, vol, positions at each omega
**API mode:** "Run API Sensitivity Sweep" β€” Batch optimize across omega and max-weight.
### Scenarios
- **Index & ETF Scenario Tester** β€” Define scenarios, run batch backtests, compare
- **Load** β€” Apply a scenario to the main dashboard
## Left Panel Controls
- **Quantum Parameters:** Omega, Evolution Time
- **Market Regime:** Normal, Bull, Bear, Volatile
- **Evolution Method:** Continuous, Discrete, Decoherent, Adiabatic, Variational
- **Objective:** Max Sharpe, Min Variance, Risk Parity, HRP, Target Return
- **Constraints:** Max Weight, Max Turnover, Universe Size
- **Tickers & Dates:** Search/autocomplete, date range
- **Simulation:** Random seed, reset, portfolio status
## Metric Cards
Sharpe Ratio, Expected Return, Volatility, Active Positions, Daily VaR. Toggle Optimization vs Backtest when backtest is available.
## Informational Bubbles
Hover over info icons next to labels, sections, and cards for short explanations.
## Header Actions
- **Theme toggle** β€” Dark/light
- **Export** β€” Download JSON (parameters, holdings, risk, backtest)
- **DataSource badge** β€” SIM or LIVE
---
*Last updated: 2026-02*