テクニカル指標の定義

indicatorDef要素はテクニカル指標を定義します。

これはかなり複雑ですし、理解が必要になるのはあたらしいテクニカル指標を導入するときだけです。簡単な例として移動平均線、複雑な例として一目均衡表の定義を載せます。後続の解説と対比させると理解がしやすいと思います。

  <indicatorDef id="移動平均線" location="chart">
    <parameters>int len</parameters>
    <defaultArgs>25</defaultArgs>
    <parameterDescription>$unit数 $len</parameterDescription>
    <label>$len$unit移動平均線</label>
    <appearance>khaki 2</appearance>
    <element adjustFigures="price">
      <expression>ma(len)</expression>
    </element>
  </indicatorDef>

  <indicatorDef id="一目均衡表" location="chart" specialPaint="一目均衡表の雲">
    <parameters>int tenkan, int kijun</parameters>
    <defaultArgs>9, 26</defaultArgs>
    <parameterOwnership>転換線,基準線</parameterOwnership>
    <parameterDescription>転換線($unit) $tenkan,
      基準($unit) $kijun</parameterDescription>
    <element id="転換線" label="一目均衡表($tenkan$unit転換線)"
      appearance="tomato dot" adjustFigures="price">
      <expression>  (max(high(tenkan))+min(low(tenkan)))/2  </expression>
    </element>
    <element id="基準線" label="一目均衡表($kijun$unit基準線)"
      appearance="skyblue dot" adjustFigures="price">
      <expression> (max(high(kijun))+min(low(kijun)))/2 </expression>
    </element>
    <element id="遅行線" label="一目均衡表($kijun$unit遅行線)"
      appearance="snow dot" adjustFigures="price">
      <expression> shift(-kijun).close() </expression>
    </element>
    <element id="先行スパンＡ" forward="kijun-1"
      label="一目均衡表(先行Ａ)" 
      appearance="lightgray" adjustFigures="price">
      <expression> (max(high(tenkan))+min(low(tenkan))
        +max(high(kijun))+min(low(kijun)))/4  </expression>
    </element>
    <element id="先行スパンＢ" forward="kijun-1"
      label="一目均衡表(先行Ｂ)" 
      appearance="lightgray" adjustFigures="price">
      <expression> (max(high(kijun * 2))+min(low(kijun * 2)))/2  </expression>
    </element>
  </indicatorDef>

• @id
  この指標の名称です。
• @location
  指標をどこに表示するかを示します。次の値のいずれかでなければなりません。

  値	意味	使用している指標の例
  chart	価格として表示	ボリンジャーバンド
  volume	出来高として表示	出来高移動平均線
  os100%	0%〜100%で変化するオシレータとして表示	RSI
  os100%s	-100%〜+100%で変化するオシレータとして表示	RCI
  os0%s	0%を中心として分布するオシレータとして表示	移動平均乖離率
  os0s	0円を中心として分布するオシレータとして表示	MACD
  figure	数値を表示するが線の描画はしない	前日比

• parameters
  テクニカル指標のパラメータを定義します。型、名前の順にスペースで区切ります。複数ある時はカンマで区切ります。
• defaultArgs
  このindicatorDefが呼び出され、パラメータが省略されていたときに用いられる値です。parametersに書いた個数と一致している必要があります。
• parameterDescription
  パラメータをGUIで編集するときに使われる、説明書きです。GUIでは、$+パラメータ名はそのパラメータを変更するテキストボックスに、$unitはチャート上の適切な単位(分/日/週/月)に置換されます。
• label
  パラメータ名を含めて、指標のラベルを定義します。$につづく名前は上記と同様です。この例では、日足チャートで引数に25が渡ったと仮定すると、$len$unit移動平均線の$lenが25に、$unitが日に置換され、25日移動平均線というラベルになります。
• appearance
  このindicatorDefが呼び出され、パラメータが省略されていたときに用いられる線の見た目です。
• @specialPaint
  通常の線以外の描画が必要なときのための特殊な属性です。これはTactico内部と連携して動作します。
• element
  この指標を構成する「線」ひとつずつに対応します。これは多くは１個ですが、複数あることもあります。例えばボリンジャーバンドでは上下２本があるのでelementは２つ必要ですし、一目均衡表のようなさらに多数のelementが必要な指標もあります。
  • @id
    このelementの名前です。
  • expression
    このelementの値を計算するスクリプトを記述します。スクリプトはQuoteオブジェクトのコンテキストで実行されます。
  • @forward
    チャートの終端を超えて描画が必要な場合(一目均衡表では登場します)は、その長さを指定します。
  • @label
    このelementの名前です。省略するとindicatorDefのlabelと同じになります。
  • @appearance
    このelementのデフォルトの見た目を指定します。省略するとindicatorDefのappearanceと同じになります。