# tf_agents.utils.common.shift_values

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/agents/blob/v0.19.0/tf_agents/utils/common.py#L842-L881) |

Shifts batch-major values in time by some amount.

    tf_agents.utils.common.shift_values(
        values, gamma, num_steps, final_values=None
    )

<br />

<br />

<br />

| ## Args ||
|---|---|
| `values` | A Tensor of shape \[batch_size, total_steps\] and dtype float32. |
| `gamma` | A float discount value. |
| `num_steps` | A nonnegative integer amount to shift values by. |
| `final_values` | A float32 Tensor of shape \[batch_size\] corresponding to the values at step num_steps + 1. Defaults to None (all zeros). |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A Tensor of shape \[batch_size, total_steps\], where each entry (i, j) is gamma\^num_steps \* values\[i, j + num_steps\] if j + num_steps \< total_steps; gamma\^(total_steps - j) \* final_values\[i\] otherwise. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | If values is not of rank 2. |

<br />