Harmonic Periodicity Matrix [Pineify]

• Three harmonically spaced stochastic cycles fused into one composite wave
• Weighted Moving Average (WMA) smoothing to reduce noise without excessive lag
• EMA-based signal line that generates precise momentum-crossover triggers
• Dynamic gradient coloring that visually encodes cycle strength and direction
• Momentum Ribbon fill between the cycle wave and signal line for at-a-glance bias confirmation
• Overbought / Oversold reference zones with subtle background shading
• Filtered Buy and Sell signals that fire only when reversals originate from extreme cycle territory

1. Short cycle — half the primary length (cycleLen / 2), capturing fast intraday or shorter-term oscillations.
2. Primary cycle — the user-defined length (cycleLen), representing the dominant market rhythm.
3. Long cycle — 1.5× the primary length (cycleLen × 1.5), anchoring the broader trend context.

• Zero-line crosses — When the composite wave crosses above 0, market momentum is transitioning bullish; below 0 signals bearish transition.
• Overbought / Oversold extremes — Readings above +25 indicate potential exhaustion; readings below −25 indicate potential recovery opportunity.
• Signal crossovers from extremes — The highest-conviction signals occur when the wave crosses the signal line while already in oversold (< −15, Buy) or overbought (> +15, Sell) territory.
• Momentum Ribbon color — A green ribbon confirms bullish momentum continuation; a red ribbon warns of bearish pressure even if price is still rising.

The three stochastics represent different frequency bands of market activity — fast, medium, and slow. Averaging them suppresses random noise that would appear in any single stochastic while preserving genuine cyclical structure that repeats across all three timeframes simultaneously.

• Harmonic period spacing — Using 0.5×, 1×, and 1.5× ratios is inspired by harmonic analysis principles, where related frequencies reinforce true cyclical signals and cancel spurious noise.
• Amplitude-coded gradient — Color intensity scales with distance from zero (0→40 bullish, −40→0 bearish), making it easy to distinguish a mild rebound from a powerful trend.
• Filtered signals — Buy signals require the crossover to occur below −15; Sell signals require it above +15. This prevents signal generation in neutral mid-range territory where momentum reversals are statistically less reliable.
• Zero-centered display — Centering around 0 (rather than displaying 0–100) aligns naturally with how traders think about bullish vs. bearish bias.

1. Add the indicator to any chart and timeframe. It plots in a separate panel below the price chart.
2. Watch for green circles (Buy signals) — these appear when the cycle wave crosses up through the signal line from oversold territory (below −15).
3. Watch for red circles (Sell signals) — these appear when the cycle wave crosses down through the signal line from overbought territory (above +15).
4. Use the Momentum Ribbon fill color to confirm trend direction before entering trades.
5. Pay attention to the overbought (+25) and oversold (−25) zones — readings beyond these thresholds suggest cycle exhaustion and potential reversal.
6. Combine with price action or volume analysis for additional confirmation before executing trades.

• Primary Cycle Length (default: 20) — Increase for longer-term swing cycle detection; decrease for faster, shorter-term cycle tracking.
• Smoothing Factor (default: 6) — Higher values produce a smoother wave with more lag; lower values are more reactive but noisier.
• Bullish Wave color — Default green (#089981); customizable.
• Bearish Wave color — Default red (#F23645); customizable.
• Equilibrium color — Default gray (#787b86); customizable.