tf.contrib.quantize.experimental_create_training_graph

Rewrites a training input_graph in place for simulated quantization.

tf.contrib.quantize.experimental_create_training_graph(
    input_graph=None, weight_bits=8, activation_bits=8, symmetric=False,
    quant_delay=0, freeze_bn_delay=None, scope=None
)

This function must be invoked prior to insertion of gradient ops in a graph as quantization should be modeled in both forward and backward passes.

Variables added by the rewrite get added to the global variables collection.

This function has additional experimental options not (yet) available to create_training_graph. The resulting behavior may be undefined.

The graph has fake quantization ops inserted to simulate the error introduced by quantization. Since the graph is transformed in place, the expected behavior of previously held references to nodes and tensors may change.

The default value of quant_delay is suitable for finetuning an already trained floating point model (recommended). If one wants to train a quantized model from scratch, quant_delay should be set to the number of steps it take the floating point model to converge. Quantization will be activated at this point and effectively finetune the model. If quant_delay is not provided when training from scratch, training can often fail.

Args
input_graph	The tf.Graph to be transformed, if None then defaults to the default graph.
weight_bits	Number of bits to use for quantizing weights.
activation_bits	Number of bits to use for quantizing activations.
symmetric	If true, use symmetric quantization limits instead of training the minimum and maximum of each quantization range separately.
quant_delay	Number of steps after which weights and activations are quantized during training.
freeze_bn_delay	Number of steps after which moving mean and variance are frozen and used instead of batch statistics during training. freeze_bn_delay should be greater than quant_delay and should correspond to when training has almost converged
scope	The scope to be transformed. If it's not None, only the ops which are in this scope will be transformed.

Raises
ValueError	If elements contains an element that isn't a tf.Tensor or tf.Operation.