Charting & Data Visualization
Relevant source files
The following files were used as context for generating this wiki page:
The Charting and Data Visualization system in ZINC Fusion V15 provides institutional-grade visual intelligence for Soybean Oil (ZL) futures. It synthesizes complex multi-horizon probabilistic forecasts, real-time market regimes, and domain-specific specialist signals into actionable dashboards. The system is designed to support procurement timing and hedging decisions for US Oil Solutions by visualizing price impact scenarios and risk metrics.
The visualization layer leverages high-performance libraries such as lightweight-charts for financial time-series and custom React components for risk gauges, sentiment heatmaps, and factor attribution. These visualizations allow users to monitor the "Specialist Ensemble"—twelve domain models focused on areas like Crush Economics, China Demand, and Tariff Regimes—to understand the underlying drivers of market movements.
Sources: README.md:12-25, Docs/zinc-fusion-v15-preview.html:1124-1140, frontend/src/app/strategy/page.tsx:1-15
Financial Time-Series Visualization
The primary vehicle for price analysis is the LightweightZlCandlestickChart, which implements a TradingView-style interface for ZL1! (Soybean Oil) futures. It features high-fidelity candlestick rendering, volatility overlays, and probabilistic forecast zones.
Candlestick Rendering and Theme
The chart uses specific institutional themes to match professional trading environments. This includes transparent borders for candles and distinct wick colors (white/gray) rather than body-matching colors.
| Feature | Configuration/Color |
|---|---|
| Up Color | #26C6DA |
| Down Color | #FF0000 |
| Wick Up | #FFFFFF |
| Grid Color | rgba(255,255,255,0.04) |
| Refresh Interval | 5 Minutes |
Sources: frontend/src/components/LightweightZlCandlestickChart.tsx:32-48, frontend/src/components/LightweightZlCandlestickChart.tsx:50-51
Forecast Overlays and Whitespace
A critical architectural feature is the ForecastTargetsPrimitive. It renders "Entry", "Take Profit" (TP), and "Stop Loss" (SL) zones directly on the chart. To allow these future-dated zones to render correctly, the system uses ensureFutureWhitespace to extend the time scale beyond the most recent historical bar.
The diagram shows the data flow between historical price fetching and the injection of predictive forecast zones onto the canvas.
Sources: frontend/src/components/LightweightZlCandlestickChart.tsx:210-230, frontend/src/components/LightweightZlCandlestickChart.tsx:232-245
Risk and Specialist Signal Visualization
ZINC Fusion utilizes a variety of specialized gauges and meters to visualize the "Big-11" specialist signals. These components translate numerical pressure scores (0-100) into color-coded risk indicators.
Indicator Gauges
The system employs both semicircular arcs and horizontal meters to represent metrics such as VIX Stress, Harvest Pace, and Tariff Threats.
- Color Logic: Scores are mapped dynamically. Green (0-25) indicates calm, Amber (40-55) indicates elevated risk, and Red (85+) indicates extreme risk/panic.
- Interaction: Components like
ChrisTop4Driversinclude "What's Happening" panels that provide AI-generated narratives explaining the driver's current regime.
Sources: frontend/src/components/ChrisTop4Drivers.tsx:84-110, frontend/src/components/ChrisTop4Drivers.tsx:131-150
Specialist Ensemble Grid
Twelve specialist models are visualized in an intelligence grid. Each card displays the model's signal (e.g., +0.65 for Crush Economics) and its respective weight in the final ensemble.
This diagram illustrates how individual specialist signals are aggregated by the core model to produce the final dashboard visualizations.
Sources: Docs/zinc-fusion-v15-preview.html:1210-1250, AGENTS.md:58-75
Market Psychology and Sentiment Visualization
The Sentiment Analysis module visualizes qualitative data through quantitative lenses, specifically focusing on news polarity and institutional positioning.
Fear & Greed Index
The FearGreedGauge provides a 300x170 SVG visualization of market psychology. It uses a multi-stop linear gradient from Red (Fear) to Green (Greed).
- Components: The index is derived from six weighted factors: VIX, Positioning, Sentiment, Crush, Volatility, and the Trump Effect.
- Narrative: AI analysis is paired with the gauge to explain shifts in the "P-percentile" of fund bullishness.
Sources: frontend/src/app/sentiment/page.tsx:265-310, frontend/src/app/sentiment/page.tsx:162-180
Sentiment Clustering
Headlines are categorized into Bullish, Bearish, or Neutral sentiments. The SentimentPage visualizes this through:
- Sentiment Bias Header: Displays the deviation (e.g., +0.34 bullish) and sigma (σ) level.
- Summary Bar: A multi-colored progress bar showing the distribution of recent articles.
Sources: frontend/src/app/sentiment/page.tsx:215-235, frontend/src/app/sentiment/page.tsx:430-455
Data Visualization Components Table
| Component Name | Type | Purpose | Primary Source File |
|---|---|---|---|
RegimeAnalysisChart | Time-series | Visualizes market stability/volatility regimes over time. | strategy/page.tsx |
FusionBrain | Force-directed | Displays driver attribution and signal co-movement. | strategy/page.tsx |
HorizontalMeter | Progress Bar | Shows 0-100 risk scores for market drivers. | ChrisTop4Drivers.tsx |
ContractHighlights | Info Grid | Displays Volume, Open Interest, and Front Month data. | ContractHighlights.tsx |
VolGauge | Radial | Measures VIX and OVX against historical thresholds. | sentiment/page.tsx |
Sources: frontend/src/app/strategy/page.tsx:64-74, frontend/src/components/ChrisTop4Drivers.tsx:112-127, frontend/src/components/charts/ContractHighlights.tsx:20-45
The charting and visualization architecture in ZINC Fusion V15 serves as a decision-support layer that bridges the gap between raw ML outputs and strategic procurement. By combining high-frequency financial charts with probabilistic overlays and thematic risk gauges, the platform provides a comprehensive view of the Soybean Oil market's technical and fundamental landscape.