# Tensor Fusion¶

One of the unique things about Horovod is its ability to interleave communication and computation coupled with the ability to batch small allreduce operations, which results in improved performance. We call this batching feature Tensor Fusion.

Tensor Fusion works by attempting to combine all the tensors that are ready to be reduced at given moment of time into one reduction operation. The algorithm of Tensor Fusion is as follows:

1. Determine which tensors are ready to be reduced. Select first few tensors that fit in HOROVOD_FUSION_THRESHOLD bytes and have the same data type.
2. Allocate fusion buffer of size HOROVOD_FUSION_THRESHOLD if it was not allocated before. Default fusion buffer size is 64 MB.
3. Copy data of selected tensors into the fusion buffer.
4. Execute the allreduce operation on the fusion buffer.
5. Copy data from the fusion buffer into the output tensors.
6. Repeat until there are no more tensors to reduce in this cycle.

The fusion buffer size can be adjusted using the --fusion-threshold-mb command line argument to horovodrun:

$horovodrun -np 4 --fusion-threshold-mb 32 python train.py  Setting --fusion-threshold-mb to zero disables Tensor Fusion: $ horovodrun -np 4 --fusion-threshold-mb 0 python train.py


You can tweak time between cycles (defined in milliseconds) using the --cycle-time-ms command line argument:

\$ horovodrun -np 4 --cycle-time-ms 3.5 python train.py