Source code for backtrader.indicators.contrib.color_bb_candles_indicator

#!/usr/bin/env python
"""Functional-test indicators migrated to contrib.

Generated from a single functional strategy module to preserve file-local
helper functions and constants without cross-test name collisions.
"""

from .. import (
    EMA,
    SMA,
    Indicator,
    StandardDeviation,
)

__all__ = [
    "ColorBBCandlesIndicator",
]


[docs] class ColorBBCandlesIndicator(Indicator): """Color BBCandles indicator producing zone states from volatility envelopes. The indicator computes a moving-average center line and standard deviation bands with multiple deviation levels, then emits a discrete state 0..10. """ lines = ( "state", "price_line", "mid", ) params = ( ("period", 100), ("deviation1", 1.0), ("deviation2", 1.5), ("deviation3", 2.0), ("deviation4", 2.5), ("deviation5", 3.0), ("ma_method", "ema"), ("applied_price", "close"), ) def __init__(self): """Prepare price line selector and required indicator buffers.""" ma_cls = EMA if str(self.p.ma_method).lower() == "ema" else SMA self.price = self._price_line() self.lines.price_line = self.price self.lines.mid = ma_cls(self.price, period=self.p.period) self.stddev = StandardDeviation(self.price, period=self.p.period) self.addminperiod(self.p.period + 5) def _price_line(self): mode = str(self.p.applied_price).lower() if mode == "open": return self.data.open if mode == "high": return self.data.high if mode == "low": return self.data.low if mode == "median": return (self.data.high + self.data.low) / 2.0 if mode == "typical": return (self.data.high + self.data.low + self.data.close) / 3.0 if mode == "weighted": return (self.data.high + self.data.low + self.data.close + self.data.close) / 4.0 if mode == "simpl": return (self.data.open + self.data.close) / 2.0 if mode == "quarter": return (self.data.high + self.data.low + self.data.open + self.data.close) / 4.0 return self.data.close
[docs] def next(self): """Evaluate the current bar and emit the normalized volatility state.""" price = float(self.price[0]) mid = float(self.lines.mid[0]) stdev = float(self.stddev[0]) up1 = mid + stdev * self.p.deviation1 up2 = mid + stdev * self.p.deviation2 up3 = mid + stdev * self.p.deviation3 up4 = mid + stdev * self.p.deviation4 up5 = mid + stdev * self.p.deviation5 dn1 = mid - stdev * self.p.deviation1 dn2 = mid - stdev * self.p.deviation2 dn3 = mid - stdev * self.p.deviation3 dn4 = mid - stdev * self.p.deviation4 dn5 = mid - stdev * self.p.deviation5 state = 5.0 if price > up5: state = 10.0 elif price > up4: state = 9.0 elif price > up3: state = 8.0 elif price > up2: state = 7.0 elif price > up1: state = 6.0 elif price < dn5: state = 0.0 elif price < dn4: state = 1.0 elif price < dn3: state = 2.0 elif price < dn2: state = 3.0 elif price < dn1: state = 4.0 self.lines.state[0] = state