اندیکاتور «Modern Ichimoku Cloud [GBB]» نسخه‌ای بازطراحی‌شده و چندلایه از اندیکاتور کلاسیک ایچیموکو کینکو هیو است که با زبان Pine Script نسخه ۶ نوشته شده و روی چارت اصلی (overlay) اجرا می‌شود. فلسفه اصلی این اندیکاتور، حفظ ساختار پنج‌خطی ایچیموکو کلاسیک در «لایه صفر» و افزودن چهار لایه تحلیلی مدرن روی آن است: هندسه نرمال‌شده، سیگنال‌های واجد شرایط، سطوح خط‌صاف، و شستشوی تایم‌فریم بالاتر همراه با جدول آماری و هشدارها. این طراحی ماژولار به معامله‌گر اجازه می‌دهد با فعال یا غیرفعال کردن هر لایه، از حالت کاملاً کلاسیک تا حالت تحلیلی پیشرفته را انتخاب کند. حالت «Classic mode» با یک کلیک لایه‌های ۱ تا ۳ را خاموش می‌کند و فقط رسم استاندارد ایچیموکو را باقی می‌گذارد، در حالی که لایه چهارم (HTF و جدول) همیشه در دسترس است.

در قلب اندیکاتور، تابع f_lines() قرار دارد که پنج خط اصلی ایچیموکو را محاسبه می‌کند: تنکان‌سن (میانگین بالاترین سقف و پایین‌ترین کف در ۹ کندل)، کیجون‌سن (همین محاسبه در ۲۶ کندل)، سنکو A (میانگین تنکان و کیجون)، سنکو B (میانگین ۵۲ کندلی)، و چیکو اسپن (close با جابجایی منفی). نکته کلیدی این است که ابر کومو زیر کندل جاری، از مقادیر سنکو A و B که displacement - 1 کندل قبل محاسبه شده‌اند ساخته می‌شود؛ یعنی همان ابری که در لحظه معامله واقعاً زیر قیمت قرار دارد. موقعیت قیمت نسبت به ابر (بالا، پایین، یا داخل) در متغیر cloudPos ذخیره می‌شود و پایه‌ای برای گریدبندی و فیلتر سیگنال‌هاست. ضخامت ابر، فاصله تنکان-کیجون، فاصله قیمت از ابر و مومنتوم چیکو همگی بر حسب واحد ATR نرمال‌سازی می‌شوند تا مقایسه بین نمادها و تایم‌فریم‌های مختلف معنادار باشد.

لایه اول، هندسه ابر را به مقادیر قابل تفسیر تبدیل می‌کند. ضخامت ابر (تفاوت سنکو A و B) و ضخامت پیش‌بینی‌شده (در لحظه محاسبه) هر دو بر ATR تقسیم می‌شوند و سپس با استفاده از ta.percentile_nearest_rank در پنجره‌ای به طول پیش‌فرض ۱۵۰ کندل، سه آستانه صدکی محاسبه می‌شود: صدک ۳۰ (نازک)، صدک ۷۰ (ضخیم) و صدک ۹۰ (خیلی ضخیم). تابع f_grade هر مقدار را به یکی از چهار گرید «نازک، نرمال، ضخیم، خیلی ضخیم» نگاشت می‌کند و شفافیت رنگ ابر (fill) بر اساس همین گرید تنظیم می‌شود؛ ابر ضخیم‌تر شفافیت کمتر و تراکم رنگ بیشتری دارد. همچنین یک برچسب متنی روی آخرین کندل، وضعیت گرید ابر، فاصله قیمت از ابر و مومنتوم چیکو را بر حسب ATR نمایش می‌دهد. این لایه به معامله‌گر کمک می‌کند تشخیص دهد که آیا ابر در یک رژیم نوسانی فشرده قرار دارد یا در یک روند پرنوسان ضخیم شده است.

لایه دوم رویدادهای خام (کراس تنکان/کیجون، شکست ابر، پیچش ابر) را شناسایی کرده و سپس با چهار فیلتر «واجد شرایط» می‌کند: جهت کندل جاری، حداقل فاصله قیمت از ابر (پیش‌فرض ۱ ATR)، حداقل مومنتوم چیکو (پیش‌فرض ۱ ATR)، و در صورت فعال بودن، هم‌راستایی با ابر تایم‌فریم بالاتر. رویدادهای واجد شرایط با مثلث‌های بزرگ (شکست ابر) و کوچک (کراس TK) و رویدادهای ردشده با دایره‌های خاکستری کوچک نمایش داده می‌شوند. لایه سوم سطوح خط‌صاف را ردیابی می‌کند: هرگاه کیجون‌سن یا سنکو B برای حداقل ۶ یا ۸ کندل متوالی مقدار ثابتی داشته باشد، یک خط افقی از ابتدای آن بازه تا رسیدن قیمت (با تلورانس ۰.۰۵ ATR) یا انقضای زمانی (۳ برابر طول کیجون) رسم می‌شود. این سطوح به‌عنوان حمایت/مقاومت‌های پویا عمل می‌کنند و آمار «نرخ لمس» آن‌ها در جدول آماری گزارش می‌شود.

لایه چهارم شامل سه بخش است. اول، «شستشوی HTF» که با request.security ابر تایم‌فریم بالاتر (به‌صورت خودکار ۴ برابر تایم‌فریم چارت یا انتخابی) را می‌خواند و رنگ پس‌زمینه را بر اساس موقعیت قیمت HTF نسبت به ابر آن تنظیم می‌کند. دوم، جدول آماری که نرخ برد رویدادهای واجد شرایط را در دو افق (displacement و statsH2)، ضریب دامنه حرکتی، نرخ لمس سطوح خط‌صاف و وضعیت HTF را نشان می‌دهد و در حالت «Expanded» شمارش خام/واجد شرایط هر رویداد و آمار سطوح را اضافه می‌کند. سوم، هفت alertcondition برای کراس TK صعودی/نزولی، شکست ابر صعودی/نزولی، پیچش صعودی/نزولی و لمس سطح خط‌صاف، که همگی فقط روی کندل‌های تأییدشده (barstate.isconfirmed) فعال می‌شوند تا از سیگنال‌های زودهنگام جلوگیری شود. در نهایت، پالت رنگی GBB/Classic/Mono و تم Auto/Dark/Light امکان تطبیق ظاهری اندیکاتور با هر سبک چارتی را فراهم می‌کند.

تنظیمات اندیکاتور Modern Ichimoku Cloud [GBB]

Classic mode (حالت کلاسیک) — وقتی فعال شود، اندیکاتور را به حالت استاندارد ایچیموکو برمی‌گرداند و لایه‌های ۱ تا ۳ (هندسه، سیگنال‌های واجد شرایط و سطوح خط‌صاف) به‌طور خودکار خاموش می‌شوند؛ فقط پنج خط کلاسیک و لایه چهارم (شستشوی HTF، جدول و هشدارها) فعال می‌مانند. این گزینه برای معامله‌گرانی است که می‌خواهند ابتدا ساختار خالص ایچیموکو را ببینند و بعداً لایه‌های تحلیلی را اضافه کنند. پیش‌فرض آن false است.

Tenkan-sen (تنکان‌سن) — طول دوره محاسبه خط تنکان‌سن را تعیین می‌کند که میانگین بالاترین سقف و پایین‌ترین کف در این تعداد کندل است. مقدار کمتر آن خط را سریع‌تر و حساس‌تر می‌کند و مقدار بیشتر آن را نرم‌تر و کندتر. پیش‌فرض آن ۹ کندل است که مقدار استاندارد ایچیموکو محسوب می‌شود.

Kijun-sen (کیجون‌سن) — طول دوره محاسبه خط کیجون‌سن را مشخص می‌کند که همان فرمول تنکان‌سن اما در این تعداد کندل است. این خط به‌عنوان خط تعادل میان‌مدت عمل می‌کند و هم در گریدبندی خط‌صاف و هم در محاسبه ATR پیش‌فرض (وقتی atrLen صفر باشد) نقش دارد. پیش‌فرض آن ۲۶ کندل است.

Senkou B (سنکو B) — طول دوره محاسبه خط سنکو B را تعیین می‌کند که میانگین بالاترین سقف و پایین‌ترین کف در این تعداد کندل است. این خط لبه کندتر و پایدارتر ابر کومو را می‌سازد و در تشخیص سطوح خط‌صاف (لایه ۳) نیز استفاده می‌شود. پیش‌فرض آن ۵۲ کندل است.

Displacement (جابجایی) — میزان جابجایی رو به جلوی سنکو A و B و جابجایی رو به عقب چیکو اسپن را تعیین می‌کند. این مقدار همچنین در محاسبه ابر «زیر کندل جاری» (با displacement - 1) و در افق اول جدول آماری (H1) استفاده می‌شود. پیش‌فرض آن ۲۶ کندل است.

Normalised geometry (هندسه نرمال‌شده) — لایه اول را فعال یا غیرفعال می‌کند که شامل نرمال‌سازی ضخامت ابر، فاصله تنکان-کیجون، فاصله قیمت از ابر و مومنتوم چیکو بر حسب ATR است. با فعال بودن این گزینه، گریدبندی درصدی ابر و شفافیت پویای رنگ fill و برچسب گرید روی آخرین کندل نمایش داده می‌شود. پیش‌فرض آن true است.

ATR length (طول ATR) — طول دوره محاسبه ATR را تعیین می‌کند که مبنای نرمال‌سازی تمام مقادیر هندسی است. اگر مقدار آن صفر باشد، از طول کیجون‌سن (kijunLen) به‌عنوان طول ATR استفاده می‌شود. پیش‌فرض آن صفر است.

Percentile window (پنجره صدکی) — تعداد کندل‌هایی که برای محاسبه صدک‌های آستانه گریدبندی ابر استفاده می‌شود. هرچه این پنجره بزرگ‌تر باشد، آستانه‌ها پایدارتر ولی کندتر با رژیم بازار تطبیق می‌یابند. پیش‌فرض آن ۱۵۰ کندل است.

Thin <= pct (آستانه نازک) — صدکی که زیر آن ابر «نازک» طبقه‌بندی می‌شود. مقدار پیش‌فرض ۳۰ یعنی ابرهایی که ضخامت نرمال‌شده‌شان در ۳۰٪ پایین توزیع پنجره صدکی قرار دارد، نازک محسوب می‌شوند. دامنه مجاز آن ۰ تا ۱۰۰ است.

Thick >= pct (آستانه ضخیم) — صدکی که بالای آن ابر «ضخیم» طبقه‌بندی می‌شود. مقدار پیش‌فرض ۷۰ یعنی ابرهایی که ضخامت نرمال‌شده‌شان در ۳۰٪ بالای توزیع قرار دارد، ضخیم محسوب می‌شوند. دامنه مجاز آن ۰ تا ۱۰۰ است.

Very thick >= pct (آستانه خیلی ضخیم) — صدکی که بالای آن ابر «خیلی ضخیم» طبقه‌بندی می‌شود. مقدار پیش‌فرض ۹۰ یعنی فقط ۱۰٪ بالای توزیع در این گرید قرار می‌گیرند و شفافیت fill به کمترین مقدار (۵۰) می‌رسد. دامنه مجاز آن ۰ تا ۱۰۰ است.

Grade label on last bar (برچسب گرید روی آخرین کندل) — وقتی فعال باشد، یک برچسب متنی روی آخرین کندل نمایش داده می‌شود که گرید ابر، ضخامت بر حسب ATR، فاصله قیمت از ابر و مومنتوم چیکو را نشان می‌دهد. این برچسب فقط در صورت فعال بودن لایه اول (useL1) و روی barstate.islast ظاهر می‌شود. پیش‌فرض آن true است.

Qualified signals (سیگنال‌های واجد شرایط) — لایه دوم را فعال یا غیرفعال می‌کند که رویدادهای خام (کراس TK، شکست ابر، پیچش) را با چهار فیلتر جهت کندل، فاصله از ابر، مومنتوم چیکو و هم‌راستایی HTF غربال می‌کند. با غیرفعال بودن آن، هر رویداد خام مستقیماً به‌عنوان سیگنال معتبر در نظر گرفته می‌شود. پیش‌فرض آن true است.

Min price-to-cloud distance (حداقل فاصله قیمت تا ابر) — حداقل فاصله لازم قیمت از لبه ابر بر حسب ATR برای تأیید شکست‌های کومو را تعیین می‌کند. مقدار بزرگ‌تر آن سیگنال‌های قوی‌تر ولی کم‌تعدادتر تولید می‌کند و مقدار کوچک‌تر آن حساسیت را بالا می‌برد. پیش‌فرض آن ۱.۰ ATR با گام ۰.۰۵ است.

Min Chikou momentum (حداقل مومنتوم چیکو) — حداقل مومنتوم لازم چیکو اسپن بر حسب ATR برای تأیید جهت سیگنال را مشخص می‌کند. مومنتوم چیکو به‌صورت (close - close[off]) / ATR محاسبه می‌شود و باید هم‌جهت با سیگنال باشد. پیش‌فرض آن ۱.۰ ATR با گام ۰.۰۵ است.

Require HTF cloud agreement (نیاز به هم‌راستایی ابر HTF) — وقتی فعال باشد، سیگنال‌ها فقط در صورتی واجد شرایط می‌شوند که موقعیت قیمت در تایم‌فریم بالاتر با جهت سیگنال هم‌راستا باشد. این فیلتر نیازمند فعال بودن شستشوی HTF (inHtf) و معتبر بودن تایم‌فریم بالاتر است. پیش‌فرض آن false است.

Show event markers (نمایش نشانگرهای رویداد) — نشانگرهای بصری رویدادها (مثلث‌ها برای رویدادهای واجد شرایط، دایره‌ها برای رویدادهای ردشده و لوزی‌ها برای پیچش‌ها) را روی چارت نمایش می‌دهد. با غیرفعال کردن آن، محاسبات و هشدارها همچنان کار می‌کنند ولی نشانگری رسم نمی‌شود. پیش‌فرض آن true است.

Show unqualified events (نمایش رویدادهای ردشده) — رویدادهای خامی که فیلترهای لایه دوم را رد نکرده‌اند با دایره‌های خاکستری کوچک نمایش می‌دهد. این گزینه فقط وقتی لایه دوم فعال است و نشانگرها روشن هستند معنا پیدا می‌کند و برای تحلیل آماری نرخ رد شدن سیگنال‌ها مفید است. پیش‌فرض آن true است.

Flat-line levels (سطوح خط‌صاف) — لایه سوم را فعال یا غیرفعال می‌کند که خطوط افقی کیجون‌سن و سنکو B را در دوره‌های ثابت‌بودن ردیابی می‌کند. این سطوح به‌عنوان حمایت/مقاومت پویا رسم می‌شوند و آمار لمس/انقضای آن‌ها در جدول آماری گزارش می‌شود. پیش‌فرض آن true است.

Kijun flat min bars (حداقل کندل ثابت کیجون) — حداقل تعداد کندل‌های متوالی که کیجون‌سن باید مقدار ثابتی داشته باشد تا یک سطح خط‌صاف جدید ثبت شود. مقدار بزرگ‌تر آن سطوح پایدارتر ولی کم‌تعدادتر تولید می‌کند. پیش‌فرض آن ۶ کندل با حداقل مجاز ۲ است.

Senkou B flat min bars (حداقل کندل ثابت سنکو B) — حداقل تعداد کندل‌های متوالی که سنکو B باید مقدار ثابتی داشته باشد تا یک سطح خط‌صاف جدید ثبت شود. چون سنکو B معمولاً کندتر از کیجون حرکت می‌کند، پیش‌فرض آن بالاتر (۸ کندل) در نظر گرفته شده است. حداقل مجاز آن ۲ است.

Touch tolerance (تلورانس لمس) — فاصله مجاز بر حسب ATR برای تشخیص «لمس شدن» یک سطح خط‌صاف توسط قیمت را تعیین می‌کند. اگر کندل با تلورانس touchTol × ATR به سطح برسد، آن سطح به‌عنوان لمس‌شده علامت‌گذاری شده و رنگ آن پررنگ‌تر می‌شود. پیش‌فرض آن ۰.۰۵ ATR با گام ۰.۰۵ است.

Max age (x Kijun bars) (حداکثر عمر سطح) — حداکثر عمر یک سطح خط‌صاف را به‌صورت ضریبی از طول کیجون‌سن تعیین می‌کند. اگر سطحی تا این مدت لمس نشود، به‌عنوان منقضی علامت‌گذاری شده و بسته به گزینه hideExpired محو یا پنهان می‌شود. پیش‌فرض آن ۳ برابر طول کیجون است.

Max live level objects (حداکثر اشیای سطح فعال) — حداکثر تعداد خطوط سطوح خط‌صافی که می‌توانند هم‌زمان روی چارت وجود داشته باشند را محدود می‌کند. با رسیدن به این حد، قدیمی‌ترین سطح حذف می‌شود تا از افت عملکرد جلوگیری شود. پیش‌فرض آن ۶۰ با دامنه مجاز ۵ تا ۴۰۰ است.

Hide expired levels (پنهان کردن سطوح منقضی) — وقتی فعال باشد، سطوح منقضی‌شده به‌طور کامل نامرئی می‌شوند (شفافیت ۱۰۰)؛ در غیر این صورت با شفافیت ۸۰ و خط‌چین کمرنگ باقی می‌مانند. این گزینه به تمیز ماندن چارت کمک می‌کند. پیش‌فرض آن true است.

HTF wash (شستشوی تایم‌فریم بالاتر) — لایه چهارم مربوط به رنگ‌آمیزی پس‌زمینه بر اساس موقعیت قیمت در ابر تایم‌فریم بالاتر را فعال یا غیرفعال می‌کند. وقتی فعال باشد، پس‌زمینه چارت با رنگ ملایم صعودی، نزولی یا داخل ابر رنگ‌آمیزی می‌شود. پیش‌فرض آن true است.

HTF (blank = auto, 4x chart) (تایم‌فریم بالاتر) — تایم‌فریم بالاتر مورد استفاده برای شستشو را تعیین می‌کند. اگر خالی بماند، به‌طور خودکار ۴ برابر تایم‌فریم چارت انتخاب می‌شود؛ در غیر این صورت می‌توان تایم‌فریم دلخواه را وارد کرد. تایم‌فریم انتخابی باید بزرگ‌تر از تایم‌فریم چارت باشد وگرنه شستشو غیرفعال می‌شود.

Stats table (جدول آماری) — جدول آماری گوشه بالا-راست چارت را فعال یا غیرفعال می‌کند که شامل نرخ برد در دو افق، ضریب دامنه، نرخ لمس سطوح و وضعیت HTF است. این جدول یک آمار running روی کندل‌های بارگذاری‌شده است و به‌عنوان بک‌تست واقعی در نظر گرفته نمی‌شود. پیش‌فرض آن false است.

Second stats horizon (افق دوم آماری) — افق زمانی دوم (بر حسب کندل) برای محاسبه نرخ برد در جدول آماری را تعیین می‌کند. افق اول همیشه برابر displacement است و این گزینه افق دومی را برای مقایسه اضافه می‌کند. پیش‌فرض آن ۱۰ کندل با دامنه مجاز ۱ تا ۵۰۰ است.

Expanded stats table (جدول آماری گسترده) — وقتی فعال باشد، ردیف‌های اضافی شامل شمارش خام/واجد شرایط کراس TK، شکست کومو، تعداد پیچش‌ها و آمار ایجاد/لمس/انقضای سطوح کیجون و سنکو B به جدول اضافه می‌شود. این گزینه برای تحلیل عمیق‌تر عملکرد اندیکاتور مفید است. پیش‌فرض آن false است.

Palette (پالت رنگی) — مجموعه رنگ‌های اندیکاتور را انتخاب می‌کند. گزینه «GBB» رنگ‌های مدرن و متمایز، گزینه «Classic» رنگ‌های استاندارد ایچیموکو و گزینه «Mono» طیف خاکستری تک‌رنگ را ارائه می‌دهد. پیش‌فرض آن «GBB» است.

Theme (تم) — تم رنگی اندیکاتور را بین «Auto»، «Dark» و «Light» انتخاب می‌کند. در حالت «Auto»، روشنایی پس‌زمینه چارت (chart.bg_color) محاسبه شده و تم مناسب به‌طور خودکار انتخاب می‌شود. پیش‌فرض آن «Auto» است.