NICHI (NuwenPham's Ichimoku)

NICHI (NuwenPham’s Ichimoku)

NICHI is a dual-engine Ichimoku indicator designed for modern, high-volatility markets.
It preserves a faithful traditional Ichimoku while introducing an advanced, filter-driven Ichimoku framework for research, visualization, and discretionary trading.

The goal of NICHI is not to replace Ichimoku — but to extend it.

Overview

NICHI includes two independent Ichimoku systems that can be enabled separately or together.

1. Standard Ichimoku

A clean, traditional Hosoda Ichimoku using Donchian midpoints:

• Tenkan-sen (short period)
  
• Kijun-sen (medium period)
  
• Senkou Span A & B (forward displaced)
  
• Chikou Span (lagging)
  

Design choice:
The Standard Ichimoku is intentionally plotted in a separate pane to avoid cluttering the price chart.
It serves as a reference / regime baseline, not a visual overlay.

2. Advanced Ichimoku

The Advanced system keeps the Ichimoku structure intact but replaces the Donchian calculations with selectable smoothing filters.

Each Ichimoku component (Tenkan, Kijun, Senkou B, Chikou) can be calculated using modern filters designed to handle volatility, noise, and regime shifts.

Supported filters include:

• McGinley Dynamic (MD)
  
• VWMA (exchange or tick-derived volume)
  
• EMA / DEMA / SMA / SMMA / WMA
  
• ALMA / LSMA / Hull MA
  
• COVWMA / FRAMA / KAMA
  
• 50th Percentile
  
• Moving Median
  

This allows Ichimoku to behave as:

• A smoother trend system
  
• A volatility-adaptive framework
  
• A momentum-responsive overlay
  

Enhanced Cloud (Kumo) Modeling

Advanced Kumo logic includes:

• Independent forward offsets for Span A and Span B
  
• Bull / bear regime classification aligned with how the cloud is actually drawn
  
• Adaptive cloud coloring
  
• Neutral cloud state when spans disagree
  

This avoids misleading regime signals when different offsets are used.

Directional Persistence Tracking

NICHI tracks directional streaks for key components:

• Tenkan direction
  
• Kijun direction
  
• Span A direction
  
• Span B direction
  

These persistence counters stabilize coloring, reduce flicker, and improve visual clarity during transitions.

Bar Coloring Modes (Advanced)

Three bar-coloring frameworks are included.

Kumo-Based

• Above cloud → bullish
  
• Below cloud → bearish
  
• Inside cloud → neutral
  

Tenkan / Kijun-Based

• Above both → bullish
  
• Below both → bearish
  

Chikou-Based

• Chikou above past price → bullish
  
• Chikou below past price → bearish
  

Each mode is intentionally distinct and serves a different trading style.

Moving Average Overlays

NICHI includes four optional moving average overlays (MA1–MA4):

• Configurable type, length, width, and source
  
• Intended for bias, confluence, or higher-timeframe context
  
• Controlled as code-level constants by design
  

What Changed Since BETA

This release promotes NICHI from beta to stable with the following key improvements:

Chikou regime logic fixed:
Chikou comparisons now reference historical price only, eliminating any future lookahead behavior.

Kumo bull/bear alignment clarified:
Cloud regime classification now matches how the cloud is visually drawn when Span A and Span B use different forward offsets.

Kijun direction tracking corrected:
Kijun coloring now reflects Kijun movement, not Tenkan movement.

Bar coloring gated:
Bar coloring is applied only when Advanced Ichimoku is enabled, preventing unintended behavior when using Standard mode alone.

General stability and cleanup:
Minor bug fixes, consistency improvements, and documentation clarity.

Notes

Advanced Ichimoku is intended for research and visualization, not as a turnkey strategy.
Standard Ichimoku remains a faithful baseline.

If reporting issues, please include symbol, timeframe, and a screenshot.