Highest-value position (ta.highestbars)¶
Return the non-positive bar offset of the window maximum relative to the current bar; ties choose the rightmost position.
Indicator catalog · How to use indicators
Run this example¶
This complete script uses bundled data. It observes the selected output without placing trades.
import numpy as np
from openbacktesting import Backtest, Strategy
from openbacktesting.test import GOOG
data = GOOG.copy()
data["source"] = data.Close
class Example(Strategy):
def init(self):
self.value = self.ta.highestbars(inputs={'source': 'source'})
self.latest_value = None
def next(self):
channel = self.value
if channel.valid[-1]:
self.latest_value = float(channel[-1])
result = Backtest(data, Example).run()
print(result["_strategy"].latest_value)
Example inputs: source uses close prices.
Call and parameters¶
Register in init(). Read the returned channel in next() after checking valid[-1].
| Parameter | Meaning | Type | Default | Allowed values |
|---|---|---|---|---|
length |
Calculation window in observations. | int |
14 |
Minimum: 1; Maximum: 100000 |
source/named source arguments accept a column name or same-run single-channel handle. Alternatively, inputs maps each input below to a column or handle. backend selects a supported implementation; required_outputs selects channels for readiness diagnostics. See shared arguments and handles.
Inputs and outputs¶
Required inputs: source.
| Channel | Meaning |
|---|---|
highestbars |
Highest-value position value |
Reading values safely¶
Insufficient history or missing inputs can make a channel invalid. Check that channel's valid mask; ready is diagnostic and never suppresses next(). Multi-output results may have different valid channels on the same bar.