Ichimoku + Time Theory Cluster PRO++ (ZZZ)

## Ichimoku + Time Theory Cluster PRO++ (ZZZ)

### 1) What does this script do?
**Ichi+Time PRO++** combines **Ichimoku + Ichimoku Time Theory (Hosoda’s time cycles)** to:
- Automatically plot **Ichimoku (Tenkan/Kijun/Chikou/Kumo)** as a **trend filter & support/resistance framework**.
- Calculate **projected time targets** derived from **pivots (swing highs/lows)**, then **cluster** nearby targets into **“time windows”** where the probability of **reversal / acceleration / strong volatility** is higher than usual.
- Show **early warnings (countdown “~in N bars”)** and classify clusters as **Normal / Strong** using a **score**.

> Core idea: **Price can travel far/short based on “price”, but it often turns hard around certain “time” marks.** Ichimoku helps define *direction and key areas*, while Time Clusters tell you *when to be on alert*.

---

### 2) How it works (simple overview)
1. **Detect pivots** (swing highs/lows) using Pivot Left/Right
- A pivot is confirmed only after *pivRight* bars → less noise.
2. From each pivot, the script generates **projected time targets** based on Time Theory cycle offsets (bar intervals).
3. Nearby projections are **grouped into clusters** using **“Tolerance ± bars”**.
4. A cluster is kept only if it meets:
- **Min hits**: minimum number of projections inside the same window
- **Min score**: minimum score threshold
Score = **baseScore (weighted hits)** + **contextBonus (Ichimoku context)**
→ Clusters aligned with favorable Ichimoku conditions are **prioritized**.

---

### 3) What you will see on the chart
- **Ichimoku**: Tenkan / Kijun / Chikou / Kumo (to read trend & key zones).
- **Time Cluster Window**:
- **Normal**: meets baseline conditions.
- **Strong (TC++)**: higher score (≥ strongScore) → more important.
- **Tooltips / info labels** (e.g., hits, base, ctx, score, ~in N bars) show:
- How strong a cluster is
- How many bars remain until the “time window”

---

### 4) Practical usage (recommended workflow)
**Step 1 — Filter the trend with Ichimoku**
- Prefer Long when: price is **above Kumo**, Tenkan > Kijun, Chikou is not obstructed.
- Prefer Short when: price is **below Kumo**, Tenkan < Kijun, Chikou is not obstructed.

**Step 2 — Use Time Clusters to pick the “WHEN”**
- When a **Time Cluster (Normal/Strong)** appears, interpret it as:
- A **“sensitive time window”** → higher chance of reversal, breakout, acceleration, or sharp shakeout.
- Not an automatic entry; you still need **price action confirmation**.

**Step 3 — Entry trigger**
- Wait for confirmation such as: structure break, pin/engulf candle, range breakout, Kijun/Kumo retest, etc.
- **Strong clusters** are often useful to:
- Hunt reversals around Ichimoku zones (Kijun/Kumo)
- Hunt breakouts when consolidating and Ichimoku agrees with the trend

**Step 4 — Risk management**
- Place SL using the nearest structure (swing/pivot/Kijun) + buffer.
- If already in a trade, Time Clusters can help you:
- tighten SL, take partial profits, or anticipate volatility.

---

### 5) Presets (A/B) & signal tuning
- **Mode A: “Fewer but stronger”**
Stricter filtering → fewer clusters, higher quality (swing/position-friendly).
- **Mode B: “More early warnings”**
Moderate filtering → more clusters (good for earlier monitoring and flexibility).
- **Custom**
Manually adjust key parameters:
- Pivot Left/Right
- Tolerance ± bars
- Min hits / Min score / Strong score
- Filter small pivots (reduce noise)

> Tip: Higher timeframes (4H–1D) usually work best with Mode A (cleaner). Lower timeframes (15m–1H) can use Mode B, but require disciplined triggers.

---

### 6) Important notes (avoid misinterpretation)
- Pivots require confirmation → pivot-based signals **do not print exactly at the top/bottom**, but after *pivRight* bars.
- Future **projected clusters may shift** when new pivots appear (they update with new data).
Treat Time Clusters as **time windows to be alert**, not “exact entry points”.
- This script does not replace a trading plan; always use proper position sizing and risk control.

---

### 7) Performance
This script uses many drawing objects (box/label/line). If your device is slow:
- Reduce **Max pivots stored**
- Reduce the number of clusters displayed or switch to **Mode A**
- Use a higher timeframe

---

**Disclaimer:** This tool is for technical analysis support only and is not financial advice. You are responsible for your own trading decisions.

---

## User Guide

### 1) What is this indicator for?
This indicator combines **Auto Ichimoku** + **Time Theory Clusters** to:
- Identify **trend & equilibrium zones** via Ichimoku (Kumo, Tenkan/Kijun, Chikou).
- Find **time windows** with higher probability of volatility/reversal/acceleration (Time Clusters).
- Score each time cluster based on **cluster strength (hits)** and **Ichimoku context (context bonus)**.

> Key reminder: Time Clusters answer **WHEN**, not **WHERE**. Always combine them with **price confirmation / Ichimoku / PA** before entering.

---

### 2) Add the indicator & quick setup
1. Open a chart → **Indicators** → choose **Ichimoku + Time Theory Cluster PRO++**.
2. Recommended timeframes:
- Swing/position: **H4 – D1 – W1**
- Intraday: **M15 – H1** (noisier; needs stricter filtering).
3. Choose **Mode (Preset)**:
- **A: Fewer but stronger** → stricter, fewer signals, higher quality (recommended for swing).
- **B: More early warnings** → more signals (recommended for intraday monitoring).
- **Custom** → fine-tune all parameters.

---

### 3) Signal meaning (how to read the chart)
The indicator marks **Time Clusters** in two levels:
- **Time Cluster Enter (Normal)**: meets minimum thresholds (minHits/minScore).
- **Time Cluster Enter (Strong / TC++)**: strong cluster (score ≥ strongScore) → higher priority.

**Correct interpretation:**
- As price approaches a Time Cluster window, the market is more likely to:
- reverse,
- break out of consolidation,
- accelerate a trend,
- or produce strong volatility (sweep/false break).
- Trading direction should be aligned with **Ichimoku context** (see section 4).

---

### 4) Suggested trading rules (practical & simple)

#### A. Trend trading (recommended)
**Prefer LONG when:**
- Price is **above Kumo**, future Kumo is bullish (Span A > Span B).
- Tenkan is **above** Kijun (or just crossed up), Chikou is not trapped by price/cloud.
- At a Time Cluster:
- Look for a **pullback** to Kijun/Tenkan or structural support,
- Wait for confirmation (engulfing/pinbar/micro-structure break),
- Enter.

**Prefer SHORT when:**
- Price is **below Kumo**, future Kumo is bearish (Span A < Span B).
- Tenkan is **below** Kijun, Chikou is pressured/blocked.
- At a Time Cluster:
- Look for a rally into Kijun/cloud edge,
- Wait for rejection, then enter.

✅ Tip: **Strong clusters (TC++)** matter most when they align with:
- Kumo edge,
- Kijun,
- horizontal S/R,
- supply/demand (order block) or swing high/low.

#### B. Reversal trading (only with strong confirmation)
Consider reversals only when:
- Time Cluster is **Strong (TC++)**
- + you see a **structure shift** (BOS/CHoCH) or a clear reversal candle setup,
- + Ichimoku shows weakness (price inside cloud, flat Tenkan/Kijun, Chikou trapped).

---

### 5) Risk management (mandatory)
- Do not enter just because you “reached a Time Cluster”.
- Always set SL by structure:
- LONG: below swing low / below Kijun / below nearest cloud edge.
- SHORT: above swing high / above Kijun / above nearest cloud edge.
- Take profit using:
- minimum R:R **1:1.5 – 1:2**
- or key targets (prior highs/lows, cloud boundaries, fib levels, etc.)

---

### 6) Inputs explained (Custom mode)
- **Pivot Left / Pivot Right**: pivot confirmation (higher = fewer but more reliable pivots).
- **Max pivots stored**: how many pivots are stored for clustering (more = more sensitive but heavier).
- **Tolerance ± bars**: cluster window width (larger = more clusters; smaller = sharper).
- **Min hits**: minimum overlaps to qualify as a cluster.
- **Min score**: minimum score to accept a cluster.
- **Strong score**: threshold to mark strong clusters (TC++).
- **Filter small pivots / Filter mode**: remove small pivots to reduce noise (recommended ON).

---

### 7) Alerts (recommended)
You can create alerts for:
- **Time Cluster Enter (Normal)**
- **Time Cluster Enter (Strong / TC++)**

Recommendation: set alerts on your main trading timeframe (H1/H4/D1) to avoid spam on very small TFs.

---

### 8) Disclaimer
This indicator is for technical analysis support only and is **not financial advice**. All trading decisions are your responsibility. Please test (forward/backtest) and apply risk management before using real money.

---

### 9) Access (Invite-only, if applicable)
To request access, send me a private message on TradingView with:
- TradingView username
- Market you trade (Crypto/FX/Indices…)
- Primary timeframe (e.g., H1/H4/D1)
I will grant access in order of requests.

---