Files
Miha Kralj 35a6702b06 fix(docs): correct .md documentation across errors, dynamics, filters, forecasts, momentum, numerics, oscillators, reversals, statistics, trends, volatility, volume
Deep review of all indicator categories verified .md headers against .cs WarmupPeriod, parameters, inputs, and outputs. Fixes include warmup corrections, parameter documentation, output type accuracy, and Pine Script alignment.
2026-03-10 18:38:23 -07:00

65 lines
2.5 KiB
Plaintext

// Licensed under the Apache License, Version 2.0
// © mihakralj
//@version=6
indicator("Bollinger Band Width Normalized (BBWN)", "BBWN", overlay=false)
//@function Calculates Bollinger Band Width Normalized to [0,1] range
//@param source Series to calculate Bollinger Bands from
//@param period Lookback period for BB calculations
//@param multiplier Standard deviation multiplier for band width
//@param lookback Historical lookback period for normalization
//@returns BBWN value representing current BBW normalized to [0,1] range
//@optimized for performance and dirty data
bbwn(series float source, simple int period, simple float multiplier, simple int lookback) =>
var int p = math.max(1, period), var int head = 0, var int count = 0
var array<float> buffer = array.new_float(p, na)
var float sum = 0.0, var float sumSq = 0.0
float oldest = array.get(buffer, head)
if not na(oldest)
sum -= oldest
sumSq -= oldest * oldest
count -= 1
float current_val = nz(source)
sum += current_val
sumSq += current_val * current_val
count += 1
array.set(buffer, head, current_val)
head := (head + 1) % p
float basis = nz(sum / count, source)
float dev = count > 1 ? multiplier * math.sqrt(math.max(0.0, sumSq / count - basis * basis)) : 0.0
float bbw = basis != 0.0 ? 2 * dev / basis : 0.0
var int l = math.max(1, lookback), var int hist_head = 0, var int hist_count = 0
var array<float> hist_buffer = array.new_float(l, na)
var float min_val = bbw, var float max_val = bbw
float hist_oldest = array.get(hist_buffer, hist_head)
if not na(hist_oldest)
hist_count -= 1
if not na(bbw)
hist_count += 1
array.set(hist_buffer, hist_head, bbw)
hist_head := (hist_head + 1) % l
if hist_count >= 1
min_val := bbw
max_val := bbw
for i = 0 to hist_count - 1
float val = array.get(hist_buffer, i)
if not na(val)
min_val := math.min(min_val, val)
max_val := math.max(max_val, val)
float range_val = max_val - min_val
range_val > 0 ? (bbw - min_val) / range_val : 0.5
// ---------- Main loop ----------
// Inputs
i_period = input.int(20, "Period", minval=1)
i_source = input.source(close, "Source")
i_multiplier = input.float(2.0, "StdDev Multiplier", minval=0.001)
i_lookback = input.int(252, "Lookback Period", minval=1)
// Calculation
bbwn_value = bbwn(i_source, i_period, i_multiplier, i_lookback)
// Plot
plot(bbwn_value, "BBWN", color=color.yellow, linewidth=2)