اندیکاتور «Pivot Rays [BMT]» ساخته matt_spinola (نسخه v0.5.1، سپتامبر ۲۰۲۶) یک ابزار ترسیمی در Pine Script نسخه ۶ است که هر پیوت های (نقاط چرخش) تأییدشدهٔ بالا و پایین را روی تایم‌فریم چارت و تا سه تایم‌فریم بالاتر (به‌طور پیش‌فرض ۴ ساعته، روزانه و هفتگی) به‌صورت پرتوهای افقی (horizontal ray) از کندل پیوت تا لبهٔ راست چارت رسم می‌کند. هدف اصلی این است که سطوح کلیدی قیمت بدون به‌هم‌ریختن مقیاس خودکار (auto-scale) چارت، همیشه در دید معامله‌گر باقی بمانند و هر سطح تنها زمانی نمایش داده شود که داخل محدودهٔ قیمتی کندل‌های روی صفحه یا نزدیک به قیمت فعلی (بر اساس ATR) باشد.

هر پیوت به‌محض اینکه قیمت از آن عبور کند (بر اساس بسته‌شدن کندل یا لمس سایه، بسته به تنظیمات) از مجموعهٔ سطوح زنده حذف می‌شود و به لیست «شکسته‌شده‌ها» می‌رود. آخرین شکست به‌صورت یک پرتو خط‌چین (dashed) و کم‌رنگ‌تر روی چارت می‌ماند تا سطحی که تازه از دست رفته یا بازپس گرفته شده همچنان قابل مشاهده باشد. این پرتو خط‌چین به‌طور پیش‌فرض در بستهٔ زمانی روزانه (یا هر تایم‌فریمی که کاربر انتخاب کند) منقضی می‌شود و تعداد شکست‌های نگه‌داری‌شده نیز قابل تنظیم است. مجموعهٔ کل پرتوها در هر تیک از آخرین کندل بازسازی می‌شود، بنابراین پرتوها با حرکت قیمت ظاهر و ناپدید می‌شوند.

یکی از ویژگی‌های کلیدی این اندیکاتور، ادغام پیوت‌هایی است که در یک قیمت مشترک روی چند تایم‌فریم قرار می‌گیرند. مثلاً یک پیوت روزانه تقریباً همیشه یک پیوت ۴ ساعته و یک پیوت چارت هم هست؛ این اندیکاتور آن‌ها را در یک پرتو واحد با برچسبی که همهٔ تایم‌فریم‌ها را نشان می‌دهد (مثل «W D 4H») ترکیب می‌کند. پرتو از پایین‌ترین تایم‌فریم گروه شروع می‌شود چون پیوت تایم‌فریم بالاتر فقط تا دقت کندل خودش شناخته شده است. همچنین سقف تاریخی (ATH) به‌صورت یک پرتو نقطه‌چین (dotted) ضخیم‌تر با برچسب ATH رسم می‌شود که از تاریخچهٔ کامل ماهانهٔ نماد استخراج می‌گردد، نه فقط کندل‌های بارگذاری‌شده روی چارت.

کاربر می‌تواند انتخاب کند که پیوت‌ها بر اساس «محدودهٔ قیمتی قابل مشاهده»، «در فاصلهٔ N برابر ATR از قیمت» یا «هر دو» نمایش داده شوند. حداکثر تعداد پرتوهای ترسیمی، تعداد پیوت‌های نگه‌داری‌شده در هر تایم‌فریم، و آستانهٔ ادغام پیوت‌ها بر اساس تیک نیز قابل تنظیم است. از نظر ظاهری، رنگ پرتوها به‌صورت خودکار از پس‌زمینهٔ چارت (تیره/روشن) یا به‌صورت دستی تعیین می‌شود، شفافیت پرتوهای زنده و شکسته‌شده جداگانه قابل کنترل است، و برچسب‌ها می‌توانند در محل پیوت یا لبهٔ راست چارت قرار بگیرند و حتی قیمت را نیز نمایش دهند. ضخامت و رنگ هر تایم‌فریم نیز به‌صورت جداگانه قابل شخصی‌سازی است.

از نظر فنی، پیوت‌های تایم‌فریم بالاتر از طریق request.security با lookahead=barmerge.lookahead_on روی کندل قبلی HTF دریافت می‌شوند که فرم استاندارد و بدون ریپینت است: پیوت تنها پس از بسته‌شدن کندل تأییدکنندهٔ HTF ذخیره می‌شود و پرتو از زمان باز شدن همان کندل شروع می‌گردد. محاسبهٔ محدودهٔ قیمتی قابل مشاهده از خود کندل‌ها (نه از ترسیمات) انجام می‌شود تا بازخوردی بین آنچه رسم می‌شود و مقیاس چارت ایجاد نشود. سقف تاریخی نیز با ترکیب بیشترین قیمت بارگذاری‌شده روی چارت و سری ماهانهٔ کامل نماد محاسبه می‌گردد تا حتی روی چارت ۵ دقیقه‌ای نیز ATH واقعی نمایش داده شود. در نهایت، تمام ترسیمات فقط روی آخرین کندل (barstate.islast) بازسازی می‌شوند تا عملکرد چارت روان باقی بماند.

تنظیمات اندیکاتور Pivot Rays [BMT]

Theme این تنظیم ظاهر کلی رنگ‌های اندیکاتور را کنترل می‌کند و چهار حالت دارد: Auto (chart) که از پس‌زمینه چارت روشنایی را تشخیص می‌دهد و رنگ مناسب را انتخاب می‌کند، Dark و Light که به‌صورت دستی تم تیره یا روشن را تحمیل می‌کنند، و Custom که رنگ‌های دلخواه کاربر را برای خطوط، ATH و برچسب‌ها به کار می‌برد.

Custom ray colour رنگ دلخواه پرتوهای سطوح پیوت را وقتی حالت Custom فعال باشد تعیین می‌کند و در غیر این صورت نادیده گرفته می‌شود.

Custom ATH colour رنگ دلخواه پرتوی سقف تاریخی (ATH) را در حالت Custom مشخص می‌کند و اگر تم خودکار یا تیره/روشن انتخاب شده باشد اثری ندارد.

Custom label colour رنگ دلخواه متن برچسب‌های کنار پرتوها را در حالت Custom تنظیم می‌کند و فقط زمانی فعال است که Theme روی Custom باشد.

Ray transparency میزان شفافیت پرتوهای زنده را با عددی بین ۰ تا ۹۰ تعیین می‌کند که عدد بزرگ‌تر به معنی محوتر شدن خطوط است.

extra for broken میزان شفافیت اضافی پرتوهای شکسته (dashed) را نسبت به پرتوهای زنده مشخص می‌کند تا سطحی که به‌تازگی از دست رفته کم‌رنگ‌تر دیده شود.

Show pivots فیلتر انتخاب پیوت‌ها را تعیین می‌کند و سه گزینه دارد: Visible price range که فقط سطوح داخل محدوده قیمتی قابل‌مشاهده را نشان می‌دهد، Within N ATR که سطوح نزدیک به قیمت جاری را می‌آورد، و Both که هر دو شرط را همزمان اعمال می‌کند.

ATR length طول دوره محاسبه ATR را برای فیلتر Within N ATR مشخص می‌کند و وقتی حالت Visible price range انتخاب شده باشد غیرفعال است.

x ATR ضریب فاصله از قیمت جاری را بر حسب ATR تعیین می‌کند و هر پیوتی که در این محدوده نباشد فیلتر می‌شود.

Max rays drawn حداکثر تعداد پرتوهای قابل‌رسم را محدود می‌کند و اگر پیوت‌های واجد شرط بیشتر باشند، نزدیک‌ترین‌ها به قیمت نگه داشته می‌شوند.

Bars left تعداد کندل‌های سمت چپ را برای تأیید پیوت مشخص می‌کند؛ یک سقف وقتی پیوت است که هیچ کندلی به این تعداد در سمت چپ از آن بالاتر نباشد.

right تعداد کندل‌های سمت راست برای تأیید پیوت را تعیین می‌کند و همین قانون برای سقف و کف اعمال می‌شود.

Pivot highs فعال یا غیرفعال کردن نمایش پرتوهای پیوت سقف را کنترل می‌کند.

Pivot lows فعال یا غیرفعال کردن نمایش پرتوهای پیوت کف را کنترل می‌کند.

Pivots kept per timeframe تعداد پیوت‌های ذخیره‌شده برای هر تایم‌فریم را تعیین می‌کند و قدیمی‌ترها پس از رسیدن به این تعداد حذف می‌شوند.

Merge pivots within (ticks) پیوت‌های هم‌قیمت از تایم‌فریم‌های مختلف را در محدوده مشخصی از تیک‌ها با هم ادغام می‌کند تا یک پرتو با برچسب همه تایم‌فریم‌ها ساخته شود.

A pivot is broken on معیار شکستن پیوت را تعیین می‌کند؛ Close یعنی بسته شدن کندل فراتر از سطح و Wick یعنی هر معامله‌ای فراتر از آن.

keep the last تعداد آخرین رویدادهای شکست را مشخص می‌کند که به‌صورت پرتوهای خط‌چین باقی می‌مانند و عدد صفر یعنی هیچ‌کدام نگه داشته نشوند.

Most recent break stays on as a dashed ray فعال یا غیرفعال کردن نمایش آخرین شکست به‌صورت پرتو خط‌چین کم‌رنگ را کنترل می‌کند و معادل تنظیم عدد keep the last روی صفر است.

and is dropped at the close of فعال کردن انقضای پرتوهای شکسته در پایان دوره مشخص‌شده را کنترل می‌کند.

Timeframe (expire) تایم‌فریمی را تعیین می‌کند که پرتو خط‌چین در بسته شدن آن حذف می‌شود؛ مثلاً شکست در سشن سه‌شنبه در بسته شدن روزانه همان روز پاک می‌شود.

Chart timeframe فعال یا غیرفعال کردن نمایش پیوت‌های تایم‌فریم خود چارت را کنترل می‌کند.

tag (chart) متن برچسب کنار پرتوهای تایم‌فریم چارت را تعیین می‌کند و خالی بودن آن یعنی بدون برچسب.

width (chart) ضخامت خط پرتوهای تایم‌فریم چارت را مشخص می‌کند.

Higher timeframe 1 فعال یا غیرفعال کردن ردیف اول تایم‌فریم بالاتر را کنترل می‌کند.

Timeframe (HTF1) تایم‌فریم ردیف اول را تعیین می‌کند که به‌صورت پیش‌فرض ۲۴۰ دقیقه (۴ ساعته) است.

tag (HTF1) متن برچسب ردیف اول را مشخص می‌کند که پیش‌فرض 4H است.

width (HTF1) ضخامت خط پرتوهای ردیف اول را تعیین می‌کند.

Higher timeframe 2 فعال یا غیرفعال کردن ردیف دوم تایم‌فریم بالاتر را کنترل می‌کند.

Timeframe (HTF2) تایم‌فریم ردیف دوم را تعیین می‌کند که پیش‌فرض روزانه (D) است.

tag (HTF2) متن برچسب ردیف دوم را مشخص می‌کند که پیش‌فرض D است.

width (HTF2) ضخامت خط پرتوهای ردیف دوم را تعیین می‌کند.

Higher timeframe 3 فعال یا غیرفعال کردن ردیف سوم تایم‌فریم بالاتر را کنترل می‌کند.

Timeframe (HTF3) تایم‌فریم ردیف سوم را تعیین می‌کند که پیش‌فرض هفتگی (W) است.

tag (HTF3) متن برچسب ردیف سوم را مشخص می‌کند که پیش‌فرض W است.

width (HTF3) ضخامت خط پرتوهای ردیف سوم را تعیین می‌کند.

Show ATH ray فعال یا غیرفعال کردن نمایش پرتوی سقف تاریخی را کنترل می‌کند که به‌صورت نقطه‌چین و ضخیم‌تر رسم می‌شود.

ignore the filter باعث می‌شود پرتوی ATH بدون توجه به فیلترهای محدوده قیمتی همیشه نمایش داده شود.

Source (ATH) منبع محاسبه سقف تاریخی را تعیین می‌کند؛ Full history از سری ماهانه کل تاریخچه نماد استفاده می‌کند و Loaded bars فقط از داده‌های بارگذاری‌شده چارت.

tag (ATH) متن برچسب پرتوی سقف تاریخی را مشخص می‌کند که پیش‌فرض ATH است.

width (ATH) ضخامت خط پرتوی سقف تاریخی را تعیین می‌کند.

Position (labels) محل قرارگیری برچسب‌ها را تعیین می‌کند؛ Pivot یعنی کنار کندل سازنده پیوت و Right edge یعنی کنار لبه راست چارت.

Right edge (bars past the last bar) فاصله برچسب از آخرین کندل را بر حسب تعداد کندل تعیین می‌کند و فقط وقتی Position روی Right edge باشد فعال است.

Size (labels) اندازه فونت برچسب‌ها را از tiny تا huge مشخص می‌کند. Append the price to the tag فعال یا غیرفعال کردن افزودن قیمت به متن برچسب را کنترل می‌کند.