Pine Script（Pineスクリプト）でよく使うplot関数の書き方を詳しく解説
今回はplot関数を紹介していきます。
plot関数は、チャート上にデータを描画するためのものです。
ほぼ毎回使用するので、各種機能を使いこなすことで、自分のイメージに合ったインジケーターに仕上げることが出来ます。
直感的にインジケーターの情報を読み取れるようにするためにも大切な関数です。
引数は必須パラメータとオプションパラメータがあり、必須のパラメータはseriesのみです。
オプションパラメータを記述しない場合は各デフォルト値が採用されます。
plot関数で使用できる引数とデフォルト値は以下の表の通りです。
- plot(series, title, color, linewidth, style, trackprice, histbase, offset, join, editable, show_last, display)
| NO | 引数 | 内容 | デフォルト |
|---|---|---|---|
| 1 | series（必須） | 使用するデータを指定 | – |
| 2 | title | 描画のタイトル | – |
| 3 | color | ラインの色 | color.blue |
| 4 | linewidth | ラインの太さ | 1 |
| 5 | style | ラインのスタイル | plot.style_line |
| 6 | trackprice | インジケーターの最新値に水平な価格線を表示 | false |
| 7 | histbase | ヒストグラムの起点を指定 | 0.0 |
| 8 | offset | 左右に描画をずらす | 0 |
| 9 | join | 描画点を線で結ぶ | false |
| 10 | editable | ダイアログで変更可にする | true |
| 11 | show_last | 最新バーから表示する本数を指定 | – |
| 12 | display | プロットの情報をどこに表示するかの設定 | display.all |
各引数について。
1．series：チャートに描画したいデータを指定（代入）します
| No | 価格など | 内容 |
|---|---|---|
| 1 | open | 始値 |
| 2 | high | 高値 |
| 3 | low | 安値 |
| 4 | hl2 | （高値＋安値）/2 |
| 5 | hlc3 | （高値+安値+終値）/3 |
| 6 | ohlc4 | （始値+高値+安値+終値）/4 |
| 7 | 定義した変数 | 計算結果などが使えます |
2．title：描画したオブジェクトのタイトルが指定できます
（※画像をクリックすると大きな画像が表示されます。）
3．color：ラインの色が指定出来ます
以下は予め準備されている色です。
（※画像をクリックすると大きな画像が表示されます。）
4．linewidth：ラインの太さが指定出来ます
指定可能な範囲は1～4までです。
（※画像をクリックすると大きな画像が表示されます。）
5．style：ラインの種類が指定出来ます
9種類選べます。
デフォルトは style = plot.style_line です。
（※画像をクリックすると大きな画像が表示されます。）
（※画像をクリックすると大きな画像が表示されます。）
（※画像をクリックすると大きな画像が表示されます。）
6．trackprice：インジケーターの最新値に水平な価格線が表示出来ます
デフォルトは trackprice = false です。
（※画像をクリックすると大きな画像が表示されます。）
7．histbase：ラインの種類が指定出来ます
スタイルが下記の3つのときに、スタートの価格が指定出来ます。
デフォルトは 0.0 です。
対象のスタイル
- 1．plot.style_histogram,
- 2．plot.style_columns
- 3．plot.style_area
（※画像をクリックすると大きな画像が表示されます。）
8．offset：左右に描画をずらすことが出来ます
プラス値で右へ、マイナス値で左にずれます。
デフォルトは offset = 0 です。
（※画像をクリックすると大きな画像が表示されます。）
9．join：プロットを線で結ぶことが出来ます
デフォルトは join = false です。
（※画像をクリックすると大きな画像が表示されます。）
10．editable：ダイアログでスタイルの設定変更を可能にします
デフォルトは editable = true です。
（※画像をクリックすると大きな画像が表示されます。）
11．show_last：最新のロウソク足から表示させる本数を指定出来ます
デフォルトは 未指定です。
（※画像をクリックすると大きな画像が表示されます。）
12．display：プロットの情報をどこに表示するかを制御します
デフォルトは display.allです。
デフォルト以外を指定すると、チャート上に描画されなくなりますので注意が必要です。
デフォルト以外を使用する機会は少ないです。
| No | 種類 | 内容 |
|---|---|---|
| 1 | display.none | プロットの値を表示しません。 |
| 2 | display.pane | `overlay` パラメータで定義されたスクリプトで使用する領域にプロットを表示します。 |
| 3 | display.data_window | チャート右側のツールバーにあるデータウィンドウにプロットの値を表示します。 |
| 4 | display.price_scale | 価格スケール上のプロットのラベルと価格を表示します。 |
| 5 | display.status_line | プロットの値をチャート上のスクリプト名の横のステータスラインに表示します。 |
| 6 | display.all | あらゆる場所に表示します。 |
plot関数の紹介は以上です。
インジケーターの見た目を左右する大切な関数ですので、チャート判断がより便利に出来るように活用して下さい。
次回も使用頻度の高い関数の紹介をしていきます。
Pine Script（Pineスクリプト）をさらに学びたい方へオススメのコンテンツ
OANDA証券では、TradingViewのプログラミング言語である「Pine Script(Pineスクリプト)」に関する記事を豊富に提供しています。
プログラミング初心者の方でも、インジケーターやストラテジーの作成ができるよう、ソースコードをコピペ＋少しの修正で組み上がる構成としています。
またOANDA証券とTradingViewのアカウントを連携させることで、「Tradingview」から直接トレードすることが可能です。
ぜひOANDA証券での口座開設をご検討下さい。
本ホームページに掲載されている事項は、投資判断の参考となる情報の提供を目的としたものであり、投資の勧誘を目的としたものではありません。投資方針、投資タイミング等は、ご自身の責任において判断してください。本サービスの情報に基づいて行った取引のいかなる損失についても、当社は一切の責を負いかねますのでご了承ください。また、当社は、当該情報の正確性および完全性を保証または約束するものでなく、今後、予告なしに内容を変更または廃止する場合があります。なお、当該情報の欠落・誤謬等につきましてもその責を負いかねますのでご了承ください。
