444 lines
20 KiB
Python
444 lines
20 KiB
Python
# Copyright The PyTorch Lightning team.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
r"""
|
|
ModelPruning
|
|
^^^^^^^^^^^^
|
|
"""
|
|
import inspect
|
|
from copy import deepcopy
|
|
from functools import partial
|
|
from typing import Any, Callable, List, Optional, Tuple, Union
|
|
|
|
import torch
|
|
import torch.nn.utils.prune as pytorch_prune
|
|
from torch import nn
|
|
|
|
from pytorch_lightning import _logger as log
|
|
from pytorch_lightning.callbacks.base import Callback
|
|
from pytorch_lightning.core.lightning import LightningModule
|
|
from pytorch_lightning.utilities import rank_zero_only
|
|
from pytorch_lightning.utilities.exceptions import MisconfigurationException
|
|
|
|
_PYTORCH_PRUNING_FUNCTIONS = {
|
|
"ln_structured": pytorch_prune.ln_structured,
|
|
"l1_unstructured": pytorch_prune.l1_unstructured,
|
|
"random_structured": pytorch_prune.random_structured,
|
|
"random_unstructured": pytorch_prune.random_unstructured,
|
|
}
|
|
|
|
_PYTORCH_PRUNING_METHOD = {
|
|
"ln_structured": pytorch_prune.LnStructured,
|
|
"l1_unstructured": pytorch_prune.L1Unstructured,
|
|
"random_structured": pytorch_prune.RandomStructured,
|
|
"random_unstructured": pytorch_prune.RandomUnstructured,
|
|
}
|
|
|
|
_PARAM_TUPLE = Tuple[nn.Module, str]
|
|
_PARAM_LIST = Union[List[_PARAM_TUPLE], Tuple[_PARAM_TUPLE]]
|
|
_MODULE_CONTAINERS = (LightningModule, nn.Sequential, nn.ModuleList, nn.ModuleDict)
|
|
|
|
|
|
class ModelPruning(Callback):
|
|
PARAMETER_NAMES = ("weight", "bias")
|
|
|
|
def __init__(
|
|
self,
|
|
pruning_fn: Union[Callable, str],
|
|
parameters_to_prune: Optional[_PARAM_LIST] = None,
|
|
parameter_names: Optional[List[str]] = None,
|
|
use_global_unstructured: bool = True,
|
|
amount: Union[int, float, Callable[[int], Union[int, float]]] = 0.5,
|
|
apply_pruning: Union[bool, Callable[[int], bool]] = True,
|
|
make_pruning_permanent: bool = True,
|
|
use_lottery_ticket_hypothesis: Union[bool, Callable[[int], bool]] = True,
|
|
resample_parameters: bool = False,
|
|
pruning_dim: Optional[int] = None,
|
|
pruning_norm: Optional[int] = None,
|
|
verbose: int = 0,
|
|
) -> None:
|
|
"""
|
|
Model pruning Callback, using PyTorch's prune utilities.
|
|
This callback is responsible of pruning networks parameters during training.
|
|
|
|
To learn more about pruning with PyTorch, please take a look at
|
|
`this tutorial <https://pytorch.org/tutorials/intermediate/pruning_tutorial.html>`_.
|
|
|
|
.. warning:: ``ModelPruning`` is in beta and subject to change.
|
|
|
|
.. code-block:: python
|
|
|
|
parameters_to_prune = [
|
|
(model.mlp_1, "weight"),
|
|
(model.mlp_2, "weight")
|
|
]
|
|
|
|
trainer = Trainer(callbacks=[
|
|
ModelPruning(
|
|
pruning_fn='l1_unstructured',
|
|
parameters_to_prune=parameters_to_prune,
|
|
amount=0.01,
|
|
use_global_unstructured=True,
|
|
)
|
|
])
|
|
|
|
When ``parameters_to_prune`` is ``None``, ``parameters_to_prune`` will contain all parameters from the model.
|
|
The user can override ``filter_parameters_to_prune`` to filter any ``nn.Module`` to be pruned.
|
|
|
|
Args:
|
|
|
|
pruning_fn: Function from torch.nn.utils.prune module or your own PyTorch ``BasePruningMethod`` subclass.
|
|
Can also be string e.g. `"l1_unstructured"`. See pytorch docs for more details.
|
|
|
|
parameters_to_prune: List of tuples ``(nn.Module, "parameter_name_string")``.
|
|
|
|
parameter_names: List of parameter names to be pruned from the nn.Module.
|
|
Can either be ``"weight"`` or ``"bias"``.
|
|
|
|
use_global_unstructured: Whether to apply pruning globally on the model.
|
|
If ``parameters_to_prune`` is provided, global unstructured will be restricted on them.
|
|
|
|
amount: Quantity of parameters to prune:
|
|
|
|
- ``float``. Between 0.0 and 1.0. Represents the fraction of parameters to prune.
|
|
- ``int``. Represents the absolute number of parameters to prune.
|
|
- ``Callable``. For dynamic values. Will be called every epoch. Should return a value.
|
|
|
|
apply_pruning: Whether to apply pruning.
|
|
|
|
- ``bool``. Always apply it or not.
|
|
- ``Callable[[epoch], bool]``. For dynamic values. Will be called every epoch.
|
|
|
|
make_pruning_permanent: Whether to remove all reparametrization pre-hooks and apply masks
|
|
when training ends or the model is saved.
|
|
|
|
use_lottery_ticket_hypothesis: See `The lottery ticket hypothesis <https://arxiv.org/pdf/1803.03635.pdf>`_:
|
|
|
|
- ``bool``. Whether to apply it or not.
|
|
- ``Callable[[epoch], bool]``. For dynamic values. Will be called every epoch.
|
|
|
|
resample_parameters: Used with ``use_lottery_ticket_hypothesis``. If True, the model parameters will
|
|
be resampled, otherwise, the exact original parameters will be used.
|
|
|
|
pruning_dim: If you are using a structured pruning method you need to specify the dimension.
|
|
|
|
pruning_norm: If you are using ``ln_structured`` you need to specify the norm.
|
|
|
|
verbose: Verbosity level. 0 to disable, 1 to log overall sparsity, 2 to log per-layer sparsity
|
|
|
|
Raises:
|
|
MisconfigurationException:
|
|
If ``parameter_names`` is neither ``"weight"`` nor ``"bias"``,
|
|
if the provided ``pruning_fn`` is not supported,
|
|
if ``pruning_dim`` is not provided when ``"unstructured"``,
|
|
if ``pruning_norm`` is not provided when ``"ln_structured"``,
|
|
if ``pruning_fn`` is neither ``str`` nor :class:`torch.nn.utils.prune.BasePruningMethod`, or
|
|
if ``amount`` is none of ``int``, ``float`` and ``Callable``.
|
|
"""
|
|
|
|
self._use_global_unstructured = use_global_unstructured
|
|
self._parameters_to_prune = parameters_to_prune
|
|
self._use_lottery_ticket_hypothesis = use_lottery_ticket_hypothesis
|
|
self._resample_parameters = resample_parameters
|
|
self._parameter_names = parameter_names or self.PARAMETER_NAMES
|
|
self._global_kwargs = {}
|
|
self._original_layers = None
|
|
self._pruning_fn_name = None
|
|
|
|
for name in self._parameter_names:
|
|
if name not in self.PARAMETER_NAMES:
|
|
raise MisconfigurationException(
|
|
f"The provided `parameter_names` name: {name} isn't in {self.PARAMETER_NAMES}"
|
|
)
|
|
|
|
if isinstance(pruning_fn, str):
|
|
pruning_kwargs = {}
|
|
pruning_fn = pruning_fn.lower()
|
|
if pruning_fn not in _PYTORCH_PRUNING_FUNCTIONS:
|
|
raise MisconfigurationException(
|
|
f"The provided `pruning_fn` {pruning_fn} isn't available in PyTorch's"
|
|
f" built-in functions: {list(_PYTORCH_PRUNING_FUNCTIONS.keys())} "
|
|
)
|
|
if pruning_fn.endswith("_structured"):
|
|
if pruning_dim is None:
|
|
raise MisconfigurationException(
|
|
"When requesting `structured` pruning, the `pruning_dim` should be provided."
|
|
)
|
|
if pruning_fn == "ln_structured":
|
|
if pruning_norm is None:
|
|
raise MisconfigurationException(
|
|
"When requesting `ln_structured` pruning, the `pruning_norm` should be provided."
|
|
)
|
|
pruning_kwargs["n"] = pruning_norm
|
|
pruning_kwargs["dim"] = pruning_dim
|
|
pruning_fn = self._create_pruning_fn(pruning_fn, **pruning_kwargs)
|
|
elif self._is_pruning_method(pruning_fn):
|
|
if not use_global_unstructured:
|
|
raise MisconfigurationException(
|
|
"PyTorch `BasePruningMethod` is currently only supported with `use_global_unstructured=True`."
|
|
)
|
|
else:
|
|
raise MisconfigurationException(
|
|
f"`pruning_fn` is expected to be a str in {list(_PYTORCH_PRUNING_FUNCTIONS.keys())}"
|
|
f" or a PyTorch `BasePruningMethod`. Found: {pruning_fn}."
|
|
" HINT: if passing a `BasePruningMethod`, pass the the class, not an instance"
|
|
)
|
|
|
|
if use_global_unstructured and pruning_fn.PRUNING_TYPE != "unstructured":
|
|
raise MisconfigurationException(
|
|
'Only the "unstructured" PRUNING_TYPE is supported with `use_global_unstructured=True`.'
|
|
f" Found method {pruning_fn} of type {pruning_fn.PRUNING_TYPE}. "
|
|
)
|
|
|
|
self.pruning_fn = pruning_fn
|
|
self._apply_pruning = apply_pruning
|
|
self._make_pruning_permanent = make_pruning_permanent
|
|
|
|
if not isinstance(amount, (int, float, Callable)):
|
|
raise MisconfigurationException(
|
|
"`amount` should be provided and be either an int, a float or Callable function."
|
|
)
|
|
|
|
self.amount = amount
|
|
|
|
if verbose not in (0, 1, 2):
|
|
raise MisconfigurationException("`verbose` must be any of (0, 1, 2)")
|
|
|
|
self._verbose = verbose
|
|
|
|
def filter_parameters_to_prune(self, parameters_to_prune: Optional[_PARAM_LIST] = None) -> Optional[_PARAM_LIST]:
|
|
"""
|
|
This function can be overridden to control which module to prune.
|
|
"""
|
|
return parameters_to_prune
|
|
|
|
def _create_pruning_fn(self, pruning_fn: str, **kwargs) -> Union[Callable, pytorch_prune.BasePruningMethod]:
|
|
"""
|
|
This function takes `pruning_fn`, a function name.
|
|
|
|
IF use_global_unstructured, pruning_fn will be resolved into its associated ``PyTorch BasePruningMethod``
|
|
ELSE, pruning_fn will be resolved into its function counterpart from `torch.nn.utils.prune`.
|
|
|
|
"""
|
|
if self._use_global_unstructured:
|
|
pruning_fn = _PYTORCH_PRUNING_METHOD[pruning_fn]
|
|
self._global_kwargs = kwargs
|
|
else:
|
|
pruning_fn = _PYTORCH_PRUNING_FUNCTIONS[pruning_fn]
|
|
# save the function __name__ now because partial does not include it
|
|
# and there are issues setting the attribute manually in ddp.
|
|
self._pruning_fn_name = pruning_fn.__name__
|
|
if self._use_global_unstructured:
|
|
return pruning_fn
|
|
return ModelPruning._wrap_pruning_fn(pruning_fn, **kwargs)
|
|
|
|
@staticmethod
|
|
def _wrap_pruning_fn(pruning_fn, **kwargs):
|
|
return partial(pruning_fn, **kwargs)
|
|
|
|
def make_pruning_permanent(self):
|
|
""" Makes ``parameters_to_prune`` current pruning permanent. """
|
|
for module, param_name in self._parameters_to_prune:
|
|
try:
|
|
pytorch_prune.remove(module, param_name)
|
|
except ValueError:
|
|
# pruning already made permanent
|
|
pass
|
|
|
|
def _restore_original_weights(self, module: nn.Module, orig_module: nn.Module, tensor_name: str):
|
|
trained = getattr(module, tensor_name)
|
|
orig = getattr(orig_module, tensor_name)
|
|
if trained is None or orig is None:
|
|
return
|
|
trained.data = orig.data.to(trained.device)
|
|
|
|
def apply_lottery_ticket_hypothesis(self):
|
|
r"""
|
|
Lottery ticket hypothesis algorithm (see page 2 of the paper):
|
|
|
|
1. Randomly initialize a neural network :math:`f(x; \theta_0)` (where :math:`\theta_0 \sim \mathcal{D}_\theta`).
|
|
2. Train the network for :math:`j` iterations, arriving at parameters :math:`\theta_j`.
|
|
3. Prune :math:`p\%` of the parameters in :math:`\theta_j`, creating a mask :math:`m`.
|
|
4. Reset the remaining parameters to their values in :math:`\theta_0`, creating the winning ticket :math:`f(x; m \odot \theta_0)`.
|
|
|
|
This function implements the step 4.
|
|
|
|
The ``resample_parameters`` argument can be used to reset the parameters with a new :math:`\theta_z \sim \mathcal{D}_\theta`
|
|
""" # noqa: E501
|
|
|
|
def copy_param(new, old, name: str) -> None:
|
|
dst = getattr(new, name)
|
|
src = getattr(old, name)
|
|
if dst is None or src is None or not isinstance(dst, torch.Tensor) or not isinstance(src, torch.Tensor):
|
|
return
|
|
dst.data = src.data.to(dst.device)
|
|
|
|
for d in self._original_layers.values():
|
|
copy, names = d["data"], d["names"]
|
|
if self._resample_parameters and hasattr(copy, "reset_parameters"):
|
|
copy = deepcopy(copy) # keep the original parameters
|
|
copy.reset_parameters()
|
|
for i, name in names:
|
|
new, new_name = self._parameters_to_prune[i]
|
|
copy_param(new, copy, name)
|
|
|
|
def _apply_local_pruning(self, amount: float):
|
|
for module, name in self._parameters_to_prune:
|
|
self.pruning_fn(module, name=name, amount=amount)
|
|
|
|
def _resolve_global_kwargs(self, amount: float):
|
|
self._global_kwargs["amount"] = amount
|
|
params = set(inspect.signature(self.pruning_fn).parameters)
|
|
params.discard("self")
|
|
return {k: v for k, v in self._global_kwargs.items() if k in params}
|
|
|
|
def _apply_global_pruning(self, amount: float):
|
|
pytorch_prune.global_unstructured(
|
|
self._parameters_to_prune, pruning_method=self.pruning_fn, **self._resolve_global_kwargs(amount)
|
|
)
|
|
|
|
@staticmethod
|
|
def _get_pruned_stats(module: nn.Module, name: str) -> Tuple[int, int]:
|
|
attr = f"{name}_mask"
|
|
if not hasattr(module, attr):
|
|
return 0, 1
|
|
mask = getattr(module, attr)
|
|
return (mask == 0).sum().item(), mask.numel()
|
|
|
|
def apply_pruning(self, amount: Union[int, float]):
|
|
""" Applies pruning to ``parameters_to_prune``. """
|
|
if self._verbose:
|
|
prev_stats = [self._get_pruned_stats(m, n) for m, n in self._parameters_to_prune]
|
|
|
|
if self._use_global_unstructured:
|
|
self._apply_global_pruning(amount)
|
|
else:
|
|
self._apply_local_pruning(amount)
|
|
|
|
if self._verbose:
|
|
curr_stats = [self._get_pruned_stats(m, n) for m, n in self._parameters_to_prune]
|
|
self._log_sparsity_stats(prev_stats, curr_stats, amount=amount)
|
|
|
|
@rank_zero_only
|
|
def _log_sparsity_stats(
|
|
self, prev: List[Tuple[int, int]], curr: List[Tuple[int, int]], amount: Union[int, float] = 0
|
|
):
|
|
total_params = sum(p.numel() for layer, _ in self._parameters_to_prune for p in layer.parameters())
|
|
prev_total_zeros = sum(zeros for zeros, _ in prev)
|
|
curr_total_zeros = sum(zeros for zeros, _ in curr)
|
|
log.info(
|
|
f"Applied `{self._pruning_fn_name}`. Pruned:"
|
|
f" {prev_total_zeros}/{total_params} ({prev_total_zeros / total_params:.2%}) ->"
|
|
f" {curr_total_zeros}/{total_params} ({curr_total_zeros / total_params:.2%})"
|
|
)
|
|
if self._verbose == 2:
|
|
for i, (module, name) in enumerate(self._parameters_to_prune):
|
|
prev_mask_zeros, prev_mask_size = prev[i]
|
|
curr_mask_zeros, curr_mask_size = curr[i]
|
|
log.info(
|
|
f"Applied `{self._pruning_fn_name}` to `{module!r}.{name}` with amount={amount}. Pruned:"
|
|
f" {prev_mask_zeros} ({prev_mask_zeros / prev_mask_size:.2%}) ->"
|
|
f" {curr_mask_zeros} ({curr_mask_zeros / curr_mask_size:.2%})"
|
|
)
|
|
|
|
def on_before_accelerator_backend_setup(self, trainer, pl_module):
|
|
parameters_to_prune = self.sanitize_parameters_to_prune(
|
|
pl_module, self._parameters_to_prune, parameter_names=self._parameter_names
|
|
)
|
|
|
|
self._parameters_to_prune = self.filter_parameters_to_prune(parameters_to_prune)
|
|
|
|
if self._use_lottery_ticket_hypothesis:
|
|
# group modules by id. Each entry has a copy of the initial data
|
|
# and a list of the associated parameter names to prune
|
|
self._original_layers = {}
|
|
for i, (module, name) in enumerate(self._parameters_to_prune):
|
|
id_ = id(module)
|
|
self._original_layers.setdefault(id_, {"data": deepcopy(module), "names": []})
|
|
self._original_layers[id_]["names"].append((i, name))
|
|
|
|
def on_train_epoch_end(self, trainer, pl_module, *args):
|
|
current_epoch = trainer.current_epoch
|
|
prune = self._apply_pruning(current_epoch) if isinstance(self._apply_pruning, Callable) else self._apply_pruning
|
|
amount = self.amount(current_epoch) if isinstance(self.amount, Callable) else self.amount
|
|
if not prune or not amount:
|
|
return
|
|
self.apply_pruning(amount)
|
|
|
|
if (
|
|
self._use_lottery_ticket_hypothesis(current_epoch)
|
|
if isinstance(self._use_lottery_ticket_hypothesis, Callable) else self._use_lottery_ticket_hypothesis
|
|
):
|
|
self.apply_lottery_ticket_hypothesis()
|
|
|
|
def on_train_end(self, *args):
|
|
if self._make_pruning_permanent:
|
|
self.make_pruning_permanent()
|
|
|
|
def on_save_checkpoint(self, *args):
|
|
if self._make_pruning_permanent:
|
|
self.make_pruning_permanent()
|
|
|
|
@staticmethod
|
|
def sanitize_parameters_to_prune(
|
|
pl_module: LightningModule,
|
|
parameters_to_prune: Optional[_PARAM_LIST] = None,
|
|
parameter_names: Optional[List[str]] = None,
|
|
) -> _PARAM_LIST:
|
|
"""
|
|
This function is responsible of sanitizing ``parameters_to_prune`` and ``parameter_names``.
|
|
If ``parameters_to_prune is None``, it will be generated with all parameters of the model.
|
|
|
|
Raises:
|
|
MisconfigurationException:
|
|
If ``parameters_to_prune`` doesn't exist in the model, or
|
|
if ``parameters_to_prune`` is neither a list of tuple nor ``None``.
|
|
"""
|
|
parameters = parameter_names or ModelPruning.PARAMETER_NAMES
|
|
|
|
current_modules = [m for m in pl_module.modules() if not isinstance(m, _MODULE_CONTAINERS)]
|
|
|
|
if parameters_to_prune is None:
|
|
parameters_to_prune = [(m, p) for p in parameters for m in current_modules if hasattr(m, p)]
|
|
elif (
|
|
isinstance(parameters_to_prune, (list, tuple)) and len(parameters_to_prune) > 0
|
|
and all(len(p) == 2 for p in parameters_to_prune)
|
|
and all(isinstance(a, nn.Module) and isinstance(b, str) for a, b in parameters_to_prune)
|
|
):
|
|
missing_modules, missing_parameters = [], []
|
|
for module, name in parameters_to_prune:
|
|
if module not in current_modules:
|
|
missing_modules.append(module)
|
|
continue
|
|
if not hasattr(module, name):
|
|
missing_parameters.append(name)
|
|
|
|
if missing_modules or missing_parameters:
|
|
raise MisconfigurationException(
|
|
"Some provided `parameters_to_tune` don't exist in the model."
|
|
f" Found missing modules: {missing_modules} and missing parameters: {missing_parameters}"
|
|
)
|
|
else:
|
|
raise MisconfigurationException(
|
|
"The provided `parameters_to_prune` should either be list of tuple"
|
|
" with 2 elements: (nn.Module, parameter_name_to_prune) or None"
|
|
)
|
|
|
|
return parameters_to_prune
|
|
|
|
@staticmethod
|
|
def _is_pruning_method(method: Any) -> bool:
|
|
if not inspect.isclass(method):
|
|
return False
|
|
return issubclass(method, pytorch_prune.BasePruningMethod)
|