Skip to content

Variable-period Moving Average (ta.mavp)

View Markdown

Use a caller-supplied per-bar periods series to vary the moving-average window within the permitted range.

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["periods"] = 10.0

class Example(Strategy):
    def init(self):
        self.value = self.ta.mavp(inputs={'close': 'Close', 'periods': 'periods'})
        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: periods is a per-bar period; the example fixes it at 10.

Call and parameters

self.ta.mavp(
    *,
    minperiod=2,
    maxperiod=30,
    mamode=0,
    inputs=None,
    backend=None,
    required_outputs=None,
)

Register in init(). Read the returned channel in next() after checking valid[-1].

Parameter Meaning Type Default Allowed values
minperiod Lower bound for variable moving-average periods. int 2 Minimum: 2
maxperiod Upper bound for variable moving-average periods. int 30 Minimum: 1
mamode Moving-average algorithm; choose one of the listed values. int 0 Minimum: 0; Maximum: 8

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: close, periods.

Channel Meaning
mavp Variable-period Moving Average 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.

Indicator catalog · Custom calculations