ufv_unstack#

t3toolbox.backend.ufv_operations.ufv_unstack(data, n_supercores)#
def ufv_unstack(
        data:         typ.Tuple,  # (*supercores, shape, masks): n_supercores arrays, int-tuple, 4-tuple of masks
        n_supercores: int,        # 4 (frame) or 2 (variations)
):  # -> nested tuple (shaped like stack_shape) of unstacked bv .data leaves

Unstack a (stacked) bv .data tuple into an array-like tree of unstacked ones (the WHOLE stack).

The supercores and the four rank masks unstack along the stack axes 1 .. len(stack_shape); shape is shared and replicated onto every leaf. Mirrors ut3_operations.ut3_unstack(); thin wrapper over ufv_unstack_axes() over the full stack.

Parameters:

  • data (t3toolbox.backend.common.typ.Tuple)

  • n_supercores (int)