"""Streaming-vs-batch, shape and reference-value tests for the F1-F12 families. Every indicator added since the original 25 is exercised here. The central contract is the same as the rest of the suite: ``batch(...)`` must equal repeated streaming ``update(...)`` across the whole warmup -> steady-state transition, and batch shapes must match the input length. """ from __future__ import annotations import math import numpy as np import pytest import wickra as ta def _eq_nan(a: np.ndarray, b: np.ndarray, tol: float = 1e-9) -> bool: """Compare two float arrays treating NaN positions as equal.""" a = np.asarray(a, dtype=np.float64) b = np.asarray(b, dtype=np.float64) if a.shape != b.shape: return False both_nan = np.isnan(a) & np.isnan(b) return bool(np.all(np.where(both_nan, 0.0, np.abs(a - b)) <= tol)) @pytest.fixture def ohlcv() -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray]: """Synthetic high / low / close / volume series, 200 bars.""" t = np.arange(200, dtype=np.float64) close = 100.0 + np.sin(t * 0.15) * 8.0 + np.cos(t * 0.32) * 3.0 spread = 0.5 + np.abs(np.sin(t * 0.07)) high = close + spread low = close - spread volume = 1000.0 + (t % 7) * 50.0 return high, low, close, volume # --- Scalar (f64 -> f64) indicators --------------------------------------- SCALAR = [ (ta.SMMA, (14,)), (ta.TRIMA, (20,)), (ta.ZLEMA, (14,)), (ta.ALMA, (9, 0.85, 6.0)), (ta.McGinleyDynamic, (10,)), (ta.FRAMA, (16,)), (ta.VIDYA, (14, 9)), (ta.JMA, (14, 0.0, 2)), (ta.T3, (5, 0.7)), (ta.MOM, (10,)), (ta.CMO, (14,)), (ta.TSI, (25, 13)), (ta.PMO, (35, 20)), (ta.TII, (20, 10)), (ta.StochRSI, (14, 14)), (ta.PPO, (12, 26)), (ta.APO, (12, 26)), (ta.CFO, (14,)), (ta.ElderImpulse, (13, 12, 26, 9)), (ta.STC, (23, 50, 10, 0.5)), (ta.DPO, (20,)), (ta.Coppock, (14, 11, 10)), (ta.StdDev, (20,)), (ta.UlcerIndex, (14,)), (ta.HistoricalVolatility, (20, 252)), (ta.BollingerBandwidth, (20, 2.0)), (ta.PercentB, (20, 2.0)), (ta.LinearRegression, (14,)), (ta.LinRegSlope, (14,)), (ta.VerticalHorizontalFilter, (28,)), (ta.ZScore, (20,)), (ta.LinRegAngle, (14,)), (ta.PercentageTrailingStop, (5.0,)), (ta.StepTrailingStop, (1.0,)), (ta.RenkoTrailingStop, (1.0,)), (ta.LaguerreRSI, (0.5,)), (ta.ConnorsRSI, (3, 2, 100)), (ta.RVIVolatility, (10,)), ] # Family 05 band/channel indicators with scalar input and multi-output. # `cols` is the expected number of band columns from `batch`. SCALAR_MULTI = { "MaEnvelope": (lambda: ta.MaEnvelope(20, 0.025), 3), "LinRegChannel": (lambda: ta.LinRegChannel(20, 2.0), 3), "StandardErrorBands": (lambda: ta.StandardErrorBands(21, 2.0), 3), "DoubleBollinger": (lambda: ta.DoubleBollinger(20, 1.0, 2.0), 5), } @pytest.mark.parametrize("cls, args", SCALAR, ids=[c.__name__ for c, _ in SCALAR]) def test_scalar_streaming_matches_batch(cls, args, sine_prices): batch = cls(*args).batch(sine_prices) assert batch.shape == sine_prices.shape assert batch.dtype == np.float64 streamer = cls(*args) streamed = [] for p in sine_prices: v = streamer.update(float(p)) streamed.append(math.nan if v is None else float(v)) assert _eq_nan(batch, np.array(streamed, dtype=np.float64)) # --- Candle-input, single-output indicators ------------------------------- # # Each entry is (factory, batch-call). Streaming always feeds the full # 6-tuple candle; the batch helper takes only the columns it needs. CANDLE_SCALAR = { "VWMA": (lambda: ta.VWMA(20), lambda ind, h, l, c, v: ind.batch(c, v)), "RVI": ( # extract_candle pulls the open price from index 0 of the tuple; the # streaming test below already builds candles with open == close, so # match that here by passing close as the open column. lambda: ta.RVI(10), lambda ind, h, l, c, v: ind.batch(c, h, l, c), ), "Inertia": ( lambda: ta.Inertia(14, 20), lambda ind, h, l, c, v: ind.batch(c, h, l, c), ), "PGO": (lambda: ta.PGO(14), lambda ind, h, l, c, v: ind.batch(h, l, c)), "SMI": (lambda: ta.SMI(5, 3, 3), lambda ind, h, l, c, v: ind.batch(h, l, c)), "EVWMA": (lambda: ta.EVWMA(20), lambda ind, h, l, c, v: ind.batch(c, v)), "UltimateOscillator": ( lambda: ta.UltimateOscillator(7, 14, 28), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "AroonOscillator": ( lambda: ta.AroonOscillator(14), lambda ind, h, l, c, v: ind.batch(h, l), ), "NATR": (lambda: ta.NATR(14), lambda ind, h, l, c, v: ind.batch(h, l, c)), "MassIndex": (lambda: ta.MassIndex(9, 25), lambda ind, h, l, c, v: ind.batch(h, l)), "ADL": (lambda: ta.ADL(), lambda ind, h, l, c, v: ind.batch(h, l, c, v)), "VolumePriceTrend": ( lambda: ta.VolumePriceTrend(), lambda ind, h, l, c, v: ind.batch(c, v), ), "ChaikinMoneyFlow": ( lambda: ta.ChaikinMoneyFlow(20), lambda ind, h, l, c, v: ind.batch(h, l, c, v), ), "ChaikinOscillator": ( lambda: ta.ChaikinOscillator(3, 10), lambda ind, h, l, c, v: ind.batch(h, l, c, v), ), "ForceIndex": ( lambda: ta.ForceIndex(13), lambda ind, h, l, c, v: ind.batch(c, v), ), "EaseOfMovement": ( lambda: ta.EaseOfMovement(14), lambda ind, h, l, c, v: ind.batch(h, l, v), ), "KVO": ( lambda: ta.KVO(34, 55), lambda ind, h, l, c, v: ind.batch(h, l, c, v), ), "VolumeOscillator": ( lambda: ta.VolumeOscillator(14, 28), lambda ind, h, l, c, v: ind.batch(v), ), "NVI": ( lambda: ta.NVI(), lambda ind, h, l, c, v: ind.batch(c, v), ), "PVI": ( lambda: ta.PVI(), lambda ind, h, l, c, v: ind.batch(c, v), ), "WilliamsAD": ( lambda: ta.WilliamsAD(), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "AnchoredVWAP": ( lambda: ta.AnchoredVWAP(), lambda ind, h, l, c, v: ind.batch(h, l, c, v), ), "DemandIndex": ( lambda: ta.DemandIndex(10), lambda ind, h, l, c, v: ind.batch(h, l, c, v), ), "TSV": ( lambda: ta.TSV(18), lambda ind, h, l, c, v: ind.batch(c, v), ), "VZO": ( lambda: ta.VZO(14), lambda ind, h, l, c, v: ind.batch(c, v), ), "MarketFacilitationIndex": ( lambda: ta.MarketFacilitationIndex(), lambda ind, h, l, c, v: ind.batch(h, l, v), ), "AtrTrailingStop": ( lambda: ta.AtrTrailingStop(14, 3.0), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "HiLoActivator": ( lambda: ta.HiLoActivator(3), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "VoltyStop": ( lambda: ta.VoltyStop(14, 2.0), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "YoyoExit": ( lambda: ta.YoyoExit(14, 2.0), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "TypicalPrice": ( lambda: ta.TypicalPrice(), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "MedianPrice": ( lambda: ta.MedianPrice(), lambda ind, h, l, c, v: ind.batch(h, l), ), "WeightedClose": ( lambda: ta.WeightedClose(), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "AcceleratorOscillator": ( lambda: ta.AcceleratorOscillator(5, 34, 5), lambda ind, h, l, c, v: ind.batch(h, l), ), "AwesomeOscillatorHistogram": ( lambda: ta.AwesomeOscillatorHistogram(5, 34, 5), lambda ind, h, l, c, v: ind.batch(h, l), ), "BalanceOfPower": ( # The streaming 6-tuple feeds open == close, so batch matches with # the close column standing in for open. lambda: ta.BalanceOfPower(), lambda ind, h, l, c, v: ind.batch(c, h, l, c), ), "ChoppinessIndex": ( lambda: ta.ChoppinessIndex(14), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "TrueRange": ( lambda: ta.TrueRange(), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "ChaikinVolatility": ( lambda: ta.ChaikinVolatility(10, 10), lambda ind, h, l, c, v: ind.batch(h, l), ), "ADXR": ( lambda: ta.ADXR(7), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "ParkinsonVolatility": ( lambda: ta.ParkinsonVolatility(20, 252), lambda ind, h, l, c, v: ind.batch(h, l), ), "GarmanKlassVolatility": ( # The streaming 6-tuple feeds open == close, so batch matches with # the close column standing in for open. lambda: ta.GarmanKlassVolatility(20, 252), lambda ind, h, l, c, v: ind.batch(c, h, l, c), ), "RogersSatchellVolatility": ( lambda: ta.RogersSatchellVolatility(20, 252), lambda ind, h, l, c, v: ind.batch(c, h, l, c), ), "YangZhangVolatility": ( lambda: ta.YangZhangVolatility(20, 252), lambda ind, h, l, c, v: ind.batch(c, h, l, c), ), } @pytest.mark.parametrize("name", list(CANDLE_SCALAR)) def test_candle_scalar_streaming_matches_batch(name, ohlcv): high, low, close, volume = ohlcv make, batch_call = CANDLE_SCALAR[name] batch = batch_call(make(), high, low, close, volume) assert batch.shape == close.shape streamer = make() streamed = [] for i in range(close.size): candle = ( float(close[i]), float(high[i]), float(low[i]), float(close[i]), float(volume[i]), i, ) v = streamer.update(candle) streamed.append(math.nan if v is None else float(v)) assert _eq_nan(batch, np.array(streamed, dtype=np.float64)), f"{name} mismatch" # --- Candle-input, multi-output indicators -------------------------------- MULTI = { "Vortex": (lambda: ta.Vortex(14), lambda ind, h, l, c, v: ind.batch(h, l, c)), "RWI": (lambda: ta.RWI(14), lambda ind, h, l, c, v: ind.batch(h, l, c)), "WaveTrend": ( lambda: ta.WaveTrend.classic(), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "SuperTrend": ( lambda: ta.SuperTrend(10, 3.0), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "ChandelierExit": ( lambda: ta.ChandelierExit(22, 3.0), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "ChandeKrollStop": ( lambda: ta.ChandeKrollStop(10, 1.0, 9), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "DonchianStop": ( lambda: ta.DonchianStop(10), lambda ind, h, l, c, v: ind.batch(h, l), ), # Family 05 candle-input bands. Each entry is # `(factory, batch_call, output_arity, streaming_fields)` where # `streaming_fields` is the tuple shape returned by `update(...)`. "TtmSqueeze": ( lambda: ta.TtmSqueeze(20, 2.0, 1.5), lambda ind, h, l, c, v: ind.batch(h, l, c), ), "FractalChaosBands": ( lambda: ta.FractalChaosBands(2), lambda ind, h, l, c, v: ind.batch(h, l), ), } # Bands with 3 outputs upper/middle/lower from a candle (h, l, c). HLC_BAND3 = { "AccelerationBands": lambda: ta.AccelerationBands(20, 0.001), "StarcBands": lambda: ta.StarcBands(6, 15, 2.0), "AtrBands": lambda: ta.AtrBands(14, 3.0), "HurstChannel": lambda: ta.HurstChannel(10, 0.5), } # --- Scalar-input, multi-output indicators -------------------------------- # # Same shape contract as MULTI (batch returns (n, 2)) but streaming feeds a # single float instead of a candle tuple. MULTI_SCALAR_INPUT = { "KST": ( lambda: ta.KST(10, 15, 20, 30, 10, 10, 10, 15, 9), lambda ind, c: ind.batch(c), ), } @pytest.mark.parametrize("name", list(MULTI)) def test_multi_streaming_matches_batch(name, ohlcv): high, low, close, volume = ohlcv make, batch_call = MULTI[name] batch = batch_call(make(), high, low, close, volume) assert batch.shape == (close.size, 2) streamer = make() rows = [] for i in range(close.size): candle = ( float(close[i]), float(high[i]), float(low[i]), float(close[i]), float(volume[i]), i, ) v = streamer.update(candle) rows.append([math.nan, math.nan] if v is None else list(v)) assert _eq_nan(batch, np.array(rows, dtype=np.float64)), f"{name} mismatch" # --- Family 05: scalar-input multi-output band/channel indicators ---------- @pytest.mark.parametrize("name", list(SCALAR_MULTI)) def test_scalar_multi_streaming_matches_batch(name, sine_prices): make, cols = SCALAR_MULTI[name] batch = make().batch(sine_prices) assert batch.shape == (sine_prices.size, cols) streamer = make() rows = [] for p in sine_prices: v = streamer.update(float(p)) rows.append([math.nan] * cols if v is None else list(v)) assert _eq_nan(batch, np.array(rows, dtype=np.float64)), f"{name} mismatch" # --- Family 05: 3-band candle-input indicators ------------------------------ @pytest.mark.parametrize("name", list(HLC_BAND3)) def test_hlc_band3_streaming_matches_batch(name, ohlcv): high, low, close, _ = ohlcv make = HLC_BAND3[name] batch = make().batch(high, low, close) assert batch.shape == (close.size, 3) streamer = make() rows = [] for i in range(close.size): candle = ( float(close[i]), float(high[i]), float(low[i]), float(close[i]), 1.0, i, ) v = streamer.update(candle) rows.append([math.nan] * 3 if v is None else list(v)) assert _eq_nan(batch, np.array(rows, dtype=np.float64)), f"{name} mismatch" # --- VWAP StdDev Bands (4 outputs, needs volume) ---------------------------- def test_vwap_stddev_bands_streaming_matches_batch(ohlcv): high, low, close, volume = ohlcv batch = ta.VwapStdDevBands(2.0).batch(high, low, close, volume) assert batch.shape == (close.size, 4) streamer = ta.VwapStdDevBands(2.0) rows = [] for i in range(close.size): candle = ( float(close[i]), float(high[i]), float(low[i]), float(close[i]), float(volume[i]), i, ) v = streamer.update(candle) rows.append([math.nan] * 4 if v is None else list(v)) assert _eq_nan(batch, np.array(rows, dtype=np.float64)) @pytest.mark.parametrize("name", list(MULTI_SCALAR_INPUT)) def test_multi_scalar_streaming_matches_batch(name, ohlcv): _, _, close, _ = ohlcv make, batch_call = MULTI_SCALAR_INPUT[name] batch = batch_call(make(), close) assert batch.shape == (close.size, 2) streamer = make() rows = [] for p in close: v = streamer.update(float(p)) rows.append([math.nan, math.nan] if v is None else list(v)) assert _eq_nan(batch, np.array(rows, dtype=np.float64)), f"{name} mismatch" # --- ZeroLagMACD (scalar input, 3-tuple output: macd / signal / histogram) - def test_zero_lag_macd_streaming_matches_batch(ohlcv): _, _, close, _ = ohlcv batch = ta.ZeroLagMACD(12, 26, 9).batch(close) assert batch.shape == (close.size, 3) streamer = ta.ZeroLagMACD(12, 26, 9) rows = [] for p in close: v = streamer.update(float(p)) rows.append([math.nan, math.nan, math.nan] if v is None else list(v)) assert _eq_nan(batch, np.array(rows, dtype=np.float64)), "ZeroLagMACD mismatch" # --- Alligator (3-tuple output) ------------------------------------------- def test_alligator_streaming_matches_batch(ohlcv): high, low, _, _ = ohlcv alligator = ta.Alligator(13, 8, 5) batch = alligator.batch(high, low) assert batch.shape == (high.size, 3) streamer = ta.Alligator(13, 8, 5) rows = [] for i in range(high.size): candle = (float(low[i]), float(high[i]), float(low[i]), float(low[i]), 0.0, i) v = streamer.update(candle) rows.append([math.nan, math.nan, math.nan] if v is None else list(v)) assert _eq_nan(batch, np.array(rows, dtype=np.float64)), "Alligator mismatch" # --- Reference values ----------------------------------------------------- def test_typical_price_reference(): # (high + low + close) / 3 = (12 + 6 + 9) / 3 = 9. assert ta.TypicalPrice().update((9.0, 12.0, 6.0, 9.0, 1.0, 0)) == pytest.approx(9.0) def test_median_price_reference(): # (high + low) / 2 = (12 + 8) / 2 = 10. assert ta.MedianPrice().update((10.0, 12.0, 8.0, 11.0, 1.0, 0)) == pytest.approx(10.0) def test_weighted_close_reference(): # (high + low + 2*close) / 4 = (12 + 8 + 22) / 4 = 10.5. assert ta.WeightedClose().update((10.0, 12.0, 8.0, 11.0, 1.0, 0)) == pytest.approx( 10.5 ) def test_nvi_reference(): # closes [10, 11], volumes [200, 100]: volume contracts -> NVI absorbs +10%. # 1000 * (1 + 0.1) = 1100. nvi = ta.NVI() out = nvi.batch(np.array([10.0, 11.0]), np.array([200.0, 100.0])) assert out[0] == pytest.approx(1000.0) assert out[1] == pytest.approx(1100.0) def test_pvi_reference(): # closes [10, 11], volumes [100, 200]: volume expands -> PVI absorbs +10%. pvi = ta.PVI() out = pvi.batch(np.array([10.0, 11.0]), np.array([100.0, 200.0])) assert out[0] == pytest.approx(1000.0) assert out[1] == pytest.approx(1100.0) def test_volume_oscillator_reference(): # fast=2, slow=4 over volumes [10, 20, 30, 40, 50]: # bar 4 -> fast=(30+40)/2=35, slow=(10+20+30+40)/4=25 -> VO = 100*(35-25)/25 = 40. vo = ta.VolumeOscillator(2, 4) out = vo.batch(np.array([10.0, 20.0, 30.0, 40.0, 50.0])) assert math.isnan(out[2]) assert out[3] == pytest.approx(40.0) assert out[4] == pytest.approx(1000.0 / 35.0) def test_kvo_constant_series_is_zero(): # A flat series produces dm with no sign change; vf collapses to 0 every # bar and both EMAs hold at 0, so the KVO line stays at 0. kvo = ta.KVO(3, 6) high = np.full(60, 10.0) low = np.full(60, 10.0) close = np.full(60, 10.0) volume = np.full(60, 100.0) out = kvo.batch(high, low, close, volume) for v in out[~np.isnan(out)]: assert v == pytest.approx(0.0, abs=1e-12) def test_williams_ad_reference(): # bar 0 seeds prev_close = 10. # bar 1: prev=10, today high=13, low=8, close=12 (up day). # TR_l = min(10, 8) = 8 -> delta = 12 - 8 = 4. AD = 4. # bar 2: prev=12, today high=11, low=7, close=7 (down day). # TR_h = max(12, 11) = 12 -> delta = 7 - 12 = -5. AD = 4 - 5 = -1. ad = ta.WilliamsAD() high = np.array([11.0, 13.0, 11.0]) low = np.array([9.0, 8.0, 7.0]) close = np.array([10.0, 12.0, 7.0]) out = ad.batch(high, low, close) assert math.isnan(out[0]) assert out[1] == pytest.approx(4.0) assert out[2] == pytest.approx(-1.0) def test_anchored_vwap_reference(): # Three flat-OHLC bars: typical_price equals price. # 10@1, 20@1, 30@1 -> mean = 20. avwap = ta.AnchoredVWAP() high = np.array([10.0, 20.0, 30.0]) low = np.array([10.0, 20.0, 30.0]) close = np.array([10.0, 20.0, 30.0]) volume = np.array([1.0, 1.0, 1.0]) out = avwap.batch(high, low, close, volume) assert out[2] == pytest.approx(20.0) def test_anchored_vwap_set_anchor_clears_window(): # Drive a few flat bars, re-anchor, then drive a high-priced bar: # the new running mean must equal the new bar's typical price. avwap = ta.AnchoredVWAP() for _ in range(3): avwap.update((10.0, 10.0, 10.0, 10.0, 1.0, 0)) assert avwap.is_ready() avwap.set_anchor() v = avwap.update((100.0, 100.0, 100.0, 100.0, 5.0, 1)) assert v == pytest.approx(100.0) def test_tsv_reference(): # closes = [10, 11, 13, 12, 14, 15] # volumes = [50, 100, 200, 150, 50, 200] # flows = [None, 1*100=100, 2*200=400, -1*150=-150, 2*50=100, 1*200=200] # period=3: first emission at index 3. # bar 3 window=[100,400,-150] -> 350 # bar 4 window=[400,-150,100] -> 350 # bar 5 window=[-150,100,200] -> 150 tsv = ta.TSV(3) close = np.array([10.0, 11.0, 13.0, 12.0, 14.0, 15.0]) volume = np.array([50.0, 100.0, 200.0, 150.0, 50.0, 200.0]) out = tsv.batch(close, volume) assert math.isnan(out[0]) and math.isnan(out[1]) and math.isnan(out[2]) assert out[3] == pytest.approx(350.0) assert out[4] == pytest.approx(350.0) assert out[5] == pytest.approx(150.0) def test_vzo_strictly_rising_saturates_to_plus_100(): # Every bar is an up-day with identical volume -> signed_volume == volume, # so the smoothed signed-volume EMA equals the smoothed total-volume EMA, # giving a ratio of 1 -> VZO = +100. vzo = ta.VZO(5) close = np.array([10.0 + i for i in range(60)]) volume = np.full(60, 100.0) out = vzo.batch(close, volume) last = out[~np.isnan(out)][-1] assert last == pytest.approx(100.0) def test_market_facilitation_index_reference(): # (high - low) / volume = (12 - 8) / 200 = 0.02. mfi_bw = ta.MarketFacilitationIndex() high = np.array([12.0]) low = np.array([8.0]) volume = np.array([200.0]) out = mfi_bw.batch(high, low, volume) assert out[0] == pytest.approx(0.02) def test_demand_index_constant_series_is_zero(): # Flat close -> pressure = 0 every bar -> EMA stays at 0. di = ta.DemandIndex(5) high = np.full(60, 10.0) low = np.full(60, 10.0) close = np.full(60, 10.0) volume = np.full(60, 100.0) out = di.batch(high, low, close, volume) for v in out[~np.isnan(out)]: assert v == pytest.approx(0.0, abs=1e-12) def test_chaikin_money_flow_reference(): cmf = ta.ChaikinMoneyFlow(2) assert cmf.update((8.0, 10.0, 8.0, 10.0, 100.0, 0)) is None assert cmf.update((10.0, 12.0, 8.0, 10.0, 100.0, 1)) == pytest.approx(0.5) def test_linear_regression_reference(): out = ta.LinearRegression(3).batch(np.array([1.0, 2.0, 9.0])) assert math.isnan(out[0]) and math.isnan(out[1]) assert out[2] == pytest.approx(8.0) def test_linreg_slope_reference(): out = ta.LinRegSlope(3).batch(np.array([1.0, 2.0, 9.0])) assert math.isnan(out[0]) and math.isnan(out[1]) assert out[2] == pytest.approx(4.0) def test_balance_of_power_reference(): # (close - open) / (high - low) = (12 - 10) / (14 - 10) = 0.5. bop = ta.BalanceOfPower() assert bop.update((10.0, 14.0, 10.0, 12.0, 1.0, 0)) == pytest.approx(0.5) def test_true_range_reference(): tr = ta.TrueRange() assert tr.update((11.0, 12.0, 8.0, 11.0, 1.0, 0)) == pytest.approx(4.0) assert tr.update((9.5, 10.0, 9.0, 9.5, 1.0, 1)) == pytest.approx(2.0) def test_linreg_angle_reference(): # A series rising by 1 per step has slope 1, and atan(1) = 45 degrees. out = ta.LinRegAngle(5).batch(np.array([1.0, 2.0, 3.0, 4.0, 5.0, 6.0])) assert out[4] == pytest.approx(45.0) def test_wave_trend_flat_market_yields_zero(): # On a perfectly flat market the flat-tolerance guard keeps both lines # at exactly zero (otherwise the ratio ci = (ap - esa) / (0.015 * d) # would explode on the first esa ULP). out = ta.WaveTrend.classic().batch( np.full(80, 10.0), np.full(80, 10.0), np.full(80, 10.0) ) last = out[~np.isnan(out[:, 0])][-1] assert last[0] == 0.0 assert last[1] == 0.0 def test_kst_classic_constants_yield_zero(): out = ta.KST.classic().batch(np.full(120, 100.0)) last_row = out[~np.isnan(out[:, 0])][-1] assert last_row[0] == pytest.approx(0.0) assert last_row[1] == pytest.approx(0.0) def test_tii_pure_uptrend_saturates_at_100(): # On a strictly increasing series every close sits above the lagging # SMA, so every deviation is positive and TII reaches 100. prices = np.arange(80, dtype=np.float64) + 100.0 out = ta.TII(10, 5).batch(prices) last = out[~np.isnan(out)][-1] assert last == pytest.approx(100.0) def test_tii_flat_market_yields_50(): out = ta.TII(5, 4).batch(np.full(30, 10.0)) last = out[~np.isnan(out)][-1] assert last == 50.0 def test_rwi_reference_uptrend_dominates_low_line(): # In a pure linear uptrend RWI_High >> RWI_Low. n = 60 base = np.arange(n, dtype=np.float64) * 2.0 + 100.0 high = base + 1.0 low = base - 0.5 close = base + 0.5 out = ta.RWI(14).batch(high, low, close) last_row = out[~np.isnan(out[:, 0])][-1] assert last_row[0] > last_row[1], f"RWI_High {last_row[0]} must dominate RWI_Low {last_row[1]}" assert last_row[0] > 1.0 def test_adxr_reference_on_pure_uptrend(): # On a pure linear uptrend ADX saturates at 100, so ADXR (average of two # saturated ADX values period-1 bars apart) also reads 100. n = 100 base = np.arange(n, dtype=np.float64) * 2.0 + 100.0 high = base + 1.0 low = base - 0.5 close = base + 0.5 out = ta.ADXR(5).batch(high, low, close) last = out[~np.isnan(out)][-1] assert last == pytest.approx(100.0) def test_z_score_reference(): # Window [1, 3]: mean 2, population stddev 1; latest 3 -> z = 1. out = ta.ZScore(2).batch(np.array([1.0, 3.0])) assert math.isnan(out[0]) assert out[1] == pytest.approx(1.0) # --- Family 05 reference values --------------------------------------------- def test_ma_envelope_reference(): # SMA([10, 20, 30]) = 20; with percent = 0.10: upper = 22, lower = 18. out = ta.MaEnvelope(3, 0.10).batch(np.array([10.0, 20.0, 30.0])) assert math.isnan(out[0, 0]) and math.isnan(out[1, 0]) assert out[2, 0] == pytest.approx(22.0) # upper assert out[2, 1] == pytest.approx(20.0) # middle assert out[2, 2] == pytest.approx(18.0) # lower def test_acceleration_bands_reference(): # Single bar: high=12, low=8, close=10, factor=0.5, period=1. # ratio = 4/20 = 0.2; raw_up = 12·1.1 = 13.2; raw_lo = 8·0.9 = 7.2. v = ta.AccelerationBands(1, 0.5).update((10.0, 12.0, 8.0, 10.0, 1.0, 0)) assert v == pytest.approx((13.2, 10.0, 7.2)) def test_atr_bands_reference(): # Five identical bars (h=11, l=9, c=10) → ATR=2, close=10, mult=3: # upper=16, middle=10, lower=4. out = ta.AtrBands(5, 3.0).batch( np.array([11.0] * 5), np.array([9.0] * 5), np.array([10.0] * 5) ) assert math.isnan(out[3, 0]) assert out[4, 0] == pytest.approx(16.0) assert out[4, 1] == pytest.approx(10.0) assert out[4, 2] == pytest.approx(4.0) def test_hurst_channel_reference(): # Five identical (h=12, l=8, c=10): SMA(close)=10, range=4, mult=0.5. out = ta.HurstChannel(5, 0.5).batch( np.array([12.0] * 5), np.array([8.0] * 5), np.array([10.0] * 5) ) assert out[4, 0] == pytest.approx(12.0) assert out[4, 1] == pytest.approx(10.0) assert out[4, 2] == pytest.approx(8.0) def test_linreg_channel_reference(): # period 3 over [1, 2, 9]: line y=4x, endpoint=8, residuals=[1, -2, 1], # population sigma=sqrt(2); mult=2 → upper=8+2√2, lower=8-2√2. out = ta.LinRegChannel(3, 2.0).batch(np.array([1.0, 2.0, 9.0])) s = math.sqrt(2.0) assert out[2, 0] == pytest.approx(8.0 + 2.0 * s) assert out[2, 1] == pytest.approx(8.0) assert out[2, 2] == pytest.approx(8.0 - 2.0 * s) def test_standard_error_bands_reference(): # Same [1, 2, 9] with n=3: SSE=6, n-2=1, stderr=sqrt(6); mult=2 → # upper=8+2√6, lower=8-2√6. out = ta.StandardErrorBands(3, 2.0).batch(np.array([1.0, 2.0, 9.0])) s = math.sqrt(6.0) assert out[2, 0] == pytest.approx(8.0 + 2.0 * s) assert out[2, 1] == pytest.approx(8.0) assert out[2, 2] == pytest.approx(8.0 - 2.0 * s) def test_double_bollinger_orders_bands(): # On a non-trivial dispersion, outer >= inner >= middle >= -inner >= -outer. out = ta.DoubleBollinger(5, 1.0, 2.0).batch( np.array([1.0, 5.0, 2.0, 4.0, 3.0, 6.0]) ) v = out[5] assert v[0] >= v[1] >= v[2] >= v[3] >= v[4] def test_vwap_stddev_bands_reference(): # Two equal-volume bars with tp=8, tp=12: vwap=10, σ=2, mult=1.5 → # upper=13, lower=7. v = ta.VwapStdDevBands(1.5) v.update((8.0, 8.0, 8.0, 8.0, 1.0, 0)) out = v.update((12.0, 12.0, 12.0, 12.0, 1.0, 1)) assert out[0] == pytest.approx(13.0) assert out[1] == pytest.approx(10.0) assert out[2] == pytest.approx(7.0) assert out[3] == pytest.approx(2.0) def test_ttm_squeeze_flat_market(): # Zero volatility: BB and KC both collapse to a point → squeeze=1.0, # momentum=0.0. candles_h = np.array([10.0] * 25) out = ta.TtmSqueeze(20, 2.0, 1.5).batch(candles_h, candles_h, candles_h) assert out[24, 0] == pytest.approx(1.0) assert out[24, 1] == pytest.approx(0.0) def test_fractal_chaos_bands_detects_peak_and_trough(): # Sequence that creates one fractal high (i=2) and one low (i=3). h = np.array([1.0, 2.0, 5.0, 3.0, 2.0, 1.0, 2.0]) l = np.array([1.0, 2.0, 3.0, 0.5, 2.0, 1.0, 2.0]) out = ta.FractalChaosBands(2).batch(h, l) # First bar with both bands set is index 5. assert math.isnan(out[4, 0]) assert out[5, 0] == pytest.approx(5.0) assert out[5, 1] == pytest.approx(0.5) # --- Lifecycle ------------------------------------------------------------ def test_new_indicators_expose_lifecycle(): instances = [make() for make, _ in CANDLE_SCALAR.values()] instances += [make() for make, _ in MULTI.values()] instances += [make() for make, _ in MULTI_SCALAR_INPUT.values()] instances += [cls(*args) for cls, args in SCALAR] instances += [make() for make, _ in SCALAR_MULTI.values()] instances += [make() for make in HLC_BAND3.values()] instances += [ta.VwapStdDevBands(2.0)] instances.append(ta.Alligator(13, 8, 5)) instances.append(ta.ZeroLagMACD(12, 26, 9)) for ind in instances: assert ind.is_ready() is False assert ind.warmup_period() >= 1 ind.reset() assert ind.is_ready() is False