Source code for backtrader.indicators.contrib.x_de_marker_histogram_vol_direct_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.
"""
import math
from collections import deque
from .. import Indicator
__all__ = [
"XDeMarkerHistogramVolDirectIndicator",
]
[docs]
class XDeMarkerHistogramVolDirectIndicator(Indicator):
"""Indicator that calculates DeMarker histogram zone and direct trend color."""
lines = ("value", "color_zone", "color_direct", "upper2", "upper1", "lower1", "lower2")
params = (
("de_marker_period", 14),
("volume_type", "tick"),
("high_level2", 20),
("high_level1", 15),
("low_level1", -15),
("low_level2", -20),
("ma_method", "MODE_SMA_"),
("ma_length", 12),
("ma_phase", 15),
)
def __init__(self):
"""Initialize de_marker state deques and warm-up period."""
self._demax = deque(maxlen=max(1, int(self.p.de_marker_period)))
self._demin = deque(maxlen=max(1, int(self.p.de_marker_period)))
self._raw = deque(maxlen=max(1, int(self.p.ma_length)))
self._vol = deque(maxlen=max(1, int(self.p.ma_length)))
self.addminperiod(max(int(self.p.de_marker_period), int(self.p.ma_length)) + 2)
@staticmethod
def _nan():
return float("nan")
@staticmethod
def _finite(value):
return value is not None and math.isfinite(value)
def _bar_volume(self):
volume_type = str(self.p.volume_type).lower()
if volume_type in {"real", "volume_real", "volume"}:
raw = float(self.data.openinterest[0])
if math.isfinite(raw) and raw > 0:
return raw
raw = float(self.data.volume[0])
return raw if math.isfinite(raw) else 0.0
[docs]
def next(self):
"""Compute de_marker-derived raw value, smoothing, and colors."""
if len(self.data) < 2:
for line in self.lines:
line[0] = self._nan()
return
high_now = float(self.data.high[0])
high_prev = float(self.data.high[-1])
low_now = float(self.data.low[0])
low_prev = float(self.data.low[-1])
vol_now = self._bar_volume()
self._demax.append(max(high_now - high_prev, 0.0))
self._demin.append(max(low_prev - low_now, 0.0))
value = self._nan()
color_zone = self._nan()
color_direct = (
self.lines.color_direct[-1]
if len(self) > 1 and self._finite(self.lines.color_direct[-1])
else self._nan()
)
upper2 = self._nan()
upper1 = self._nan()
lower1 = self._nan()
lower2 = self._nan()
if len(self._demax) >= int(self.p.de_marker_period) and len(self._demin) >= int(
self.p.de_marker_period
):
sum_max = sum(self._demax)
sum_min = sum(self._demin)
denom = sum_max + sum_min
demarker = (sum_max / denom) if denom > 0 else 0.5
raw = ((demarker * 100.0) - 50.0) * vol_now
self._raw.append(raw)
self._vol.append(vol_now)
if len(self._raw) >= int(self.p.ma_length) and len(self._vol) >= int(self.p.ma_length):
if str(self.p.ma_method).upper() != "MODE_SMA_":
raise ValueError(
"Current backtrader migration only supports MODE_SMA_ for XDeMarker_Histogram_Vol_Direct"
)
value = sum(self._raw) / len(self._raw)
avg_vol = sum(self._vol) / len(self._vol)
upper2 = self.p.high_level2 * avg_vol
upper1 = self.p.high_level1 * avg_vol
lower1 = self.p.low_level1 * avg_vol
lower2 = self.p.low_level2 * avg_vol
if value > upper2:
color_zone = 0.0
elif value > upper1:
color_zone = 1.0
elif value < lower2:
color_zone = 4.0
elif value < lower1:
color_zone = 3.0
else:
color_zone = 2.0
prev_value = (
self.lines.value[-1]
if len(self) > 1 and self._finite(self.lines.value[-1])
else self._nan()
)
prev_direct = (
self.lines.color_direct[-1]
if len(self) > 1 and self._finite(self.lines.color_direct[-1])
else 1.0
)
if not self._finite(prev_value):
color_direct = prev_direct
elif value > prev_value:
color_direct = 0.0
elif value < prev_value:
color_direct = 1.0
else:
color_direct = prev_direct
self.lines.value[0] = value
self.lines.color_zone[0] = color_zone
self.lines.color_direct[0] = color_direct
self.lines.upper2[0] = upper2
self.lines.upper1[0] = upper1
self.lines.lower1[0] = lower1
self.lines.lower2[0] = lower2