FP8 Emulation Toolkit

Caution

PROJECT NOT UNDER ACTIVE MANAGEMENT

• This project will no longer be maintained by Intel.
• Intel has ceased development and contributions including, but not limited to, maintenance, bug fixes, new releases, or updates, to this project.
• Intel no longer accepts patches to this project.
• If you have an ongoing need to use this project, are interested in independently developing it, or would like to maintain patches for the open source software community, please create your own fork of this project.

Introduction

This repository provides PyTorch tools to emulate the new FP8 formats on top of existing floating point hardware from Intel, AMD and NVIDIA. In addition to the two formats E5M2 and E4M3 defined in the joint specification from ARM-Intel-NVIDIA, the toolkit also suports a third variant named E3M4 which follows the guidelines established for E4M3 format.

Following table shows the binary formats and the numeric range:

	E5M2	E4M3	E3M4
Exponent Bias	15	7	3
Infinities	S.11111.002	N/A	N/A
NaNs	S.11111.{01, 10, 11}2	S.1111.1112	S.111.11112
Zeros	S.00000.002	S.0000.0002	S.000.00002
Max normal	S.11110.112=1.75 * 215=57344.0	S.1111.1102=1.75 * 28=448.0	S.111.11102=1.875 * 24=30.0
Min normal	S.00001.002=2-14=6.1e-05	S.0001.0002=2-6=1.5e-02	S.001.00002=2-2=2.5e-01
Max subnormal	S.00000.112=0.75 * 2-14=4.5e-05	S.0000.1112=0.875 * 2-6=1.3e-02	S.000.11112=0.9375 * 2-2=2.3e-01
Min subnormal	S.00000.012=2-16=1.5e-05	S.0000.0012=2-9=1.9e-03	S.000.00012=2-6=1.5e-02

Installation

Follow the instructions below to install FP8 Emulation Toolkit in a Python virtual environment. Alternatively, this installation can also be performed in a docker environment.

Requirements

This package can be installed on the following hardware.

• x86 CPUs from AMD and Intel
• GPU devices from NVIDIA(CUDA) and AMD(HIP)

Install or upgrade the following packages on your linux machine.

• Python >= 3.8.5
• NVIDIA CUDA >= 11.1 or AMD ROCm >= 5.6
• gcc >= 8.4.0

Make sure these versions are reflected in the $PATH

Target Hardware

• CPU >= All x86
• GPU >= V100, MI2XX

Create a Python virtual environment

$ python3 -m ~/py-venv
$ cd ~/py-venv
$ source bin/activate
$ pip3 install --upgrade pip3

Clone and install FP8 Emulation Toolkit

$ git clone https://github.com/IntelLabs/FP8-Emulation-Toolkit.git
$ cd FP8-Emulation-Toolkit
$ pip3 install -r requirements.txt
$ python setup.py install

Usage Examples

The emulated FP8 formats can be experimented with by integrated them into standard deep learning flows. Follow the links below for detailed instructions and code samples for exploring training and inference flows using FP8 data formats.

• Post-training quantization
• Mixed precision training

Related Work

This implementation is based on the following research. Check out the source material for more details on the training and inference methods.

@article{shen2023efficient,
  title={Efficient Post-training Quantization with FP8 Formats},
  author={Shen, Haihao and Mellempudi, Naveen and He, Xin and Gao, Qun and Wang, Chang and Wang, Mengni},
  journal={arXiv preprint arXiv:2309.14592},
  year={2023}
}

@misc{mellempudi2019mixed,
      title={Mixed Precision Training With 8-bit Floating Point}, 
      author={Naveen Mellempudi and Sudarshan Srinivasan and Dipankar Das and Bharat Kaul},
      year={2019},
      eprint={1905.12334},
      archivePrefix={arXiv},
      primaryClass={cs.LG}
}

@misc{micikevicius2022fp8,
      title={FP8 Formats for Deep Learning}, 
      author={Paulius Micikevicius and Dusan Stosic and Neil Burgess and Marius Cornea and Pradeep Dubey and Richard Grisenthwaite and Sangwon Ha and Alexander Heinecke and Patrick Judd and John Kamalu and Naveen Mellempudi and Stuart Oberman and Mohammad Shoeybi and Michael Siu and Hao Wu},
      year={2022},
      eprint={2209.05433},
      archivePrefix={arXiv},
      primaryClass={cs.LG}
}