Performance indicator

概要
Performance Indicator は、構成可能な時間間隔にわたる複数のシンボルのパーセントリターンをヒートマップで表示します。相対的な強さと弱さを視覚的に比較するためのもので、結果を保証するものではありません。

設定
SymbolsList: カンマ区切りのシンボル。ターミナルの名前と正確に一致する必要があります。
BaseTF: 計算の基準タイムフレーム。
UpdateSeconds: 自動更新の間隔（秒）。
CapPercent: 色の強度を正規化する値。
PeriodsList: 表示する期間を定義する文字列（例：D1, W1, M1, M3, M6, Y1, YTD）。1M, 2W, YTD のような形式を受け付けます。

リターン計算
Standard periods: 現在の終値と N 期間前の終値を比較。
YTD: 一貫した比較のために、現在の年の始まりに最も近い終値を使用。

視覚的エンコーディング
背景: 非負のリターンは緑、負のリターンは赤。強度は CapPercent でスケーリング。
テキスト: リターンが ≥ 0 の場合は緑、負の場合は赤、データがない場合は灰色。二重のエンコーディングにより可読性を確保。

更新メカニズム
UpdateSeconds で定義された経過時間をタイマーが確認し、許可された場合のみマップを再構築。過度な更新を防ぐ内部の保護機構があります。

ユースケース

• 複数の時間軸で異なる資産を比較。

• ポートフォリオを監視し、相対的な強さの変化を検出。

• 異なる視点を試すためにリアルタイムで PeriodsList を変更。

例
PeriodsList: "D1,1W,3M,YTD" — 日次、週次、3か月、年初来。

注意

• シンボルはターミナルに存在する必要があります。

• 更新が頻繁すぎると内部で制限されるため、大きなリストを使う際は UpdateSeconds を慎重に調整してください。