# Relative Volatility Index (`ta.rvi`)



<a id="ta-rvi"></a>

Accumulate volatility according to rising and falling directions; this differs from relative vigor RVGI.

[Indicator catalog](https://docs.openbacktesting.com/reference/indicators/index.md) · [How to use indicators](https://docs.openbacktesting.com/reference/indicator-api/index.md)

## Run this example

This complete script uses bundled data. It observes the selected output without placing trades.

```python
import numpy as np
from openbacktesting import Backtest, Strategy
from openbacktesting.test import GOOG

data = GOOG.copy()

class Example(Strategy):
    def init(self):
        self.value = self.ta.rvi()
        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)
```

## Call and parameters

```python
self.ta.rvi(
    *,
    length=14,
    scalar=100,
    refined=False,
    thirds=False,
    mamode='ema',
    drift=1,
    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 |
| --- | --- | --- | --- | --- |
| `length` | Calculation window in observations. | `int` | `14` | Minimum: `1` |
| `scalar` | Multiplier applied to the formula output. | `int` | `100` | Minimum: `1` |
| `refined` | Enable the refined high/low variant. | `bool` | `False` | No additional constraints |
| `thirds` | Combine high/low/close variants. | `bool` | `False` | No additional constraints |
| `mamode` | Moving-average algorithm; choose one of the listed values. | `str` | `ema` | Allowed values: `['sma', 'ema', 'rma', 'wma']` |
| `drift` | Bar lag for differences. | `int` | `1` | Minimum: `1` |

`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](https://docs.openbacktesting.com/reference/indicator-api/index.md#bind-inputs-and-read-outputs).

## Inputs and outputs

Required inputs: `close`, `high`, `low`.

| Channel | Meaning |
| --- | --- |
| `rvi` | Relative Volatility Index 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](https://docs.openbacktesting.com/reference/indicators/index.md) · [Custom calculations](https://docs.openbacktesting.com/reference/strategy/index.md#register-custom-calculations)