Source code for megengine.amp.autocast

import functools

from ..core import _config
from ..core.tensor import amp


class autocast:
    r"""A class to control autocast mode for amp as a context manager or a decorator.

    Args:
        enabled: whether autocast mode is enabled.
        low_prec_dtype: set amp autocast mode's lower precision dtype. It will change
            the target dtype in tensor casting for better speed and memory. Default: float16.
        high_prec_dtype: set amp autocast mode's higher precision dtype. It will
            change the target dtype in tensor casting for better precision. Default: float32.

    Return:
        None
    
    Examples:
        .. code-block::

           # used as decorator
           @autocast()
           def train_step(image, label):
               with gm:
                   logits = model(image)
                   loss = F.nn.cross_entropy(logits, label)
                   gm.backward(loss)
               opt.step().clear_grad()
               return loss

           # used as context manager
           def train_step(image, label):
               with autocast():
                   with gm:
                       logits = model(image)
                       loss = F.nn.cross_entropy(logits, label)
                       gm.backward(loss)
               opt.step().clear_grad()
               return loss
    """

    def __init__(
        self,
        enabled: bool = True,
        low_prec_dtype: str = "float16",
        high_prec_dtype: str = "float32",
    ):
        self.enabled = enabled
        self.high_prec_dtype = high_prec_dtype
        self.low_prec_dtype = low_prec_dtype
        self._origin_enabled = None
        self._origin_high = None
        self._origin_low = None
        self._origin_configs = None

    def __enter__(self):
        if self.enabled:
            self._origin_enabled = amp._enabled
            self._origin_high = amp._get_amp_high_prec_dtype()
            self._origin_low = amp._get_amp_low_prec_dtype()
            amp._enabled = self.enabled
            amp._set_amp_dtype_autocast(self.enabled)
            amp._set_amp_high_prec_dtype(self.high_prec_dtype)
            amp._set_amp_low_prec_dtype(self.low_prec_dtype)

            self._origin_configs = _config._reset_execution_config(
                compute_mode="float32"
            )

    def __exit__(self, *args):
        if self.enabled:
            amp._enabled = self._origin_enabled
            amp._set_amp_dtype_autocast(self._origin_enabled)
            amp._set_amp_high_prec_dtype(self._origin_high)
            amp._set_amp_low_prec_dtype(self._origin_low)

            _config._reset_execution_config(*self._origin_configs)

    def __call__(self, func):
        @functools.wraps(func)
        def wrapper(*args, **kwargs):
            with self:
                return func(*args, **kwargs)

        return wrapper