# Numerical Precision

This document describes the different methods implemented in TensorRT-LLM and contains a support matrix for the different models.

## FP32, FP16 and BF16

The different models implemented in TensorRT-LLM work with 32-bit IEEE floating-point (FP32) numbers. When checkpoints are available, the models also support 16-bit IEEE floating-point numbers (FP16) and 16-bit Bfloat16 (BF16) as described here.

## Quantization and Dequantization (Q/DQ)

Given a floating-point number `x`

and a floating-point scaling factor `s`

,
TensorRT-LLM implements INT8 quantization as:

```
q = int8.satfinite(x * s)
```

Given an INT8 number `q`

and a floating-point scaling factor `s`

, TensorRT-LLM
implements INT8 dequantization to the floating-point (FP) type as:

```
x = static_cast<FP>(q) * s
```

Given a matrix (2D tensor) of shape `M x N`

(`M`

rows and `N`

columns) where
`M`

is the number of tokens and `N`

is the number of channels. TensorRT-LLM has
the three following modes to quantize and dequantize the elements of the
tensor:

Per-tensor: It uses a single scaling factor for all the elements,

Per-token: It uses a different scaling factor for each token. There are

`M`

scaling factors in that case,Per-channel: It uses a different scaling factor for each channel. There are

`N`

scaling factors in that case.

Note that per-token and per-channel scaling modes can be used together (i.e.
they are *not* mutually exclusive).

In pseudo-code, the quantization can be implemented as follows for the three different modes:

```
# Per-tensor scaling.
for mi in range(M):
for ni in range(N):
q[mi][ni] = int8.satfinite(x[mi][ni] * s)
# Per-token scaling.
for mi in range(M):
for ni in range(N):
q[mi][ni] = int8.satfinite(x[mi][ni] * s[mi])
# Per-channel scaling.
for mi in range(M):
for ni in range(N):
q[mi][ni] = int8.satfinite(x[mi][ni] * s[ni])
```

## INT8 SmoothQuant (W8A8)

The SmoothQuant technique was introduced in https://arxiv.org/abs/2211.10438. It is a method to run inference using INT8 for both activations and weights while maintaining the accuracy of the network (on downstream tasks).

As explained in the research paper, preprocessing must be applied to the weights of the model. TensorRT-LLM includes scripts to prepare the model to run using the SmoothQuant method.

Examples of how to enable SmoothQuant for GPT, GPT-J and LLaMA can be found in the examples/quantization folder of that release.

## INT4 and INT8 Weight-Only (W4A16 and W8A16)

The INT4 and INT8 Weight-Only techniques consist in quantizing the weights of a model and dequantizing those weights on-the-fly in linear layers (Matmuls). The activations are encoded using floating-point values (FP16 or BF16).

To use INT4/INT8 Weight-Only methods, the user must determine the scaling factors to use to quantize and dequantize the weights of the model.

## GPTQ and AWQ (W4A16)

The GPTQ and AWQ techniques are presented in
https://arxiv.org/abs/2210.17323
and
https://arxiv.org/abs/2306.00978,
respectively. TensorRT-LLM supports per-group scaling factors and
zero-offsetting in linear layers to implement GPTQ and AWQ methods. See the
WeightOnlyGroupwiseQuantMatmulPlugin
plugin and the corresponding
`weight_only_groupwise_quant_matmul`

Python function, for details.

This release includes examples of applying GPTQ to GPT-NeoX and LLaMA-v2, as well as an example of using AWQ with GPT-J. Those examples are experimental implementations and are likely to evolve in a future release.

## FP8 (Hopper)

This release of TensorRT-LLM contains implementations of FP8 for GPT-NeMo, GPT-J and LLaMA. Those examples can be found in examples/quantization.

## Support matrix

This release of TensorRT-LLM contains the following examples:

Model |
FP32 |
FP16 |
BF16 |
FP8 |
W8A8 SQ |
W8A16 |
W4A16 |
W4A16 AWQ |
W4A16 GPTQ |
---|---|---|---|---|---|---|---|---|---|

Baichuan |
Y |
Y |
Y |
. |
Y |
Y |
Y |
. |
. |

BERT |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

BLIP-2 |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

BLOOM |
Y |
Y |
Y |
. |
Y |
Y |
Y |
. |
. |

ChatGLM |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

ChatGLM-v2 |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

ChatGLM-v3 |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

Falcon |
Y |
Y |
Y |
Y |
. |
. |
. |
. |
. |

Flan-T5 |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

GPT |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
. |
. |

GPT-J |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
. |

GPT-NeMo |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

GPT-NeoX |
Y |
Y |
Y |
. |
. |
. |
. |
. |
Y |

InternLM |
Y |
Y |
Y |
. |
Y |
Y |
Y |
. |
. |

LLaMA |
Y |
Y |
Y |
. |
Y |
Y |
Y |
Y |
Y |

LLaMA-v2 |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |

Mistral |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

MPT |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
. |

OPT |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

Replit Code |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

SantaCoder |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

StarCoder |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

T5 |
Y |
Y |
Y |
. |
. |
. |
. |
. |
. |

## Technical Detail: The `QuantMode`

Flags

The quantization method is controlled by the
`QuantMode`

flags. The different fields
are:

`INT4_WEIGHTS`

, the weights are quantized to 4 bits (W4A*),`INT8_WEIGHTS`

, the weights are quantized to 8 bits (W8A*),`ACTIVATIONS`

, the activations are quantized to 8 bits (W*A8),`PER_CHANNEL`

, the scaling factors are defined per channel,`PER_TOKEN`

, the scaling factors are defined per token,`PER_GROUP`

, the scaling factors are defined per group.

There are three additional flags to control TensorRT-LLM:

`INT8_KV_CACHE`

, the K/V cache stores K and V using 8-bit integers,`FP8_KV_CACHE`

, the K/V cache stores K and V using 8-bit floating-point numbers,`FP8_QDQ`

, TensorRT-LLM relies on automatic fusion of Q/DQ nodes in TensorRT.