はじめに

PineScriptを使用する上で、最も重要なのがSeriesの理解です。
Seriesは若干クセがあるので、しっかりと理解する必要があります。

Pineスクリプトの型システム

Pineスクリプトには以下の基本的な9つの型が存在します。

  • int
  • float
  • bool
  • color
  • string
  • line
  • label
  • plot
  • hline

これらの型はいくつかの形式で存在します。
形式には5種類あります。

  • literal
  • const
  • input
  • simple
  • series

型と形式は合わせて参照されます。
例えばliteral bool型、input bool型…のようにコンパイラによって識別されます。

また、以下のような型も存在します。

  • array
  • void
  • na (not available)
  • tuple type

形式

Literal

Literalは固定された値を表すための特別な表記法です。
Literalは常に以下のどれかの型形式になります。

  • literal float (3.14, 6.02E-23, 3e8)
  • literal int (42)
  • literal bool (true, false)
  • literal string (“A text literal”)
  • literal color (#FF55C6)

ビルトインのopen,high,low,…などはLiterarlではありません。
これらはserires formです。

Const

Const形式の値は次の特徴があります。

  • PineScript実行中に変更されない
  • コンパイル時に確定されるか計算される

例えば

c1 = 0
c2 = c1 + 1
c3 = c1 + 1
if open > close
    c3 := 0

c1はconst intです。
理由はliteral intによって初期化されるからです。
c2もconst intで、const intだけの計算で初期化されるからです。
c3はseries intで、理由は実行中に変更されるからです。

Input

Inputは以下の特徴があります。

  • PineScript実行中に変更されない
  • コンパイル時には未確定
  • input関数に基づいている

例えば

p = input(10, title="Period")

pはinput integerです。

Simple

Simpleは以下の特徴があります。

  • PineScript実行中に変更されない
  • コンパイル時に未確定

この値は、チャートのシンボルの情報に基づいています。
例えば、ビルトイン変数のsyminfo.mintickはsimple floatです。
simpleは省略されることもあるので、単にfloatと呼ばれることもあります。

Series

Seriesは以下の特徴があります。

  • PineScript実行中に変更される
  • メインチャートのシンボルの各バーに関連付けられた履歴の値を保存します
  • []演算子を使用してアクセスできる
  • seriesの最後（つまり最新のバー）に関連付けられている値のみが読み書き両方できる

seriesはPineScriptで最も一般的な形式です。
ビルトインのseries変数は例えば、open、high、low、close、volume、timeなどです。
これらのseriesのサイズは現在のティッカーの時間枠で使用可能なバーの数と同じです。
Seriesには数値かna（not avairable：使用不可）が含まれる場合があります。

例えば

a = open + close // 2つのSeriesの加算
b = high / 2     // integer literal const による、Seriesの除算
c = close[1]     // 前のcloseの値の参照

参考