🔧 ATR_RR_SignalPanel — 技術的かつ詳細な説明（EN）🧠📈
ATR_RR_SignalPanel は cTrader 用の オーバーレイインジケーター で、トレンド変化のエントリーシグナル を 高速EMA対低速EMAのレジーム を使って生成し、次に 完全な仮想取引フレームワーク（エントリー 🏁、ストップロス 🛑、最終利確 🎯、中間ターゲット 🟢）を ATRベースのリスクサイズ と設定可能な リスク：リワード 乗数 ⚖️ を使って構築します。
🧭 コアロジック（シグナルエンジン）🚦
- インジケーターは以下を計算します：
-
- 高速EMA ⚡ と 低速EMA 🐢 を 終値 で。
- ATR（ワイルダー平滑化） 🌡️ ボラティリティに基づくストップ距離のため。
- トレンドレジーム は以下のように定義されます：
-
- ブルトレンド 🟢 は
高速EMA > 低速EMA - ベアトレンド 🔴 は
高速EMA < 低速EMA
- ブルトレンド 🟢 は
- トレンドチェンジ 🔁 はブル／ベアの状態が 前のバーと異なるときに発生します（Pine の
bullTrend != bullTrend[1]に相当）。
🎯 エントリー条件（買い／売り）🟩🟥
トレンド変化が発生したとき：
- 買いシグナル 🟢 は以下の場合：
-
- ブルトレンドが有効で かつ トレンド変化が検出されたとき
- オプションのローソク足確認 ✅：終値 > 始値（強気ローソク足）
- 売りシグナル 🔴 は以下の場合：
-
- ベアトレンドが有効で かつ トレンド変化が検出されたとき
- オプションのローソク足確認 ✅：終値 < 始値（弱気ローソク足）
🧪 仮想ポジション管理（cBot ではありません）🧩
このインジケーターは 注文を出しません。代わりに内部の「仮想ポジション」をシミュレートします：
- 新しい買い／売りシグナルで以下を設定します：
-
- エントリー価格 = 現在の終値 🏁
- ストップロス = ローソク足の極値 ± ATR × 乗数 🛑
- 最終利確 = エントリー ±（リスク × リスクリワード）🎯
- 中間TPレベル = 1R、2R、… floor(RR)-1 までのステップ 🟢
- バーごとに価格動向を監視します：
-
- もし 最終TP に到達したら ➜ 🎯 をマークし仮想ポジションをクローズ ✅
- もし SL に到達したら ➜ 🛑 をマークし仮想ポジションをクローズ ❌
- 中間TPのヒットは 一度だけ 追跡されます 🧷
🔁 無効化ロジック（アクティブ中の反対シグナル）⚠️
反対方向の仮想取引が存在する間に新しいシグナルが来た場合：
- 前のエントリーは 無効化済み とマークされます ⚠️（INV BUY / INV SELL）
- 前の仮想ポジションは終了されます 🧯
- 新しい方向で新たな仮想ポジションが作成されます 🔄
🧼 マルチインスタンス安全（同一チャート上の複数コピー）🧩🧩
各インジケーターインスタンスはユニークな内部ID 🆔 を生成するため：
- あるインスタンスのラインやテキストは 他のインスタンスを上書きしません ✅
- 複数の設定を並行して実行可能（例：スキャルピング＋スイング）🧠📊
🧯 散らかり防止コントロール（マーカー制限）🧹✨
チャートを見やすく保つために、以下が可能です：
- 描画されるテキストマーカーの数を制限（BUY/SELL/TP/SL/INV/TP1…）🧾
- 制限を超えた場合は古いマーカーを自動削除 ♻️
🧷 オプション「最後のリスクラインを保持」🧠📌
有効にすると、最後のエントリー／SL／TPラインが TP/SLクローズ後も表示されます：
- トレード後のレビューに最適 🧑🔬
- ジャーナリングに最適 📒✅
⚙️ パラメーター — 詳細説明（EN）🔍📌
📈 シグナル＆リスクのコア
⚡ 高速EMA
- 役割 🧠： レジームシフト検出に使う高速EMAの期間を設定します。
- 効果 📊： 値が小さいほど反応が速く ➜ シグナル多め；大きいほど滑らかで ➜ シグナル少なめ。
- 典型的な範囲 🎛️： 高速市場向けは3–10 ⚡、落ち着いた設定は10–20 🐢
🐢 低速EMA
- 役割 🧠： トレンドの基準線として使う低速EMAの期間を設定します。
- 効果 📊： 低速EMAが大きいほどフィルタリングが強くなり ➜ トレンド変化のトリガーが減少。
- 典型的な範囲 🎛️： スタイルにより13–55 🧭
🌡️ ATR期間
- 役割 🧠： ATRのボラティリティ測定の長さを制御します。
- 効果 📏： 短いATRは速く反応（タイトなSL）、長いATRは安定（安定したSL）。
- 典型的な範囲 🎛️： 10–21 が一般的 ✅
🛑 SL乗数（ATR）
- 役割 🧠： ストップロス距離をATR単位で定義します。
- ロング 🟢：
SL = Low - ATR * Mult - ショート 🔴：
SL = High + ATR * Mult - 効果 🎯： 乗数が大きいほどSLは広く（ストップ少なめ、リスク大きめ）、小さいほどSLはタイト（ストップ多め）。
- 典型的な値 🎛️： ボラティリティにより0.3–2.0 🌪️
⚖️ リスク：リワード（R:R）
- 役割 🧠： 「リスク」距離に乗数をかけて最終TPを計算します。
- 式 📌：
-
- リスク = |エントリー − SL|
- 最終TP = エントリー ± リスク × RR 🎯
- 中間TP 🟢： TP1は1R、TP2は2R、… 最大
floor(RR)-1 - 例 🧪： RR=3 ➜ TP1 (1R)、TP2 (2R)、最終TP (3R) 🎯🎯🎯
✅ ローソク足確認を要求
- 役割 🧠： シグナルバーでローソク足の方向検証を追加します。
- 買い 🟢： 終値 > 始値が必要
- 売り 🔴： 終値 < 始値が必要
- 効果 🧽： 弱い反転を除外し、ノイズを減らし、エントリーが遅れる可能性あり ⏳
📌 EMA表示
👁️ 高速EMAを表示
- 役割 🧠： 高速EMAラインの表示／非表示を切り替えます。
- 使用例 💡： クリーンなチャートにしたい場合は非表示に 🧼
👁️ 低速EMAを表示
- 役割 🧠： 低速EMAラインの表示／非表示を切り替えます。
- 使用例 💡： トレンドの文脈を把握するために表示を維持 🧭
🎛️ ビジュアルコントロール（散らかり管理）🧹✨
🚦 シグナルを表示
- 役割 🧠： 買い／売りマーカーの表示／非表示を切り替えます。
- 含まれるもの 🧷： 買い 🟢 / 売り 🔴 マーカー（のみ）
- ヒント 💡： 「ラインのみ」モードのときは無効に 📏
🏷️ TPラベルを表示
- 役割 🧠： TP1、TP2などのラベルの表示／非表示を切り替えます。
- 効果 🧼： OFFにすると高タイムフレームでのテキストノイズが大幅に減少 📉
- 注意 🧷： ラベルはTPヒットごとに一度だけ表示されます ✅
⚠️ 無効化マークを表示
- 役割 🧠： INV BUY / INV SELL マーカーの表示／非表示を切り替えます。
- 使用例 🧠： シグナルの反転を研究したいときに便利です 🔁
🎯🛑 最終TP/SLマークを表示
- 役割 🧠： 最終TPおよびSLマーカーの表示／非表示を切り替えます。
- 使用例 📒： 結果の分布をレビューするのに最適です 🎲
📏 リスクラインを表示（エントリー／SL／TP）
- 役割 🧠： チャート上にエントリー 🏁、SL 🛑、最終TP 🎯 ラインを描画します。
- 効果 📌： 仮想取引構造を即座に視覚化します 🧠
🟢 中間TPラインを表示
- 役割 🧠： TP1／TP2／… レベルの点線を描画します。
- ヒント 🧼： チャートが「緑のスパゲッティ」になりすぎる場合は無効に 🍝🟢
📌 最後のリスクラインを保持
- 役割 🧠： 仮想終了（TP/SL）後も最後のエントリー／SL／TPラインを表示し続けます。
- 有用性 📒： ジャーナリングやトレード後分析に最適 🧑🔬✅
🧾 チャート上の最大マーカー数（0=無制限）
- 役割 🧠： インジケーターがチャート上に残すテキストオブジェクトの数を制限します。
- 動作 ♻️： 制限を超えると最も古いマーカーが自動的に削除されます。
- 推奨 🎛️： タイムフレームと履歴の深さにより80–200 🕰️
🧾 情報パネルを表示
- 役割 🧠： チャート上にコンパクトなステータスパネルを表示します。
- 表示内容 📋： ステータス（ロング／ショート／ポジションなし）、エントリー、SL、TP、計算されたRR。
