VibeFox Pesavento MT5 — ヘルプ
VibeFox Pesavento — スイングレッグのフィボナッチ ratio 分析とエントリーポイント
VibeFox Pesavento は MetaTrader 5 向けのリアルタイム・スイング構造インジケーターで、Pesavento の Fibonacci ratio 手法を市場に適用します。価格から ZigZag を構築し、スイング構造のすべてのレッグを測定し、各レッグに前のレッグとの ratio を表示し、主要な Fibonacci/Pesavento の ratio に一致するレッグを強調表示し、エントリーシグナルをチャート上に直接マークします。リトレースメントを手作業で測る代わりに、各値動きの比率と反転レベルが形成されるその瞬間に確認でき、それらすべてが1つのモダンでインタラクティブなパネルにまとめられています。
インジケーターの仕組み
まずインジケーターは、古典的な ZigZag アルゴリズムを使って価格の重要な転換点 — スイングの高値（ピーク）とスイングの安値（トラフ） — を検出します。構築は3つのパラメーターで制御されます。Depth は2つのピボット間の最小バー数を設定し、構造が小さな揺れを無視して十分に長く続く値動きにのみ反応するようにします。Deviation は新しいピボットを記録するために必要な反転の最小サイズで、浅い押し戻しを除外します。Backstep は同種の2つの極値の間の最小バー数で、2つのピーク（または2つのトラフ）が近づきすぎるのを防ぎます。これらを組み合わせることで、スイング検出を高速で詳細な構造から、主要なスイングのみを表示する低速な構造まで調整できます。
スイングレッグは価格チャート上にライン オブジェクトとして直接描画され、一方でインジケーター自体はコントロールパネルが置かれる専用のサブウィンドウに表示されます。Bars 設定は処理される履歴の量を制限します。利用可能なすべてのバーをスキャンするには 0 に設定し、重いチャートでの再描画を高速化するにはより小さい値を使用します。
Pesavento の ratio 分析
スイングのピボットが判明すると、インジケーターは構造をレッグに分割します。各レッグは連続する2つのピボットを結びます。各レッグについて Pesavento の ratio を計算します。これは現在のレッグの長さを前のレッグの長さで割った値です。この ratio は値動きの比率 — 価格が前のスイングに対してどれだけリトレースしたか、または延長したか — を表します。ratio（例えば 0.618）を示すラベルが各レッグの中点に描画されるため、構造のジオメトリが一目でわかります。
ratio が主要な Fibonacci/Pesavento 値に一致するレッグは、High（Highlight）の色で強調表示されます。主要な ratio は 0.382, 0.500, 0.618, 0.786, 1.000, 1.272, 1.618 と 2.618 です。レッグはその ratio がこれらの値のいずれかから Tolerance の距離内にあるときに一致とみなされます。tolerance は絶対値なので、一致を厳密にも緩やかにも設定できます。これらの強調表示されたレッグは、Pesavento トレーダーが探しているハーモニックな値動き、つまり Fibonacci グリッドに従うリトレースメントと延長です。
エントリーポイント
VibeFox Pesavento の主な価値は、自動的なエントリーポイントです。スイングが主要な反転 ratio で完成するたびに、明確なマーカーが価格チャート上に配置されます。レッグはその ratio が前のレッグの主要なリトレースメント値 0.618 または 0.786 に一致するとき、反転の可能性が高いと扱われます。その比率では、前の値動きは通常勢いを使い果たしています。
レッグが主要な反転 ratio で確定したスイング安値で終わると、BUY マーカーがバーの下に配置されます。下落の値動きが反転ゾーンまでリトレースし、価格が上昇に転じています。レッグが主要な反転 ratio で確定したスイング高値で終わると、SELL マーカーがバーの上に表示されます。上昇の値動きが勢いを使い果たし、価格が下落に転じています。2つの方向は Buy と Sell のスイッチで個別に切り替えられます。
買いと売りのマーカーは Buy Color と Sell Color の設定で別々に色付けされるため、方向を瞬時に読み取れます。Marker セレクターはグリフをプレーンなクロス（+）、塗りつぶしの三角形、または尾付きの矢印の間で切り替え、Size コントロールはマーカーをピクセル単位（6〜40）でスケーリングして、あらゆるチャートの密度に合わせます。
完全なビジュアル制御
レッグのラインの色は Zigzag Line Color で、太さは Line Width で1〜5ピクセルに設定します。主要な ratio に一致するレッグは Key-ratio Highlight Color で塗られます。ライン、ハイライト、両方のエントリーマーカーは、それぞれカラーピッカーのポップアップで透明度設定（0〜100%）をサポートしているため、チャートの背景に柔らかく溶け込ませることができます。価格チャート上のマーカーはサイズと色が個別に設定されるため、エントリーがあらゆる背景に対してはっきりと際立ちます。
インタラクティブなチャート上パネル
インターフェース全体は、高速なマウス操作のために作られた滑らかなキャンバスベースのパネルです。スイングと ratio のパラメーターは整然とした行にまとめられ、エントリーブロックは独自のゴールド色の ENTRY 見出しで区切られているため、シグナル設定がライン設定と混ざることはありません。パネルのヘッダーにはコントロールアイコンが配置されています。
Power — インジケーターをチャートから取り除くことなく、エントリーマーカーの描画をオン・オフします。
Settings (gear) — 設定セクションを開閉します。
Updown (arrows) — パネルをサブウィンドウとメインチャートの間で移動します。
Close (cross) — インジケーターを閉じます。
Resizable — 右下隅をドラッグしてパネルをスケーリングします。
Collapsible — ヘッダーをダブルクリックすると、パネルがコンパクトなストリップに折りたたまれます。
Mouse wheel — 任意の数値フィールドにカーソルを合わせてホイールをスクロールすると、キーボードを開かずに値を変更できます。
設定とパーソナライズ
Settings ボタンは、パネルをワークスペースに合わせるセクションを開きます。明るい、暗い、または自動の Theme、調整可能なパネル幅、ヘッダーサイズ、行の高さ、フォントサイズ。さらなる工夫として、Hide Footer で下部バーを非表示にしたり、Mini Header で折りたたみ時にヘッダーを縮小したり、パネル外をクリックしたときにパネルを自動的に折りたたんだりできます。ほぼすべてのパラメーターはパネル上でライブに変更されます。Inputs タブの入力フィールドは開始値を設定するだけです。また、それぞれに固有の Instance を与えることで、1つのチャート上で複数の独立したコピーを実行し、異なる Pesavento 設定を並べて比較することもできます。
エントリー通知
シグナルを待ってチャートを見張り続ける必要はありません。各エントリーは、パネル上で個別に有効化できるいくつかの通知チャンネルを通じて送信できます。
Alert — ターミナル内のポップアップメッセージ。
Push — スマートフォンの MetaTrader アプリへのモバイル通知。
Email — ターミナルのメール設定を通じて送信される手紙。
Telegram — アラートのテキストとチャートのスクリーンショットを一緒に、あなたの Telegram チャットに直接送信。
必要なチャンネルだけを有効にすれば、作業中のシンボルと時間枠で新しいエントリーが現れた瞬間に通知されます。
ビジュアル履歴（HTML レポート）
Html チャンネルを有効にすると、すべてのエントリーシグナルが、発生した瞬間のチャートのスクリーンショットと一緒に HTML レポートに保存されます。レポートはターミナルの Files フォルダ内の VibeFox_Pesavento ディレクトリ（MQL5/Files/VibeFox_Pesavento/result.html）に保存され、任意のブラウザで開けます。インジケーターが見つけたすべてのエントリーのビジュアルログが得られます。ワンクリックのゴミ箱ボタンで、やり直したいときにいつでもレポートとそのスクリーンショットをクリアできます。
Telegram アラート
シグナルはあなたの Telegram チャットに直接配信することもできます。アラートのテキストと検出された瞬間のチャートのスクリーンショットが一緒に送られます。Telegram チャンネルをオンにして、bot トークンと chat id を入力に入力してください。
配信は HTML レポートに乗っています。各新規シグナルはレポートに書き込まれ、ブラウザで開かれたレポートが自動的にそれをあなたの Telegram チャットに転送します。このため、Telegram を有効にすると自動的に Html レポートがオンに保たれ、2つのチャンネルは連携して動作します。
組み込みの多言語ヘルプ
複数の言語で利用できる完全なヘルプページがパネルに組み込まれているため、すべてのコントロールが使用するその場で説明されます。
パラメーター（Inputs タブ）
ほとんどの設定はパネル上でライブに変更することもできます（Settings ボタン）。入力パラメーターは起動時の初期値を設定するだけです。
Pesavento（スイング）
Swing Depth — 2つのピボット間の最小バー数（2..100）。デフォルト: 12。
Swing Deviation — 新しいピボットのための最小反転サイズ（ポイント単位）。デフォルト: 5。
Swing Backstep — 2つの極値の間の最小バー数。デフォルト: 3。
Max legs drawn/labeled — 直近のレッグのうち、いくつを描画してラベル付けするか。デフォルト: 12。
Bars of history to process — スイングを計算する遡及範囲、0 = 利用可能なすべて。デフォルト: 500。
Key-ratio tolerance — レッグの ratio を主要値に一致させるための絶対許容差。デフォルト: 0.030。
Zigzag Line Color — 価格チャート上のレッグのラインの色。デフォルト: DodgerBlue。
Line Transparency — レッグのラインの透明度（パーセント）、0〜100。デフォルト: 0。
Key-ratio Highlight Color — 主要な ratio に一致するレッグの色。デフォルト: Gold。
Highlight Transparency — ハイライトの透明度（パーセント）、0〜100。デフォルト: 0。
Line Width — レッグのラインの太さ（ピクセル単位）、1..5。デフォルト: 1。
Entry Points
Buy signals (low @ key ratio) — 主要な反転 ratio での確定した安値ピボットで BUY マーカーを有効にします。デフォルト: オン。
Sell signals (high @ key ratio) — 主要な反転 ratio での確定した高値ピボットで SELL マーカーを有効にします。デフォルト: オン。
Marker Font Size — エントリーマーカーのサイズ（ピクセル単位）、6..40。デフォルト: 12。
Entry Marker — マーカーのグリフ: Cross（+）、Triangle、または Arrow。デフォルト: Arrow。
Buy Color — BUY マーカーの色。デフォルト: LimeGreen。
Buy Transparency — 買いマーカーの透明度（パーセント）、0〜100。デフォルト: 0。
Sell Color — SELL マーカーの色。デフォルト: Red。
Sell Transparency — 売りマーカーの透明度（パーセント）、0〜100。デフォルト: 0。
通知
Push Notification — MetaTrader モバイルアプリへのプッシュアラートを有効にします。デフォルト: オフ。
Alert Popup — ターミナル内のポップアップアラートを有効にします。デフォルト: オフ。
Email — ターミナルのメール設定を通じたメールアラートを有効にします。デフォルト: オフ。
Html Report — 各シグナルをチャートのスクリーンショットと一緒に Files/VibeFox_Pesavento/result.html に保存します。デフォルト: オフ。
Telegram — HTML レポートを介して、チャートのスクリーンショット付きのシグナルを Telegram チャットに転送します。デフォルト: オフ。
Telegram - bot token — 配信に使用される Telegram bot のトークン。デフォルト: 空。
Telegram - chat id — 対象の Telegram チャットの識別子。デフォルト: 空。
Panel / Settings
Panel width, px — チャート上パネルの幅（ピクセル単位）、300..800。デフォルト: 800。
Header size — パネルヘッダーの高さ、1..6。デフォルト: 1。
Theme — パネルのカラーテーマ: Light、Dark、または Auto。デフォルト: Auto。
Row height (px) — 各パラメーター行の高さ（ピクセル単位）。デフォルト: 34。
Font size — パネル内で使用されるフォントサイズ。デフォルト: 8。
Hide Footer — パネルの下部バーを非表示にします。デフォルト: オフ。
Mini Header on collapse — パネルが折りたたまれているときにコンパクトなヘッダーストリップを表示します。デフォルト: オフ。
Close on click outside — パネルの外をクリックしたときにパネルを自動的に折りたたみます。デフォルト: オフ。
Instance — 同じチャート上のインジケーターの各コピーに固有の番号で、複数のインスタンスを並べて実行できます。デフォルト: 1。
Panel Start Window — パネルの初期位置を設定します: メインチャートまたはサブウィンドウ。デフォルト: Subwindow。