<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/probability/blob/v0.25.0/tensorflow_probability/python/experimental/auto_batching/stack_optimization.py#L22-L79) |

Fuses pop+push sequences in the given `Program`.

#### View aliases


**Main aliases**

[`tfp.experimental.auto_batching.frontend.stack.fuse_pop_push`](https://www.tensorflow.org/probability/api_docs/python/tfp/experimental/auto_batching/stack_optimization/fuse_pop_push)

<br />

    tfp.experimental.auto_batching.stack_optimization.fuse_pop_push(
        program
    )

A stack pop followed by a stack push (with no intervening read) is equivalent
to just updating the top of the stack. The latter is more efficient for FULL
variables, because it just updates the cache for the top, and avoids gathering
from and scattering to the backing stack Tensor.

This pass mutates the `ControlFlowGraph` of the input `Program` to convert
pop+push sequences into updates. The pass will work despite intervening
instructions that interact with other Variables, but will not cross basic
block boundaries. As a side-effect, the pass moves non-optimized pops to the
last place in their basic block where they are still sound. This has no
effect on the runtime behavior of the program.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `program` | A lowered `Program` whose pop+push sequences to fuse. `Block`s in the program may be mutated. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| `fused` | A `Program` with statically redundant pop+push sequences eliminated in favor of `PrimOp`s with non-trivial `skip_push_mask` fields. |

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | If the input `Program` has not been lowered (i.e., contains `FunctionCallOp`), or is ill-formed (e.g., contains invalid instructions). |

<br />