NK-report: 1-11. NK-Fixed ATR

「足が閉じる何秒前にリアルタイム描画を開始するか、0秒から5分の間で調節できる」機能が付いたATRです。その他あった方が良い機能も付けています。

[ATR]

ATRは、前日の終値から生じる「窓開け（ギャップ）」を含めた、その日の真の最大値幅（True Range）を算出し、その一定期間の平均値（ボラティリティの絶対値）を可視化するインジケーターです。方向性が上向きか下向きかは一切関係ありません。ATRの数値が大きい時は「荒れている（エネルギーが大きい）」、小さい時は「静まり返っている（エネルギーが圧縮されている）」ことを示します。

出典: TradingView

[NOTICE & LICENSE]
・学習および情報提供のみを目的としており、投資助言ではありません。ツールを使用したことによる経済的損失について、一切の責任を負いません。
・Pine Script v6 で動作確認しています。将来のTradingView側の仕様変更に対するアップデート保証や、個別の導入サポート・改修依頼は一切受け付けません（現状有姿での提供）。
・MIT Licenseに則っています。

// SPDX-FileCopyrightText: 2026 NK-report https://www.nk-report.com/
// SPDX-License-Identifier: MIT
//
// Disclaimer: This script is for educational purposes only and does not constitute investment advice.

//@version=6
indicator("NK-Fixed ATR", shorttitle="NK-Fixed ATR", overlay=false)

// ==============================================================================
// 【01】 免責・ライセンス
// ==============================================================================
//
// インジケーターを無料で公開しています: https://www.nk-report.com/p/jp-0_0810719344.html
//
// 免責事項: 本スクリプトは学習および情報提供のみを目的としており、投資助言ではありません。
//
// 1. 本コードは2026年時点の Pine Script v6 で動作確認を行っています。
//    将来の仕様変更に伴う不具合等について、個別のサポートや改修は行いません。
// 2. 本スクリプトは一般的な計算ロジックに基づき、LLMを用いて独自に作成したものです。
//    MITライセンスに則っています。
// ------------------------------------------------------------------------------
// MIT License 
//
// Copyright 2026 NK-report https://www.nk-report.com/
//
// Permission is hereby granted, free of charge, to any person obtaining a copy of
// this software and associated documentation files (the "Software"), to deal in
// the Software without restriction, including without limitation the rights to
// use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
// of the Software, and to permit persons to whom the Software is furnished to do
// so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in all
// copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
// SOFTWARE.

// ==============================================================================
// 【02】 UI設定と言語
// ==============================================================================
// 1. 言語辞書の定義（テキストの定数化）

const string GRP_FIXED   = "▼ 描画制御 (Fixed Settings)"
const string LBL_SEC     = "リアルタイム描画開始 (足が閉じるX秒前)"
const string TT_SEC      = "0秒から300秒(5分)の間で調節。指定時間（例：10秒前）になるまで、現在の足への描画を非表示にします。\n0秒と入力した場合は非表示機能を無効化し、常にリアルタイムで描画します。"

const string GRP_ATR     = "▼ ATR設定 (ATR Settings)"
const string LBL_LEN     = "ATR 期間 (ATR Length)"
const string LBL_SIG     = "シグナル期間 (Signal Length)"

// 2. UI（ユーザー入力画面）の構築 & 3. トップダウン処理への適合

i_sec      = input.int(0, title=LBL_SEC, minval=0, maxval=300, group=GRP_FIXED, tooltip=TT_SEC)

i_len      = input.int(14, title=LBL_LEN, minval=1, group=GRP_ATR, inline="ATR1")
i_sig      = input.int(14, title=LBL_SIG, minval=1, group=GRP_ATR, inline="ATR1")


// ==============================================================================
// 【03】 全コード共通仕様（タイムゾーン・時間インフラ処理）
// ==============================================================================
// 1. 基本時間単位のシステム定義（定数化）
const int MS_PER_SEC  = 1000

// ==============================================================================
// 【04】 各カテゴリ共通仕様 (NK-Fixed Core Logic)
// ==============================================================================
// 1. カテゴリ固有のインフラ構築（コア機能の定義）
bool is_draw_ready = true

// リアルタイム足であり、かつユーザーが0秒より大きい数値を設定している場合のみ処理
if barstate.isrealtime and i_sec > 0
    if not na(time_close)
        int time_left_ms = time_close - timenow
        int threshold_ms = i_sec * MS_PER_SEC
        
        if time_left_ms > threshold_ms
            is_draw_ready := false


// ==============================================================================
// 【05】 このコード固有の計算仕様 (Specific Indicator Logic)
// ==============================================================================
// 1. インジケーター固有の純粋な数学的処理
float calc_atr = ta.atr(i_len)
// ATRの移動平均線（シグナル）を算出
float calc_sig = ta.sma(calc_atr, i_sig)

// 2. ロジックの完全な隔離と差し替えの容易性

// 3. 視覚的装飾の排除とデータの引き渡し
float final_atr = is_draw_ready ? calc_atr : na
float final_sig = is_draw_ready ? calc_sig : na


// ==============================================================================
// 【06】 描画と出力 (Rendering & Outputs)
// ==============================================================================
// 1. チャートへの視覚的出力（プロットと装飾）
plot(final_atr, title="ATR Line", color=#E91E63, linewidth=2)
plot(final_sig, title="Signal Line", color=color.new(#9E9E9E, 0), linewidth=1, style=plot.style_line)

// ユーザー追加ライン (Extra Line) - デフォルトは非表示（スタイルタブで設定・数値変更可能）
// ※ ATRは銘柄によって数値スケールが異なるため、初期値はプレースホルダーとして「0」にしています
hline(0, title="水平線 1", color=color.black, linestyle=hline.style_solid, display=display.none)
hline(0, title="水平線 2", color=color.black, linestyle=hline.style_solid, display=display.none)

// 2. ロジックとデザインの完全分離

// 3. アラート（通知）条件の統合
// ※投資助言を回避するため、方向性を指示する言葉（Buy/Sell等）は使わず、純粋な事実・状態のみを通知します
bool cross_over_sig  = ta.crossover(calc_atr, calc_sig) and is_draw_ready
bool cross_under_sig = ta.crossunder(calc_atr, calc_sig) and is_draw_ready

alertcondition(cross_over_sig,  title="ATR Cross Over Signal",  message="ATR crossed over its Signal line (Volatility Expanding)")
alertcondition(cross_under_sig, title="ATR Cross Under Signal", message="ATR crossed under its Signal line (Volatility Contracting)")

※好みの配色に設定後、パラメータータブの「デフォルトを保存」を押してください。
※新規作成→インジケーター→ペーストするの順序で行わないと正しく表示されないことがあります。

    Return to [Section.0]
  

2026/04/20

1-11. NK-Fixed ATR

[ATR]