tensor_quant

Basic tensor quantization functions.

Classes

DynamicBlockQuantizationFunction

Dynamic block quantization functional.

FP4CastSTEFunction

FP4 cast with STE backward -- no scale/descale, just rounding.

FakeFP8Function

Fake quantize input to a supported FP8 format.

FakeTensorQuantFunction

Fake version of TensorQuantFunction use CUDA extension.

IntCastSTEFunction

Integer quantization cast with STE backward, analogous to FP4CastSTEFunction.

StaticBlockwiseFP4FakeQuantFunction

Static blockwise FP4 fake quantization functional.

Functions

e5m2_eager

Eager mode implementation of unscaled E5M2 quantization.

fake_quant_impl

Implementation of fake quantizing input according to number of bits.

fp8_eager

Eager mode implementation of FP8 quantization.

scaled_e4m3_impl

Implementation of fake quantizing input to FP8.

class DynamicBlockQuantizationFunction

Bases: Function

Dynamic block quantization functional.

static backward(ctx, grad_outputs)

Implements straight through estimation with clipping.

static forward(ctx, inputs, block_size, amax, bias, num_bits, scale_bits, trt_high_precision_dtype=None, onnx_quantizer_type='dynamic', pass_through_bwd=True)

Forward method.

static symbolic(g, inputs, block_size, amax, bias, num_bits, scale_bits, trt_high_precision_dtype=None, onnx_quantizer_type='dynamic', pass_through_bwd=True)

ONNX symbolic function.

class FP4CastSTEFunction

Bases: Function

FP4 cast with STE backward – no scale/descale, just rounding.

static backward(ctx, grad_outputs)

Backward pass: STE with clip mask at |x| <= 6.0.

static forward(ctx, x, out_dtype=None)

Forward pass: cast to FP4 using triton kernel.

Parameters:
  • x – Input tensor of shape [NUM_BLOCKS, BLOCK_SIZE].

  • out_dtype – Output dtype. Defaults to x.dtype.

class FakeFP8Function

Bases: Function

Fake quantize input to a supported FP8 format.

static backward(ctx, grad_outputs)

Implements straight through estimation with clipping.

static forward(ctx, inputs, amax, bias, E, M, trt_high_precision_dtype=None, pass_through_bwd=False)

Forward method.

static symbolic(g, inputs, amax=None, bias=None, E=4, M=3, trt_high_precision_dtype=None, pass_through_bwd=False)

ONNX symbolic function.

class FakeTensorQuantFunction

Bases: Function

Fake version of TensorQuantFunction use CUDA extension.

static backward(ctx, grad_outputs)

Implements straight through estimation with clipping.

static forward(ctx, inputs, amax, bias=None, num_bits=8, unsigned=False, narrow_range=True, trt_high_precision_dtype=None, pass_through_bwd=False, block_size=None, axis=None)

Forward method.

static symbolic(g, inputs, amax, bias=None, num_bits=8, unsigned=False, narrow_range=True, trt_high_precision_dtype=None, pass_through_bwd=False, block_size=None, axis=None)

ONNX symbolic function.

class IntCastSTEFunction

Bases: Function

Integer quantization cast with STE backward, analogous to FP4CastSTEFunction.

static backward(ctx, grad_outputs)

Backward pass: STE with clip mask.

static forward(ctx, x, num_bits, unsigned=False, narrow_range=True)

Forward pass: clamp-round to integer range.

class StaticBlockwiseFP4FakeQuantFunction

Bases: Function

Static blockwise FP4 fake quantization functional.

static backward(ctx, grad_outputs)

Implements straight through estimation with clipping.

static forward(ctx, x, amax, global_amax=None, quantize_block_scales=True, fp8_max_for_normalization=448.0, out_dtype=None, pass_through_bwd=False)

Forward method.

e5m2_eager(x)

Eager mode implementation of unscaled E5M2 quantization.

fake_quant_impl(inputs, amax, num_bits=8, unsigned=False, narrow_range=True)

Implementation of fake quantizing input according to number of bits.

Parameters:
  • inputs (Tensor)

  • amax (Tensor)

fp8_eager(x, amax)

Eager mode implementation of FP8 quantization.

scaled_e4m3_impl(inputs, amax=None)

Implementation of fake quantizing input to FP8.

Parameters:
  • inputs (Tensor) – Torch tensor.

  • amax (Tensor | None) – Absolute max range of the input tensor.

Returns:

Input tensors faked quantized to FP8.

Return type:

Tensor