// This source code is subject to the terms of the Mozilla Public License 2.0 at https://mozilla.org/MPL/2.0/ // © RicardoSantos //@version=5 indicator(title='Example: Graph style - 4th Dimension RSI') f_grad(_value) => _value >= 11 ? #0002A2 : _value == 10 ? #0045A9 : _value == 09 ? #008EB0 : _value == 08 ? #00B690 : _value == 07 ? #00BD4A : _value == 06 ? #01C400 : _value == 05 ? #52CA00 : _value == 04 ? #A8D100 : _value == 03 ? #D7AC00 : _value == 02 ? #DE5800 : _value == 01 ? #E50000 : color.white float feature01 = close - close[1] float feature02 = math.round(ta.rsi(close, 14)[1] * 10) int data_range = 10 int nclusters = 3 float[] X = array.new_float(data_range, feature01) float[] Y = array.new_float(data_range, feature02) for _i = 0 to data_range - 1 by 1 array.set(id=X, index=_i, value=feature01[_i]) array.set(id=Y, index=_i, value=feature02[_i]) plot(series=array.get(X, 0), color=f_grad(0), linewidth=10, style=plot.style_circles, offset=int(-1000 + array.get(Y, 0)), show_last=1) plot(series=array.get(X, 1), color=f_grad(1), linewidth=9, style=plot.style_circles, offset=int(-1000 + array.get(Y, 1)), show_last=1) plot(series=array.get(X, 2), color=f_grad(2), linewidth=8, style=plot.style_circles, offset=int(-1000 + array.get(Y, 2)), show_last=1) plot(series=array.get(X, 3), color=f_grad(3), linewidth=7, style=plot.style_circles, offset=int(-1000 + array.get(Y, 3)), show_last=1) plot(series=array.get(X, 4), color=f_grad(4), linewidth=6, style=plot.style_circles, offset=int(-1000 + array.get(Y, 4)), show_last=1) plot(series=array.get(X, 5), color=f_grad(5), linewidth=5, style=plot.style_circles, offset=int(-1000 + array.get(Y, 5)), show_last=1) plot(series=array.get(X, 6), color=f_grad(6), linewidth=4, style=plot.style_circles, offset=int(-1000 + array.get(Y, 6)), show_last=1) plot(series=array.get(X, 7), color=f_grad(7), linewidth=3, style=plot.style_circles, offset=int(-1000 + array.get(Y, 7)), show_last=1) plot(series=array.get(X, 8), color=f_grad(8), linewidth=2, style=plot.style_circles, offset=int(-1000 + array.get(Y, 8)), show_last=1) plot(series=array.get(X, 9), color=f_grad(9), linewidth=1, style=plot.style_circles, offset=int(-1000 + array.get(Y, 9)), show_last=1) // plot different shapes: // plotshape(series=array.get(X, 9), title='', style=shape.cross, location=location.absolute, color=f_grad(9), transp=25, offset=int(-1000+array.get(Y, 9)), size=size.normal, show_last=1) // plotshape(series=array.get(X, 5), title='', style=shape.diamond, location=location.absolute, color=f_grad(5), transp=25, offset=int(-1000+array.get(Y, 5)), size=size.normal, show_last=1) // not centered location //plotchar(series=array.get(X, 2), title='', char='*', location=location.absolute, color=f_grad(2), transp=25, offset=int(-1000+array.get(Y, 2)), size=size.normal, show_last=1) var line box_top = line.new(x1=bar_index, y1=0.0, x2=bar_index, y2=0.0, xloc=xloc.bar_index, extend=extend.none, color=color.gray, style=line.style_solid, width=1) var line box_bot = line.new(x1=bar_index, y1=0., x2=bar_index, y2=0., xloc=xloc.bar_index, extend=extend.none, color=color.gray, style=line.style_solid, width=1) var line box_left = line.new(x1=bar_index, y1=0., x2=bar_index, y2=0., xloc=xloc.bar_index, extend=extend.none, color=color.gray, style=line.style_solid, width=1) var line box_right = line.new(x1=bar_index, y1=0., x2=bar_index, y2=0., xloc=xloc.bar_index, extend=extend.none, color=color.gray, style=line.style_solid, width=1) var line box_ob = line.new(x1=bar_index, y1=0., x2=bar_index, y2=0., xloc=xloc.bar_index, extend=extend.none, color=color.olive, style=line.style_dashed, width=1) var line box_os = line.new(x1=bar_index, y1=0., x2=bar_index, y2=0., xloc=xloc.bar_index, extend=extend.none, color=color.orange, style=line.style_dashed, width=1) var float top = 0.0 var float bot = 0.0 int left = bar_index - 1000 int right = bar_index int ob = bar_index - 250 int os = bar_index - 750 top := ta.cum(array.max(id=X)) / (bar_index + 1) //max(nz(top), array.max(id=X)) bot := ta.cum(array.min(id=X)) / (bar_index + 1) //min(nz(bot), array.min(id=X)) // plot(series=top) // plot(series=bot) hline(0) line.set_xy1(id=box_top, x=left, y=top) line.set_xy2(id=box_top, x=right, y=top) line.set_xy1(id=box_bot, x=left, y=bot) line.set_xy2(id=box_bot, x=right, y=bot) line.set_xy1(id=box_left, x=left, y=top) line.set_xy2(id=box_left, x=left, y=bot) line.set_xy1(id=box_right, x=right, y=top) line.set_xy2(id=box_right, x=right, y=bot) line.set_xy1(id=box_ob, x=ob, y=top) line.set_xy2(id=box_ob, x=ob, y=bot) line.set_xy1(id=box_os, x=os, y=top) line.set_xy2(id=box_os, x=os, y=bot) var label _latop = label.new(bar_index, 0.0, '0 <-- RSI Value --> 100') var label _larig = label.new(bar_index, 0.0, '+\nPrice Change\n-', style=label.style_label_left) label.set_xy(id=_latop, x=bar_index - 500, y=top) label.set_xy(id=_larig, x=bar_index, y=math.avg(top, bot)) これはPine scriptで記述されたスクリプトです。 プログラミング初心者でも一発で理解できるように関数や引数の使い方を交えながら各段落の機能について漏れなく詳細に解説してください。

スクリプトの概要

スクリプトの詳細な解説

1. ライセンスと著作権表示

text
// This source code is subject to the terms of the Mozilla Public License 2.0 at https://mozilla.org/MPL/2.0/
// © RicardoSantos

//@version=5
indicator(title='Example: Graph style - 4th Dimension RSI')

• Mozilla Public License 2.0: このスクリプトは、Mozilla Public License 2.0 の下でライセンスされています。これは、スクリプトの使用、修正、配布に関する条件を定めています。
• © RicardoSantos: 著作権者（この場合は RicardoSantos）を示します。
• //@version=5: Pine Script のバージョンを指定します。バージョン 5 は、比較的新しいバージョンであり、多くの機能が追加・改善されています。
• indicator(title='Example: Graph style - 4th Dimension RSI'):
  • indicator() 関数は、スクリプトがインジケーターであることを宣言します。
  • title 引数は、TradingView 上で表示されるインジケーターの名前を設定します。

2. 色のグラデーション関数

text
f_grad(_value) =>
    _value >= 11 ? #0002A2 : _value == 10 ? #0045A9 : _value == 09 ? #008EB0 : _value == 08 ? #00B690 : _value == 07 ? #00BD4A : _value == 06 ? #01C400 : _value == 05 ? #52CA00 : _value == 04 ? #A8D100 : _value == 03 ? #D7AC00 : _value == 02 ? #DE5800 : _value == 01 ? #E50000 : color.white

• f_grad() 関数は、入力された値（_value）に応じて異なる色を返します。
• この関数は、色のグラデーションを作成するために使用されます。_value が大きいほど、色が変化します。
• ? と : は三項演算子で、条件に応じて異なる値を返します。
  • 例: _value >= 11 ? #0002A2 : color.white は、「_value が 11 以上の場合、#0002A2 を返し、そうでない場合は color.white を返す」という意味です。
• #0002A2 などの # で始まる文字列は、16進数カラーコードを表します。
• color.white は、Pine Script に組み込まれている定数で、白色を表します。

3. 特徴量の計算

text
float feature01 = close - close[1]
float feature02 = math.round(ta.rsi(close, 14)[1] * 10)

• feature01: 現在の終値（close）と1つ前の終値（close[1]）の差を計算します。これは、価格の変動を表す指標となります。
• feature02:
  • ta.rsi(close, 14) は、終値（close）を基に14期間のRSIを計算します。ta は、Technical Analysis（テクニカル分析）のための組み込み関数を提供する名前空間です。
  • [1] は、RSIの1つ前の値を参照します。
  • math.round() は、数値を最も近い整数に丸めます。
  • * 10 は、RSIの値を10倍にします。これにより、RSIの小数点以下の細かな変動を整数として扱いやすくなります。

4. データの準備

text
int data_range = 10
int nclusters = 3

float[] X = array.new_float(data_range, feature01)
float[] Y = array.new_float(data_range, feature02)

for _i = 0 to data_range - 1 by 1
    array.set(id=X, index=_i, value=feature01[_i])
    array.set(id=Y, index=_i, value=feature02[_i])

• data_range: データの範囲（過去何期間分のデータを表示するか）を定義します。ここでは 10 に設定されています。
• nclusters: クラスタリングに使用するクラスタ数を定義しますが、この変数は現在のコードでは使用されていません。
• float[] X = array.new_float(data_range, feature01):
  • array.new_float(data_range, feature01) は、data_range のサイズを持つfloat型の新しい配列を作成し、全ての要素をfeature01で初期化します。
  • float[] X は、float型の配列 X を宣言し、上記の配列を代入します。
  • 配列 X は、価格の変化（feature01）を格納するために使用されます。
• float[] Y = array.new_float(data_range, feature02):
  • array.new_float(data_range, feature02) は、data_range のサイズを持つfloat型の新しい配列を作成し、全ての要素をfeature02で初期化します。
  • float[] Y は、float型の配列 Y を宣言し、上記の配列を代入します。
  • 配列 Y は、RSIの値（feature02）を格納するために使用されます。
• for _i = 0 to data_range - 1 by 1: for ループを使用して、過去のデータ点を配列 X と Y に格納します。
  • _i: ループカウンタ変数です。
  • 0 to data_range - 1: ループの範囲を指定します。0 から data_range - 1 まで繰り返します。
  • by 1: ループカウンタの増分値を指定します。ここでは 1 ずつ増加します。
  • array.set(id=X, index=_i, value=feature01[_i]): 配列 X の _i 番目の要素に、feature01 の _i 番目の値を設定します。
  • array.set(id=Y, index=_i, value=feature02[_i]): 配列 Y の _i 番目の要素に、feature02 の _i 番目の値を設定します。

5. データのプロット

text
plot(series=array.get(X, 0), color=f_grad(0), linewidth=10, style=plot.style_circles, offset=int(-1000 + array.get(Y, 0)), show_last=1)
plot(series=array.get(X, 1), color=f_grad(1), linewidth=9, style=plot.style_circles, offset=int(-1000 + array.get(Y, 1)), show_last=1)
plot(series=array.get(X, 2), color=f_grad(2), linewidth=8, style=plot.style_circles, offset=int(-1000 + array.get(Y, 2)), show_last=1)
plot(series=array.get(X, 3), color=f_grad(3), linewidth=7, style=plot.style_circles, offset=int(-1000 + array.get(Y, 3)), show_last=1)
plot(series=array.get(X, 4), color=f_grad(4), linewidth=6, style=plot.style_circles, offset=int(-1000 + array.get(Y, 4)), show_last=1)
plot(series=array.get(X, 5), color=f_grad(5), linewidth=5, style=plot.style_circles, offset=int(-1000 + array.get(Y, 5)), show_last=1)
plot(series=array.get(X, 6), color=f_grad(6), linewidth=4, style=plot.style_circles, offset=int(-1000 + array.get(Y, 6)), show_last=1)
plot(series=array.get(X, 7), color=f_grad(7), linewidth=3, style=plot.style_circles, offset=int(-1000 + array.get(Y, 7)), show_last=1)
plot(series=array.get(X, 8), color=f_grad(8), linewidth=2, style=plot.style_circles, offset=int(-1000 + array.get(Y, 8)), show_last=1)
plot(series=array.get(X, 9), color=f_grad(9), linewidth=1, style=plot.style_circles, offset=int(-1000 + array.get(Y, 9)), show_last=1)

• plot() 関数は、チャート上にデータをプロットします。
  • series: プロットするデータの系列を指定します。ここでは、配列 X から取得した値を使用します。
    • array.get(X, 0) は、配列 X の 0 番目の要素の値を取得します。
  • color: プロットの色を指定します。ここでは、f_grad() 関数を使用して、データの値に応じた色を設定します。
  • linewidth: プロットの線の太さを指定します。
  • style: プロットのスタイルを指定します。ここでは、plot.style_circles を使用して、円をプロットします。
  • offset: プロットの位置を調整します。ここでは、-1000 + array.get(Y, 0) を使用して、RSIの値（配列 Y から取得）に応じて円の位置を左右にずらします。
  • show_last: 最新のデータ点のみを表示するかどうかを指定します。ここでは、1 を指定して、最新のデータ点のみを表示します。
• これらの plot() 関数は、過去10期間の価格変動を円としてプロットし、RSIの値に応じて円の色と位置を調整することで、データの分布を視覚的に表現します。

6. (コメントアウトされた) 異なる形状のプロット

text
// plot different shapes:
// plotshape(series=array.get(X, 9), title='', style=shape.cross, location=location.absolute, color=f_grad(9), transp=25, offset=int(-1000+array.get(Y, 9)), size=size.normal, show_last=1)
// plotshape(series=array.get(X, 5), title='', style=shape.diamond, location=location.absolute, color=f_grad(5), transp=25, offset=int(-1000+array.get(Y, 5)), size=size.normal, show_last=1)

// not centered location
//plotchar(series=array.get(X, 2), title='', char='*', location=location.absolute, color=f_grad(2), transp=25, offset=int(-1000+array.get(Y, 2)), size=size.normal, show_last=1)

• これらの行はコメントアウトされており、現在のスクリプトでは実行されません。
• plotshape() 関数は、特定の形状（クロス、ダイヤモンドなど）をプロットするために使用されます。
  • series: プロットするデータの系列を指定します。
  • title: プロットのタイトルを指定します。
  • style: プロットの形状を指定します。
    • shape.cross: クロス形状
    • shape.diamond: ダイヤモンド形状
  • location: プロットの位置を指定します。location.absolute は、絶対位置を指定します。
  • color: プロットの色を指定します。
  • transp: 透明度を指定します。0 (不透明) から 100 (透明) までの値を設定できます。
  • offset: プロットの位置を調整します。
  • size: プロットのサイズを指定します。
  • show_last: 最新のデータ点のみを表示するかどうかを指定します。
• plotchar() 関数は、特定の文字をプロットするために使用されます。
  • char: プロットする文字を指定します。
• これらの関数を使用すると、データの値に応じて異なる形状や文字をプロットできます。

7. ボックスとラインの描画

text
var line box_top = line.new(x1=bar_index, y1=0.0, x2=bar_index, y2=0.0, xloc=xloc.bar_index, extend=extend.none, color=color.gray, style=line.style_solid, width=1)
var line box_bot = line.new(x1=bar_index, y1=0., x2=bar_index, y2=0., xloc=xloc.bar_index, extend=extend.none, color=color.gray, style=line.style_solid, width=1)
var line box_left = line.new(x1=bar_index, y1=0., x2=bar_index, y2=0., xloc=xloc.bar_index, extend=extend.none, color=color.gray, style=line.style_solid, width=1)
var line box_right = line.new(x1=bar_index, y1=0., x2=bar_index, y2=0., xloc=xloc.bar_index, extend=extend.none, color=color.gray, style=line.style_solid, width=1)

var line box_ob = line.new(x1=bar_index, y1=0., x2=bar_index, y2=0., xloc=xloc.bar_index, extend=extend.none, color=color.olive, style=line.style_dashed, width=1)
var line box_os = line.new(x1=bar_index, y1=0., x2=bar_index, y2=0., xloc=xloc.bar_index, extend=extend.none, color=color.orange, style=line.style_dashed, width=1)

• line.new() 関数は、新しいラインオブジェクトを作成します。
  • x1, y1: ラインの開始点の x 座標と y 座標を指定します。
  • x2, y2: ラインの終了点の x 座標と y 座標を指定します。
  • xloc: x 座標の位置を指定します。xloc.bar_index は、バーのインデックスを使用します。
  • extend: ラインの延長方法を指定します。extend.none は、ラインを延長しません。
  • color: ラインの色を指定します。
  • style: ラインのスタイルを指定します。
    • line.style_solid: 実線
    • line.style_dashed: 破線
  • width: ラインの太さを指定します。
• var line box_top = ...: var キーワードを使用して、ラインオブジェクトを宣言し、初期化します。var で宣言された変数は、スクリプトの実行中に一度だけ初期化されます。
• これらのコードは、チャート上にいくつかのラインオブジェクトを作成します。
  • box_top, box_bot, box_left, box_right: グレー色の実線で、ボックスの枠線として使用されます。
  • box_ob: オリーブ色の破線で、オーバーバウト（買われすぎ）の目安として使用されます。
  • box_os: オレンジ色の破線で、オーバーソルド（売られすぎ）の目安として使用されます。

8. ボックスの座標計算

text
var float top = 0.0
var float bot = 0.0
int left = bar_index - 1000
int right = bar_index
int ob = bar_index - 250
int os = bar_index - 750

top := ta.cum(array.max(id=X)) / (bar_index + 1)  //max(nz(top), array.max(id=X))
bot := ta.cum(array.min(id=X)) / (bar_index + 1)  //min(nz(bot), array.min(id=X)) 

// plot(series=top)
// plot(series=bot)
hline(0)

• var float top = 0.0: top 変数を宣言し、0.0 で初期化します。この変数は、ボックスの上端の y 座標を格納するために使用されます。
• var float bot = 0.0: bot 変数を宣言し、0.0 で初期化します。この変数は、ボックスの下端の y 座標を格納するために使用されます。
• int left = bar_index - 1000: left 変数を宣言し、現在のバーのインデックスから 1000 を引いた値で初期化します。この変数は、ボックスの左端の x 座標を格納するために使用されます。
• int right = bar_index: right 変数を宣言し、現在のバーのインデックスで初期化します。この変数は、ボックスの右端の x 座標を格納するために使用されます。
• int ob = bar_index - 250: ob 変数を宣言し、現在のバーのインデックスから 250 を引いた値で初期化します。この変数は、オーバーバウトのラインの x 座標を格納するために使用されます。
• int os = bar_index - 750: os 変数を宣言し、現在のバーのインデックスから 750 を引いた値で初期化します。この変数は、オーバーソルドのラインの x 座標を格納するために使用されます。
• top := ta.cum(array.max(id=X)) / (bar_index + 1):
  • array.max(id=X): 配列 X の最大値を返します。
  • ta.cum(): 引数の累積合計を計算します。
  • (bar_index + 1): 現在のバーのインデックスに 1 を加えた値で、累積合計を割ることで平均値を計算します。
  • :=: 代入演算子。var で宣言された変数に新しい値を代入するために使用されます。
  • この行は、配列 X の最大値の累積平均を計算し、top 変数に格納します。
• bot := ta.cum(array.min(id=X)) / (bar_index + 1):
  • array.min(id=X): 配列 X の最小値を返します。
  • この行は、配列 X の最小値の累積平均を計算し、bot 変数に格納します。
• hline(0): y = 0 の水平線を描画します。

9. ラインオブジェクトの位置設定

text
line.set_xy1(id=box_top, x=left, y=top)
line.set_xy2(id=box_top, x=right, y=top)
line.set_xy1(id=box_bot, x=left, y=bot)
line.set_xy2(id=box_bot, x=right, y=bot)
line.set_xy1(id=box_left, x=left, y=top)
line.set_xy2(id=box_left, x=left, y=bot)
line.set_xy1(id=box_right, x=right, y=top)
line.set_xy2(id=box_right, x=right, y=bot)
line.set_xy1(id=box_ob, x=ob, y=top)
line.set_xy2(id=box_ob, x=ob, y=bot)
line.set_xy1(id=box_os, x=os, y=top)
line.set_xy2(id=box_os, x=os, y=bot)

• line.set_xy1() 関数は、ラインオブジェクトの開始点の x 座標と y 座標を設定します。
  • id: 設定するラインオブジェクトの ID を指定します。
  • x: x 座標を指定します。
  • y: y 座標を指定します。
• line.set_xy2() 関数は、ラインオブジェクトの終了点の x 座標と y 座標を設定します。
• これらのコードは、事前に作成したラインオブジェクトの位置を、計算された座標に基づいて設定します。
  • box_top: ボックスの上端のラインの位置を設定します。
  • box_bot: ボックスの下端のラインの位置を設定します。
  • box_left: ボックスの左端のラインの位置を設定します。
  • box_right: ボックスの右端のラインの位置を設定します。
  • box_ob: オーバーバウトのラインの位置を設定します。
  • box_os: オーバーソルドのラインの位置を設定します。

10. ラベルの表示

text
var label _latop = label.new(bar_index, 0.0, '0 <-- RSI Value --> 100')
var label _larig = label.new(bar_index, 0.0, '+\nPrice Change\n-', style=label.style_label_left)
label.set_xy(id=_latop, x=bar_index - 500, y=top)
label.set_xy(id=_larig, x=bar_index, y=math.avg(top, bot))

• label.new() 関数は、新しいラベルオブジェクトを作成します。
  • x: ラベルの x 座標を指定します。
  • y: ラベルの y 座標を指定します。
  • text: ラベルに表示するテキストを指定します。
  • style: ラベルのスタイルを指定します。label.style_label_left は、ラベルを左寄せで表示します。
• var label _latop = ...: var キーワードを使用して、ラベルオブジェクトを宣言し、初期化します。
• label.set_xy() 関数は、ラベルオブジェクトの位置を設定します。
  • id: 設定するラベルオブジェクトの ID を指定します。
  • x: x 座標を指定します。
  • y: y 座標を指定します。
• これらのコードは、チャート上に2つのラベルを表示します。
  • _latop: RSIの値の範囲を示すラベルを表示します。
  • _larig: 価格の変化の方向を示すラベルを表示します。

スクリプト全体の流れ

1. スクリプトのライセンス、著作権、バージョン、インジケーターのタイトルを設定します。
2. 価格の変化とRSIの値を計算します。
3. 過去の価格変化とRSIの値を配列に格納します。
4. 過去の価格変化を円としてプロットし、RSIの値に応じて円の色と位置を調整します。
5. チャート上にボックスとラインを描画し、オーバーバウトとオーバーソルドの目安を表示します。
6. チャート上にラベルを表示し、RSIの値の範囲と価格の変化の方向を示します。

まとめ

1. 価格変化とRSIの計算
   過去の価格変化（終値の差）とRSI値を計算し、それらを特徴量として使用します。
2. データの視覚化
   計算されたデータを基に、円やラインをチャート上にプロットします。円の色や位置は、価格変化やRSIの値に応じて動的に変化します。
3. ボックスやラインによる補助情報の表示
   RSIの範囲や価格変動を示すボックスやラインを描画し、視覚的な補助情報を提供します。
4. ラベルによる説明の追加
   RSI値や価格変化についての説明ラベルをチャート上に表示し、情報の理解を助けます。

1. 変数の永続性:
   var キーワードを使用して変数を宣言することで、その変数はスクリプトの最初の実行時にのみ初期化され、その後のバー更新時には以前の値を保持します1。これにより、変数の値が各バーで再計算されるのを防ぎ、計算効率を向上させます。
2. 累積計算の最適化:
   ta.cum() 関数は累積計算を行います2。var で宣言された変数に := で値を代入することで、各バーでの計算結果を累積していくことができます。これにより、全期間の最大値や最小値の累積平均を効率的に計算できます。
3. 初期値の設定:
   var float top = 0.0 と var float bot = 0.0 で初期値を設定することで、スクリプトの最初の実行時に適切な初期状態を確保します。これは特に、計算に使用するデータがまだ十分にない初期のバーで重要です。
4. メモリ効率:
   var を使用することで、変数のメモリ割り当てが一度だけ行われ、その後は同じメモリ位置が再利用されます。これにより、メモリ使用量を削減し、スクリプトのパフォーマンスを向上させることができます14。
5. 柔軟性:
   この方法を使用することで、将来的に計算ロジックを変更する際の柔軟性が高まります。例えば、条件付きで値を更新したり、他の計算結果と組み合わせたりすることが容易になります。