Optimum 文档

优化

您正在查看的是需要从源码安装。如果你想要常规的 pip 安装,请查看最新稳定版本 (v1.27.0)。
Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

优化

optimum.fx.optimization 模块提供了一组 torch.fx 图转换,以及用于编写和组合您自己的转换的类和函数。

转换指南

在 🤗 Optimum 中,有两种转换:可逆转换和不可逆转换。

编写不可逆转换

最基本的转换是不可逆转换。这些转换无法逆转,这意味着在将它们应用于图模块后,无法恢复原始模型。要在 🤗 Optimum 中实现此类转换,非常简单:您只需继承 Transformation 并实现 transform() 方法。

例如,以下转换将所有乘法更改为加法

>>> import operator
>>> from optimum.fx.optimization import Transformation

>>> class ChangeMulToAdd(Transformation):
...     def transform(self, graph_module):
...         for node in graph_module.graph.nodes:
...             if node.op == "call_function" and node.target == operator.mul:
...                 node.target = operator.add
...         return graph_module

实现后,您的转换可以作为常规函数使用

>>> from transformers import BertModel
>>> from transformers.utils.fx import symbolic_trace

>>> model = BertModel.from_pretrained("bert-base-uncased")
>>> traced = symbolic_trace(
...     model,
...     input_names=["input_ids", "attention_mask", "token_type_ids"],
... )

>>> transformation = ChangeMulToAdd()
>>> transformed_model = transformation(traced)

编写可逆转换

可逆转换实现转换及其逆转换,允许从转换后的模型中检索原始模型。要实现此类转换,您需要继承 ReversibleTransformation 并实现 transform()reverse() 方法。

例如,以下转换是可逆的

>>> import operator
>>> from optimum.fx.optimization import ReversibleTransformation

>>> class MulToMulTimesTwo(ReversibleTransformation):
...     def transform(self, graph_module):
...         for node in graph_module.graph.nodes:
...             if node.op == "call_function" and node.target == operator.mul:
...                 x, y = node.args
...                 node.args = (2 * x, y)
...         return graph_module
...
...     def reverse(self, graph_module):
...         for node in graph_module.graph.nodes:
...             if node.op == "call_function" and node.target == operator.mul:
...                 x, y = node.args
...                 node.args = (x / 2, y)
...         return graph_module

组合转换

由于经常需要链式应用多个转换,因此提供了 compose()。它是一个实用函数,允许您通过链式连接多个其他转换来创建转换。

>>> from optimum.fx.optimization import compose
>>> composition = compose(MulToMulTimesTwo(), ChangeMulToAdd())
< > 在 GitHub 上更新