Regime Filter [BigBeluga]

🔵 OVERVIEW
Regime Filter [BigBeluga] is a dual-factor trend condition tool combining price trend momentum and volume expansion into a single, easy-to-read visual framework. It quantifies recent trend direction and volume shifts, then shows them as:

• Two oscillator plots for Trend and Volume regimes
  
• Dynamic candle coloring for trend clarity
  
• A quadrant scatter map in your chart corner for immediate regime recognition.
  

This filter helps traders quickly detect when a trend is healthy & confirmed by strong volume, or weakening & vulnerable due to low volume.

🔵 CONCEPTS

• Trend Oscillator: A loop-based trend value calculated by comparing the current smoothed price (HMA of HLC3) against its own trailing history. Positive values indicate trend-up regimes, negative values signal trend-down phases.
  
• Volume Oscillator: Similar loop logic but on smoothed volume (HMA of Volume) — highlighting whether trading activity is expanding or contracting relative to past bars.
  

  hma = ta.hma(hlc3, 15)
  vol = ta.hma(volume, 15)
  
  for i = 0 to len 
      if hma > hma
          trend += 1
      else 
          trend -= 1
  
  for i = 0 to len 
      if vol > vol
          voltrend += 1
      else 
          voltrend -= 1

• Regime Map Scatter Plot: A unique 2D quadrant displayed in the bottom-right corner. This shows where the market is sitting:
  
  > Top Right (green): Trend ↑ and Volume ↑ → strong confirmed up trend.
  
  
  > Top Left (red): Trend ↓ but Volume ↑ → strong sell momentum.
  
  
  > Bottom Right (blue): Trend ↑ but Volume ↓ → uptrend losing steam.
  
  
  > Bottom Left (yellow): Trend ↓ and Volume ↓ → weak bearish drift.
  
• Dynamic Candle Coloring: Candles are colored by trend only: green for uptrends, red for downtrends, and orange near reversals.
  
• Threshold Fills: The oscillator region is shaded green above +10 (healthy uptrend) and red below -10 (strong downtrend) for instant confidence.
  

🔵 FEATURES

• Normalized trend and volume values adapt automatically to your lookback length.
  
• Candlestick color overrides highlight current trend state in real-time.
  
• Clear zero-line and fill bands help you gauge strength vs. noise.
  
• Scatter regime dashboard updates live to track when trend and volume align or decouple.
  
• Color gradients show intensification or cooling in both oscillators and the regime map.
  

🔵 HOW TO USE

• Look for sustained positive trend and volume values to confirm strong directional moves.
  
• Watch for the scatter dot in the green square (top right) for high-confidence breakouts.
  
• If the dot drops to bottom right, uptrend may be tiring — possible exit zone.
  
• If the dot jumps top left, bearish drive is reinforced by heavy volume — caution on longs.
  
• Use the orange trend coloring as an early warning that trend pressure may be shifting.
  
• Combine with breakout levels or moving averages for a robust regime filter system.
  

🔵 CONCLUSION
The Regime Filter [BigBeluga] distills price trend and volume dynamics into an actionable multi-mode display: oscillators, color-coded candles, and an intuitive scatter map. This all-in-one layout helps traders visually read market regime strength and spot fading trends before they turn — perfect for swing traders, intraday scalpers, and macro trend followers alike.