VibeFox Zscore Revert
- インディケータ
- バージョン: 1.0
- アクティベーション: 5
VibeFox Zscore Revert — 自動エントリーポイント付きの Z-score 平均回帰チャネル
VibeFox Zscore Revert は、MetaTrader 5 向けのリアルタイム平均回帰インジケーターです。価格が移動平均からどれだけ乖離したかを標準偏差の単位で測定し——おなじみの Z-score——価格チャート上に直接、3 本のラインからなるチャネルを描画します。中央の平均ライン 1 本と、選択した標準偏差の数だけ離して配置された外側の 2 本のバンドです。価格が伸びきって外側のバンドにタッチし、その後バンド内に戻って引けると、インジケーターは価格が中心へと跳ね返ることを見込んで平均回帰エントリーをマークします。すべてのコントロールは、モダンでインタラクティブな 1 枚のパネルにまとめられています。
インジケーターの仕組み
エンジンは終値に関する 2 つの標準的な統計量の上に構築されています。mean（mu）は Period 設定にわたる単純移動平均であり——これが中央ラインで、価格が回帰すると見込まれる値です。standard deviation（sigma）は Deviation Period にわたって計算され、その平均の周りで価格がどれだけ変動しているかを測ります。任意のバーの Z-score は単純に Z = (price − mu) / sigma です。すなわち、価格の平均からの正規化された距離を標準偏差で表したものです。
外側のバンドは Threshold で設定された固定の Z-score に配置されます。上バンドは mu + k·sigma に、下バンドは mu − k·sigma に位置し、k は sigma 単位でのしきい値です。価格が外側のバンドにタッチすると、その Z-score は +/-k に達しています——統計的に引き伸ばされ、過度に伸びた状態であり、ここから平均回帰が見込まれます。3 つのバンド値はライン オブジェクトとして価格チャート上に直接描画され、一方インジケーター自体はコントロールパネルが置かれる独自のサブウィンドウに存在します。
平均回帰のロジック
平均回帰とは、価格がその平均から異常に大きく乖離した後、その平均へと戻る傾向があるという考え方です。Z-score はこれを正確で単位のない尺度に変えます。Z がゼロから離れるほど価格は引き伸ばされており、中央ラインへ引き戻す力も強くなります。
インジケーターは、価格がチャネル内に戻って引けることで反転を確認したときにのみ、バンドタッチをエントリーへと変換します。Revert BUY は、あるバーの安値が下バンドを突き抜け（Z が −k に達し）ながらも、そのバーがそれより上に戻って引けたときに発生します——下方向への伸びが否定され、平均へ向けた上昇が見込まれます。Revert SELL はその鏡像です。あるバーの高値が上バンドを突き抜け（Z が +k に達し）ながらも、そのバーがそれより下に戻って引けたとき——上方向への伸びが否定され、平均へ向けた下落が見込まれます。シグナルは確定したバーでのみ評価され、形成中のバーは無視されるため、マーカーは一度配置されると決してリペイントしません。
エントリーポイント
VibeFox Zscore Revert の主な価値は、その自動エントリーにあります。確定したバーで回帰が確認されると、インジケーターは価格チャート上に直接、明確なマーカーを配置します。この動作は Revert トグルで制御され、平均回帰エントリー（下バンドでの BUY と上バンドでの SELL の両方）を有効にします。これをオフにすれば、マーカーを一切表示せず、チャネルだけを画面に残せます。
買いと売りのマーカーは Buy と Sell のカラー設定で個別に色分けされるため、方向が瞬時に読み取れます。Marker セレクターは字形を単純な十字（+）、塗りつぶし三角形、または尾付き矢印の間で切り替え、Size コントロールはマーカーをピクセル単位（6 から 40）でスケーリングして、あらゆるチャート密度に合わせます。
完全なビジュアル制御
3 本のバンドラインは個別に色分けされます。平均ラインには Middle、上バンドには Upper、下バンドには Lower を用い、3 本すべての太さは Width で 1 から 5 ピクセルの範囲で設定します。各バンドラインと両方のエントリーマーカーは、カラーピッカーのポップアップで透過設定（0-100%）に対応しているため、チャート背景にやわらかく溶け込ませることも、くっきりと目立たせることもできます。
チャート上のインタラクティブなパネル
インターフェース全体が、素早いマウス操作のために作られた、キャンバスベースの滑らかなパネルです。Z-score パラメーターは整然とした行にまとめられ、エントリーブロックは独自の金色の ENTRY 見出しで区切られているため、シグナル設定がライン設定と混ざることはありません。パネルのヘッダーにはコントロールアイコンが並んでいます。
Power — インジケーターをチャートから取り除くことなく、エントリーマーカーの描画をオン・オフします。
Settings (gear) — 設定セクションを開閉します。
Updown (arrows) — パネルをサブウィンドウとメインチャートの間で移動します。
Close (cross) — インジケーターを閉じます。
Resizable — 右下隅をドラッグしてパネルをスケーリングします。
Collapsible — ヘッダーをダブルクリックすると、パネルがコンパクトな帯状に折りたたまれます。
Mouse wheel — 任意の数値フィールドにカーソルを合わせてホイールをスクロールすると、キーボードを開かずに値を変更できます。
設定とパーソナライズ
Settings ボタンは、パネルをあなたの作業環境に合わせるセクションを開きます。ライト、ダーク、または自動の Theme、調整可能なパネル幅、ヘッダーサイズ、行の高さ、フォントサイズなどです。さらなる工夫として、Hide Footer で下部バーを隠し、Mini Header で折りたたみ時にヘッダーを縮小し、パネルの外側をクリックしたときに自動で折りたたむことができます。ほぼすべてのパラメーターはパネル上で直接ライブに変更され——Inputs タブの入力フィールドは開始値を設定するだけです。また、各コピーに固有の Instance を与えることで、1 つのチャート上で複数の独立したコピーを実行し、異なる設定を並べて比較することもできます。
エントリー通知
回帰を待ってチャートを見張り続ける必要はありません。各エントリーは、パネル上で個別に有効化できる複数の通知チャネルを通じて送信できます。
Alert — ターミナル内部のポップアップメッセージ。
Push — お使いのスマートフォンの MetaTrader アプリへのモバイル通知。
Email — ターミナルのメール設定を通じて送信される 1 通のメール。
Telegram — アラートのテキストとチャートのスクリーンショットを合わせて、あなたの Telegram チャットへ直接送信。
必要なチャネルだけを有効にしておけば、あなたが取り組んでいる銘柄と時間足に新しい回帰エントリーが現れた瞬間に通知が届きます。
ビジュアル履歴（HTML レポート）
Html チャネルを有効にすると、すべてのエントリーシグナルが、それが発生した瞬間のチャートのスクリーンショットとともに HTML レポートに保存されます。レポートはターミナルの Files フォルダ内、VibeFox_Zscore_Revert ディレクトリ（MQL5/Files/VibeFox_Zscore_Revert/result.html）に保存され、任意のブラウザで開けます——インジケーターが見つけたすべての回帰のビジュアルなログが得られます。ワンクリックのゴミ箱ボタンで、やり直したいときにいつでもレポートとそのスクリーンショットを消去できます。
Telegram アラート
シグナルはあなたの Telegram チャットへ直接届けることもできます——アラートのテキストと、検出の瞬間のチャートのスクリーンショットを合わせて。Telegram チャネルをオンにして、入力欄にあなたの bot token と chat id を入力してください。
配信は HTML レポートに乗って行われます。新しいシグナルはそれぞれレポートに書き込まれ、ブラウザで開かれたレポートが自らそれをあなたの Telegram チャットへ転送します。このため、Telegram を有効にすると Html レポートが自動的にオンのまま保たれ、2 つのチャネルは連携して動作します。
内蔵の多言語ヘルプ
完全なヘルプページがパネルに内蔵されており、複数の言語で利用できるため、すべてのコントロールが、あなたがそれを使うまさにその場所で解説されます。
パラメーター（Inputs タブ）
ほとんどの設定はパネル上（Settings ボタン）でもライブに変更できます——入力パラメーターは起動時の初期値を設定するだけです。
Zscore Revert
Period (SMA mean / mu) — 平均（中央ライン）として使われる単純移動平均の期間。デフォルト：20。
Deviation Period (sigma) — バンドの幅を決めるために使われる標準偏差の期間。デフォルト：20。
Threshold (Z-score, k sigma) — 標準偏差単位でのバンド距離。バンドは mu +/- k·sigma に位置します。デフォルト：2.0。
Bars of history to process — チャネルとエントリーを何本前のバーまで計算するか、0 = 利用可能なすべて。デフォルト：200。
Middle Line Color — 平均ラインの色。デフォルト：DodgerBlue。
Middle Line Transparency — 平均ラインの透過度、パーセント、0-100。デフォルト：0。
Upper Band Color — 上バンドの色。デフォルト：OrangeRed。
Upper Band Transparency — 上バンドの透過度、パーセント、0-100。デフォルト：0。
Lower Band Color — 下バンドの色。デフォルト：OrangeRed。
Lower Band Transparency — 下バンドの透過度、パーセント、0-100。デフォルト：0。
Line Width — バンドラインの太さ、ピクセル単位、1..5。デフォルト：1。
Entry Points
Revert (return to mean from a band) — 平均回帰エントリーを有効にします（下バンドで BUY、上バンドで 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。
Notifications
Push Notification — MetaTrader モバイルアプリへのプッシュアラートを有効にします。デフォルト：オフ。
Alert Popup — ターミナル内部のポップアップアラートを有効にします。デフォルト：オフ。
Email — ターミナルのメール設定を通じたメールアラートを有効にします。デフォルト：オフ。
Html Report — 各シグナルをチャートのスクリーンショットとともに Files/VibeFox_Zscore_Revert/result.html に保存します。デフォルト：オフ。
Telegram — HTML レポート経由で、シグナルをチャートのスクリーンショットとともに Telegram チャットへ転送します。デフォルト：オフ。
Telegram - bot token — 配信に使われる Telegram bot の token。デフォルト：空。
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。
