You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

traced_module.py 64 kB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750
  1. # MegEngine is Licensed under the Apache License, Version 2.0 (the "License")
  2. #
  3. # Copyright (c) 2014-2021 Megvii Inc. All rights reserved.
  4. #
  5. # Unless required by applicable law or agreed to in writing,
  6. # software distributed under the License is distributed on an
  7. # "AS IS" BASIS, WITHOUT ARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  8. import builtins
  9. import collections
  10. import copy
  11. import ctypes
  12. import fnmatch
  13. import functools
  14. import inspect
  15. import keyword
  16. import re
  17. import weakref
  18. from inspect import getcallargs, getmembers, isclass, ismethod
  19. from itertools import chain
  20. from typing import Callable, Dict, Iterable, List, Optional, Sequence, Type, Union
  21. from megengine import tensor
  22. from .. import functional as F
  23. from .. import get_logger
  24. from .. import module as M
  25. from ..core._imperative_rt.core2 import Tensor as RawTensor
  26. from ..core._imperative_rt.core2 import (
  27. is_tracing_module,
  28. set_module_tracing,
  29. unset_module_tracing,
  30. )
  31. from ..core._trace_option import set_symbolic_shape
  32. from ..core.tensor.array_method import ArrayMethodMixin
  33. from ..module import Module
  34. from ..module.qat import QATModule
  35. from ..quantization.fake_quant import LSQ, TQT, FakeQuantize, _FakeQuantize
  36. from ..quantization.observer import (
  37. ExponentialMovingAverageObserver,
  38. HistogramObserver,
  39. MinMaxObserver,
  40. Observer,
  41. PassiveObserver,
  42. SyncExponentialMovingAverageObserver,
  43. SyncMinMaxObserver,
  44. )
  45. from ..tensor import Tensor
  46. from .expr import Apply, CallFunction, CallMethod, Constant, Expr, GetAttr, Input
  47. from .fake_quant import FakeQuantize as TM_FakeQuant
  48. from .module_tracer import (
  49. PatchedFn,
  50. Patcher,
  51. active_module_tracer,
  52. get_tensor_wrapable_method,
  53. module_tracer,
  54. set_active_module_tracer,
  55. )
  56. from .node import ModuleNode, Node, NodeMixin, TensorNode
  57. from .pytree import ArgsIndex, tree_flatten
  58. from .utils import replace_container_with_module_container
  59. logger = get_logger(__name__)
  60. def _is_builtin_name(name: str) -> bool:
  61. return (
  62. name in builtins.__dict__
  63. or name in keyword.kwlist
  64. or name in {"inf", "nan", "NoneType"}
  65. )
  66. def _is_leaf(node):
  67. assert isinstance(node, RawTensor), "doesn't support {} in return values".format(
  68. type(node)
  69. )
  70. return isinstance(node, RawTensor)
  71. _enable_node_to_tensor = False
  72. def _convert_node_flag():
  73. return _enable_node_to_tensor
  74. def _set_convert_node_flag(flag: bool = False):
  75. global _enable_node_to_tensor
  76. pre_flag = _enable_node_to_tensor
  77. _enable_node_to_tensor = flag
  78. return pre_flag
  79. def _node_to_tensor(*args, **kwargs):
  80. tensors = []
  81. nodes, tree_def = tree_flatten((args, kwargs))
  82. for n in nodes:
  83. if isinstance(n, TensorNode):
  84. if n.top_graph is not None:
  85. active_module_tracer().current_scope()._add_input(n)
  86. value = n.value
  87. if value is None:
  88. flag = _set_convert_node_flag(False)
  89. unset_module_tracing()
  90. value = F.zeros(shape=n._shape, dtype=n._dtype)
  91. set_module_tracing()
  92. _set_convert_node_flag(flag)
  93. orig_n = NodeMixin.get(value, None)
  94. if orig_n is None or "setitem" not in orig_n._name:
  95. NodeMixin.wrap_safe(value, n)
  96. tensors.append(value)
  97. else:
  98. tensors.append(n)
  99. tensors = tree_def.unflatten(tensors)
  100. return tensors
  101. def _tensor_to_node(tensors):
  102. if tensors is None:
  103. return None
  104. nodes = []
  105. tensors, out_def = tree_flatten(tensors)
  106. for t in tensors:
  107. if isinstance(t, Tensor):
  108. n = NodeMixin.get(t, None)
  109. if isinstance(n, TensorNode):
  110. n.value = t
  111. nodes.append(n)
  112. else:
  113. nodes.append(t)
  114. else:
  115. nodes.append(t)
  116. nodes = out_def.unflatten(nodes)
  117. return nodes
  118. def _wrap_method_to_tensor_node():
  119. def _any_method(name):
  120. def _any(*args, **kwargs):
  121. args, kwargs = _node_to_tensor(*args, **kwargs)
  122. attr = getattr(args[0], name)
  123. outs = attr
  124. if callable(attr):
  125. outs = attr(*(args[1:]), **kwargs)
  126. if name == "__setitem__":
  127. _node_to_tensor(outs)
  128. return None
  129. outs = _tensor_to_node(outs)
  130. return outs
  131. return _any
  132. tensor_method_patch = []
  133. for method in get_tensor_wrapable_method():
  134. patch = PatchedFn(TensorNode, method)
  135. if type(getattr(Tensor, method)) == property:
  136. patch.set_func(property(_any_method(method)))
  137. else:
  138. patch.set_func(_any_method(method))
  139. tensor_method_patch.append(patch)
  140. return tensor_method_patch
  141. def _convert_node_and_tensor(orig_func):
  142. @functools.wraps(orig_func)
  143. def _convert(*args, **kwargs):
  144. if _convert_node_flag() and is_tracing_module():
  145. args, kwargs = _node_to_tensor(*args, **kwargs)
  146. rst = orig_func(*args, **kwargs, method_func=_convert)
  147. rst = _tensor_to_node(rst)
  148. return rst
  149. else:
  150. rst = orig_func(*args, **kwargs)
  151. return rst
  152. return _convert
  153. def _wrap_mnode_getattr(orig_getattr):
  154. @functools.wraps(orig_getattr)
  155. def wraped_fn(self, name):
  156. obj = self.owner
  157. if self.top_graph is not None:
  158. active_module_tracer().current_scope()._add_input(self)
  159. attr = getattr(obj, name)
  160. node = attr
  161. full_name = None
  162. if id(attr) in active_module_tracer().id2name:
  163. full_name = active_module_tracer().id2name[id(attr)]
  164. if not isinstance(attr, TracedModuleBuilder):
  165. if isinstance(attr, Module):
  166. attr = TracedModuleBuilder(attr)
  167. setattr(obj, name, attr)
  168. active_module_tracer().id2name[id(attr)] = full_name
  169. if isinstance(attr, (NodeMixin, RawTensor)):
  170. if full_name:
  171. scope_name = active_module_tracer().current_scope()._module_name
  172. if scope_name:
  173. full_name = full_name[len(scope_name) + 1 :]
  174. else:
  175. full_name = name
  176. else:
  177. full_name = name
  178. NodeMixin.wrap(
  179. attr,
  180. lambda: GetAttr.make(
  181. self,
  182. name,
  183. type=NodeMixin.get_wrapped_type(attr),
  184. orig_name=full_name,
  185. ),
  186. )
  187. if isinstance(attr, (NodeMixin, RawTensor)):
  188. node = NodeMixin.get(attr)
  189. if isinstance(node, ModuleNode):
  190. node._owner = weakref.ref(attr)
  191. return node
  192. return wraped_fn
  193. def _wrap_mnode_call(orig_call):
  194. @functools.wraps(orig_call)
  195. def wraped_fn(self, *args, **kwargs):
  196. obj = self.owner
  197. if self.top_graph is not None:
  198. active_module_tracer().current_scope()._add_input(self)
  199. rst = obj(*args, **kwargs)
  200. return rst
  201. return wraped_fn
  202. def _init_id2name(mod: Module, prefix: str = ""):
  203. id2name = {
  204. id(m): "%s.%s" % (prefix, key)
  205. for key, m in chain(
  206. mod.named_modules(), mod.named_parameters(), mod.named_buffers()
  207. )
  208. }
  209. return id2name
  210. class _InsertExprs:
  211. def __init__(self, graph, expr: Optional[Expr] = None):
  212. self.graph = graph
  213. self.global_scope = InternalGraph(
  214. graph._name, graph._prefix_name, graph._module_name
  215. )
  216. self.global_scope._used_names.update(graph._used_names)
  217. self.expr = expr
  218. self._tensor_method_patch = None
  219. def __enter__(self):
  220. self.use_sym_shape = set_symbolic_shape(True)
  221. set_module_tracing()
  222. _set_convert_node_flag(True)
  223. assert active_module_tracer() is None
  224. module = self.graph.inputs[0].owner
  225. _wrap_func = lambda x: _convert_node_and_tensor(_wrapped_function(x))
  226. set_active_module_tracer(
  227. module_tracer(_wrap_func, _init_id2name(module, self.graph._module_name))
  228. )
  229. active_module_tracer().patcher.__enter__()
  230. for cls, name, func in [
  231. [ModuleNode, "__getattr__", _wrap_mnode_getattr],
  232. [ModuleNode, "__call__", _wrap_mnode_call],
  233. [TracedModuleBuilder, "__call__", _convert_node_and_tensor],
  234. ]:
  235. active_module_tracer().patcher.patch_function(cls, name, func)
  236. self._tensor_method_patch = _wrap_method_to_tensor_node()
  237. active_module_tracer().push_scope(self.global_scope)
  238. def __exit__(self, ty, va, tr):
  239. if va is not None:
  240. return False
  241. set_symbolic_shape(self.use_sym_shape)
  242. unset_module_tracing()
  243. active_module_tracer().patcher.__exit__(ty, va, tr)
  244. _set_convert_node_flag(False)
  245. while self._tensor_method_patch:
  246. pf = self._tensor_method_patch.pop()
  247. pf.set_func(pf.origin_fn)
  248. module = self.graph.inputs[0].owner
  249. for mod, parent in module.modules(with_parent=True):
  250. name = mod._name
  251. if isinstance(mod, TracedModuleBuilder):
  252. mod = mod.build()
  253. if hasattr(mod, "graph"):
  254. for node in mod.graph.nodes():
  255. node.value = None
  256. setattr(parent, name, mod)
  257. set_active_module_tracer(None)
  258. for node in self.global_scope.nodes():
  259. node.value = None
  260. extra_inp_nodes = set(self.global_scope.inputs)
  261. max_inp_expr_idx = -1
  262. for node in extra_inp_nodes:
  263. assert (
  264. node.top_graph == self.graph
  265. ), "The input node ({}) is not in the graph ({})".format(node, self.graph)
  266. if isinstance(node, TensorNode) and node.expr in self.graph._exprs:
  267. max_inp_expr_idx = max(
  268. max_inp_expr_idx, self.graph._exprs.index(node.expr)
  269. )
  270. max_inp_expr_idx += 1
  271. insert_index = -1
  272. if self.expr is not None:
  273. insert_index = self.graph._exprs.index(self.expr)
  274. insert_index += 1
  275. if insert_index < max_inp_expr_idx:
  276. insert_index = max_inp_expr_idx
  277. anchor_index = insert_index - 1
  278. if anchor_index >= 0:
  279. logger.info(
  280. "The new expr will be inserted after ( {} )".format(
  281. self.graph._exprs[anchor_index]
  282. )
  283. )
  284. for expr in self.global_scope._exprs:
  285. self.graph._exprs.insert(insert_index, expr)
  286. insert_index += 1
  287. self.graph._used_names.update(self.global_scope._used_names)
  288. graph = self.graph
  289. while graph.top_graph is not None:
  290. graph = graph.top_graph
  291. graph.inputs[0].owner._update_ref()
  292. return True
  293. class InternalGraph:
  294. """
  295. ``InternalGraph`` is a graph consist of ``Node`` and ``Expr``, it is used to represent the execution procedure of Module's forward method.
  296. Attributes:
  297. _exprs: List of Exprs in order of execution
  298. _inputs: Input Nodes of InternalGraph
  299. _outputs: Output Nodes of InternalGraph
  300. """
  301. _exprs = None # type: List[Expr]
  302. _inputs = None # type: List[Node]
  303. _outputs = None # type: List[Node]
  304. _top_graph = None
  305. def __init__(self, name: str = None, prefix_name: str = "", module_name: str = ""):
  306. self._exprs = []
  307. self._inputs = []
  308. self._outputs = []
  309. self._watch_point = []
  310. self._end_point = []
  311. self._used_names = {}
  312. self._rst = collections.defaultdict(list)
  313. self._name = name
  314. self._prefix_name = prefix_name
  315. self._module_name = module_name
  316. def _insert(self, expr):
  317. self._exprs.append(expr)
  318. def _create_unique_name(self, name: str) -> str:
  319. assert isinstance(name, str), "The name must be a str"
  320. name = re.sub("[^0-9a-zA-Z_]+", "_", name)
  321. if name[0].isdigit():
  322. name = "_{}".format(name)
  323. while name in self._used_names or _is_builtin_name(name):
  324. match = re.match(r"(.*)_(\d+)$", name)
  325. if match is None:
  326. name = name + "_1"
  327. else:
  328. base, num = match.group(1, 2)
  329. name = "{}_{}".format(base, int(num) + 1)
  330. self._used_names.setdefault(name)
  331. return name
  332. @property
  333. def inputs(self):
  334. return self._inputs
  335. @property
  336. def outputs(self):
  337. return self._outputs
  338. @property
  339. def top_graph(self):
  340. if self._top_graph:
  341. return self._top_graph()
  342. return None
  343. def exprs(self, recursive=True):
  344. return ExprFilter(_expr_iter(self, recursive))
  345. def nodes(self, recursive=True):
  346. return NodeFilter(_node_iter(self, recursive))
  347. def get_function_by_type(self, func: Callable = None, recursive=True):
  348. return self.exprs(recursive).call_function(func)
  349. def get_method_by_type(self, method: str = None, recursive=True):
  350. return self.exprs(recursive).call_method(method)
  351. def get_expr_by_id(self, expr_id: List[int] = None, recursive=True):
  352. return self.exprs(recursive).expr_id(expr_id)
  353. def get_module_by_type(self, module_cls: Module, recursive=True):
  354. assert issubclass(module_cls, Module)
  355. return self.nodes(recursive).type(module_cls, ModuleNode)
  356. def get_node_by_id(self, node_id: List[int] = None, recursive=True):
  357. return self.nodes(recursive).node_id(node_id)
  358. def get_node_by_name(
  359. self, name: str = None, ignorecase: bool = True, recursive=True
  360. ):
  361. return self.nodes(recursive).name(name, ignorecase)
  362. def _add_input(self, i):
  363. self._inputs.append(i)
  364. def _add_output(self, o):
  365. self._outputs.append(o)
  366. def _replace_inputs_outputs(self, repl_dict, prefix_name="", module_name=""):
  367. for node, repl_node in repl_dict.items():
  368. assert node in self._inputs or node in self._outputs
  369. for i in node.users:
  370. if i not in repl_node.users:
  371. repl_node.users.append(i)
  372. for idx, i in enumerate(self._inputs):
  373. if i in repl_dict:
  374. self._inputs[idx] = repl_dict[i]
  375. for idx, o in enumerate(self._outputs):
  376. if o in repl_dict:
  377. repl_dict[o]._orig_name = "{}{}".format(module_name, o._orig_name)
  378. self._outputs[idx] = repl_dict[o]
  379. for expr in self._exprs:
  380. for idx, i in enumerate(expr.inputs):
  381. assert isinstance(
  382. i._name, str
  383. ), "The node ({}) name must be a str".format(i)
  384. if i in repl_dict:
  385. expr.inputs[idx] = repl_dict[i]
  386. elif isinstance(i, TensorNode) and prefix_name not in i._name:
  387. if i.top_graph != active_module_tracer().current_scope():
  388. i._name = (
  389. active_module_tracer()
  390. .current_scope()
  391. ._create_unique_name(prefix_name + i._name.lstrip("_"))
  392. )
  393. i._orig_name = "{}{}".format(module_name, i._orig_name)
  394. for idx, o in enumerate(expr.outputs):
  395. assert isinstance(
  396. o._name, str
  397. ), "The node ({}) name must be a str".format(i)
  398. if o in repl_dict:
  399. expr.outputs[idx] = repl_dict[o]
  400. expr.outputs[idx].expr = expr
  401. elif isinstance(o, TensorNode) and prefix_name not in i._name:
  402. if o.top_graph != active_module_tracer().current_scope():
  403. o._name = (
  404. active_module_tracer()
  405. .current_scope()
  406. ._create_unique_name(prefix_name + o._name.lstrip("_"))
  407. )
  408. o._orig_name = "{}{}".format(module_name, o._orig_name)
  409. def get_dep_exprs(self, nodes: Sequence[Node]) -> List[Expr]:
  410. if not isinstance(nodes, Sequence):
  411. nodes = (nodes,)
  412. ret = list()
  413. queue = list(nodes)
  414. visited_queue = list()
  415. while queue:
  416. node = queue.pop()
  417. visited_queue.append(node)
  418. expr = node.expr
  419. if expr not in ret:
  420. ret.append(expr)
  421. for i in expr.inputs:
  422. if i not in queue and i not in visited_queue:
  423. queue.append(i)
  424. return ret
  425. def reset_inputs(self, *args, **kwargs):
  426. forma_mnode = self.inputs[0]
  427. actual_mnodes = forma_mnode.actual_node
  428. call_nodes = []
  429. for n in actual_mnodes:
  430. for c_expr in n.users:
  431. if isinstance(c_expr, CallMethod) and c_expr.method == "__call__":
  432. call_nodes.append((c_expr, n))
  433. moudle = forma_mnode.owner
  434. assert moudle._is_top, "reset_inputs only support the top-level graph"
  435. inputs, tree_def = tree_flatten(((moudle, *args), kwargs))
  436. def create_node(val: Tensor):
  437. node = Input(type=TensorNode).outputs[0]
  438. node.shape = val.shape
  439. node.dtype = val.dtype
  440. return node
  441. formal_node_inputs = [
  442. forma_mnode,
  443. ]
  444. org_argdef = list(moudle.argdef_graph_map.keys())[0]
  445. if call_nodes:
  446. org_argdef = call_nodes[0][0].arg_def
  447. for v in inputs[1:]:
  448. assert isinstance(v, RawTensor)
  449. formal_node_inputs.append(create_node(v))
  450. actual_nodes = []
  451. for e, n in call_nodes:
  452. e.arg_def = tree_def
  453. actual_node_inputs = [
  454. n,
  455. ]
  456. for v in inputs[1:]:
  457. actual_node_inputs.append(create_node(v))
  458. for org_n in e.inputs:
  459. org_n.users.pop(e)
  460. e.inputs[:] = actual_node_inputs
  461. e.const_val = []
  462. actual_nodes.append(actual_node_inputs[1:])
  463. self._inputs[:] = formal_node_inputs
  464. moudle.argdef_graph_map[tree_def] = moudle.argdef_graph_map.pop(org_argdef)
  465. moudle.argdef_outdef_map[tree_def] = moudle.argdef_outdef_map.pop(org_argdef)
  466. # return formal_node_inputs[1:], actual_nodes
  467. return formal_node_inputs[1:]
  468. def add_input_node(self, shape, dtype="float32", name="args"):
  469. forma_mnode = self.inputs[0]
  470. actual_mnodes = forma_mnode.actual_node
  471. moudle = forma_mnode.owner
  472. assert moudle._is_top, "add_input_node only support the top-level graph"
  473. call_nodes = []
  474. for n in actual_mnodes:
  475. for c_expr in n.users:
  476. if isinstance(c_expr, CallMethod) and c_expr.method == "__call__":
  477. call_nodes.append(c_expr)
  478. def create_node(name=None, is_input: bool = True):
  479. if is_input:
  480. node = Input(type=TensorNode, name=name).outputs[0]
  481. else:
  482. node = TensorNode(expr=None, name=None)
  483. node.shape = shape
  484. node.dtype = dtype
  485. return node
  486. org_argdef = list(moudle.argdef_graph_map.keys())[0]
  487. if call_nodes:
  488. org_argdef = call_nodes[0].arg_def
  489. args, kwargs = org_argdef.unflatten(self._inputs)
  490. formal_inp_node = create_node(self._create_unique_name(name), True)
  491. inputs, tree_def = tree_flatten(
  492. ((*args, formal_inp_node), kwargs),
  493. is_const_leaf=lambda x: not isinstance(x, (TensorNode, ModuleNode)),
  494. )
  495. self._inputs[:] = inputs[:]
  496. actual_inp_nodes = []
  497. for e in call_nodes:
  498. args, kwargs = e.unflatten_args(e.inputs)
  499. args = args + (create_node(False),)
  500. inputs, tree_def = tree_flatten(
  501. (args, kwargs),
  502. is_const_leaf=lambda x: not isinstance(x, (TensorNode, ModuleNode)),
  503. )
  504. e.inputs[:] = inputs[:]
  505. e.arg_def = tree_def
  506. actual_inp_nodes.append(args[-1])
  507. moudle.argdef_graph_map[tree_def] = moudle.argdef_graph_map.pop(org_argdef)
  508. moudle.argdef_outdef_map[tree_def] = moudle.argdef_outdef_map.pop(org_argdef)
  509. # return formal_inp_node, actual_inp_nodes
  510. return formal_inp_node
  511. def reset_outputs(self, outputs):
  512. outputs, out_def = tree_flatten(
  513. outputs, is_leaf=lambda x: isinstance(x, TensorNode),
  514. )
  515. forma_mnode = self.inputs[0]
  516. moudle = forma_mnode.owner
  517. assert moudle._is_top, "reset_outputs only support the top-level graph"
  518. actual_mnodes = forma_mnode.actual_node
  519. call_nodes = []
  520. for n in actual_mnodes:
  521. for c_expr in n.users:
  522. if isinstance(c_expr, CallMethod) and c_expr.method == "__call__":
  523. call_nodes.append((c_expr))
  524. def create_node(val: TensorNode, expr: Expr):
  525. node = TensorNode(expr)
  526. node.shape = val.shape
  527. node.dtype = val.dtype
  528. return node
  529. tree_def = list(moudle.argdef_graph_map.keys())[0]
  530. if call_nodes:
  531. tree_def = call_nodes[0].arg_def
  532. actual_nodes = []
  533. for e in call_nodes:
  534. actual_node_outputs = []
  535. for v in outputs:
  536. actual_node_outputs.append(create_node(v, e))
  537. e.outputs[:] = actual_node_outputs
  538. e.out_def = out_def
  539. actual_nodes.append(actual_node_outputs)
  540. self._outputs[:] = outputs
  541. moudle.argdef_outdef_map[tree_def] = out_def
  542. return actual_nodes
  543. def add_output_node(self, node: TensorNode):
  544. forma_mnode = self.inputs[0]
  545. moudle = forma_mnode.owner
  546. assert moudle._is_top, "add_output_node only support the top-level graph"
  547. actual_mnodes = forma_mnode.actual_node
  548. call_nodes = []
  549. for n in actual_mnodes:
  550. for c_expr in n.users:
  551. if isinstance(c_expr, CallMethod) and c_expr.method == "__call__":
  552. call_nodes.append((c_expr))
  553. def create_node(val: TensorNode, expr: Expr):
  554. node = TensorNode(expr)
  555. node.shape = val.shape
  556. node.dtype = val.dtype
  557. return node
  558. tree_def = list(moudle.argdef_graph_map.keys())[0]
  559. if call_nodes:
  560. tree_def = call_nodes[0].arg_def
  561. org_out_def = moudle.argdef_outdef_map[tree_def]
  562. org_outs = org_out_def.unflatten(self._outputs)
  563. outputs, out_def = tree_flatten(
  564. (org_outs, node), is_leaf=lambda x: isinstance(x, TensorNode),
  565. )
  566. self._outputs[:] = outputs
  567. actual_out_nodes = []
  568. for e in call_nodes:
  569. actual_node = create_node(node, e)
  570. org_outs = org_out_def.unflatten(e.outputs)
  571. outputs, out_def = tree_flatten(
  572. (org_outs, actual_node), is_leaf=lambda x: isinstance(x, TensorNode),
  573. )
  574. e.outputs[:] = outputs
  575. e.out_def = out_def
  576. actual_out_nodes.append(actual_node)
  577. moudle.argdef_outdef_map[tree_def] = out_def
  578. return actual_out_nodes
  579. def insert_exprs(self, expr: Optional[Expr] = None):
  580. if expr is not None:
  581. assert expr.top_graph == self, "Expr to insert after is not in graph."
  582. return _InsertExprs(self, expr)
  583. def replace_node(self, repl_dict: Dict[Node, Node]):
  584. while repl_dict:
  585. node, repl_node = repl_dict.popitem()
  586. # check graph inputs and outputs
  587. # assert node not in self.inputs, "Cannot replace inputs"
  588. for i, n in enumerate(self.outputs):
  589. if n is node:
  590. self.outputs[i] = repl_node
  591. # update users of node and repl_node
  592. # update inputs of expr in node.users
  593. graph = repl_node.top_graph
  594. assert graph is not None
  595. index = graph._exprs.index(repl_node.expr)
  596. dep_exprs = self.get_dep_exprs(repl_node)
  597. i = 0
  598. while i < len(node.users):
  599. n = node.users[i]
  600. if n in graph._exprs and index >= graph._exprs.index(n):
  601. i += 1
  602. continue
  603. if n in dep_exprs:
  604. logger.info("Find a loop: ignore this replacement once")
  605. logger.info("node: %s" % node.__repr__())
  606. logger.info("expr: %s" % n.__repr__())
  607. i += 1
  608. continue
  609. repl_node.users.append(n)
  610. node.users.pop(i)
  611. idx = n.inputs.index(node)
  612. n.inputs[idx] = repl_node
  613. def compile(self):
  614. """
  615. Delete unused expr.
  616. """
  617. dep_exprs = self.get_dep_exprs(self.outputs)
  618. i = 0
  619. while i < len(self._exprs):
  620. expr = self._exprs[i]
  621. if expr in dep_exprs or expr._disable_remove:
  622. i += 1
  623. continue
  624. for n in expr.inputs:
  625. n.users.remove(expr)
  626. self._exprs.remove(expr)
  627. def interpret(self, *inputs):
  628. node2value = {}
  629. end_nodes_set = set(self._end_point)
  630. endnode2value = {}
  631. def get_all_endnode_val(n, v):
  632. if n in end_nodes_set:
  633. endnode2value[n] = v
  634. end_nodes_set.remove(n)
  635. return not end_nodes_set
  636. return False
  637. for n, v in zip(self._inputs, inputs):
  638. node2value[n] = v
  639. if n in self._watch_point:
  640. self._rst[n].append(v)
  641. if n in self._end_point and get_all_endnode_val(n, v):
  642. return list(endnode2value[i] for i in self._end_point)
  643. for expr in self._exprs:
  644. values = expr.interpret(*list(node2value[i] for i in expr.inputs))
  645. if values is not None:
  646. for n, v in zip(expr.outputs, values):
  647. node2value[n] = v
  648. if n in self._watch_point:
  649. self._rst[n] = v
  650. if self._end_point and get_all_endnode_val(n, v):
  651. return list(endnode2value[i] for i in self._end_point)
  652. return list(node2value[i] for i in self._outputs)
  653. def eval(self, *inputs):
  654. assert len(inputs) == len(self._inputs) - 1
  655. inp = [self._inputs[0].owner] + list(inputs)
  656. return self.interpret(*inp)
  657. def __repr__(self):
  658. return self.__format__()
  659. def __format__(self, format_spec: str = "") -> str:
  660. saved_format_spec = Node.set_format_spec(format_spec)
  661. name = ""
  662. if self._name:
  663. name = "%s.Graph" % self._name
  664. res = "{} ({}) {{\n\t{}\n\treturn {}\n}}".format(
  665. name,
  666. ", ".join(str(i) for i in self._inputs),
  667. "\n\t".join("{}".format(str(i)) for i in self._exprs),
  668. ", ".join(str(i) for i in self._outputs),
  669. )
  670. Node.set_format_spec(saved_format_spec)
  671. return res
  672. def __getstate__(self):
  673. state = self.__dict__.copy()
  674. if "_top_graph" in state:
  675. state.pop("_top_graph")
  676. return state
  677. def _get_meth_name(obj, func):
  678. tp = obj if isinstance(obj, type) else type(obj)
  679. for cls in tp.mro():
  680. for k, v in cls.__dict__.items():
  681. if v == func:
  682. return k
  683. return None
  684. def _wrapped_function(orig_func):
  685. @functools.wraps(orig_func)
  686. def wrapped_fn(*args, **kwargs):
  687. method_func = wrapped_fn
  688. if "method_func" in kwargs:
  689. method_func = kwargs.pop("method_func")
  690. if is_tracing_module():
  691. unset_module_tracing()
  692. inputs, tree_def = tree_flatten((args, kwargs))
  693. for i in inputs:
  694. if not NodeMixin.get(i, None):
  695. if isinstance(i, (RawTensor, NodeMixin)):
  696. NodeMixin.wrap_safe(i, Constant.make(i))
  697. meth_name, arg_type = None, None
  698. if args:
  699. meth_name = _get_meth_name(args[0], method_func)
  700. arg_type = args[0] if isinstance(args[0], type) else type(args[0])
  701. if meth_name and arg_type and issubclass(arg_type, RawTensor):
  702. self = inputs[0]
  703. if meth_name == "__new__":
  704. if all([not isinstance(i, RawTensor) for i in inputs]):
  705. # only trace Tensor.__new__() when there are tensors in args
  706. set_module_tracing()
  707. return orig_func(*args, **kwargs)
  708. if isinstance(args[1], RawTensor):
  709. node = NodeMixin.get(inputs[1])
  710. inputs[1] = copy.copy(inputs[1])
  711. # copy inputs[1] to avoid tensor and Tensor(tensor) share same m_tensor, which will cause they have same _NodeMixin__node in tracing.
  712. NodeMixin.wrap_safe(inputs[1], node)
  713. args, kwargs = tree_def.unflatten(inputs)
  714. call_node = CallMethod.make(self, meth_name)
  715. else:
  716. call_node = CallMethod.make(NodeMixin.get(self), meth_name)
  717. call_node.add_inputs(inputs[1:])
  718. else:
  719. call_node = CallFunction.make(orig_func)
  720. call_node.add_inputs(inputs)
  721. call_node.arg_def = tree_def
  722. rst = orig_func(*args, **kwargs)
  723. if meth_name == "__setitem__":
  724. rst = self
  725. if rst is not None:
  726. outputs, out_def = tree_flatten(rst, is_leaf=_is_leaf)
  727. call_node.out_def = out_def
  728. else:
  729. outputs = None
  730. call_node.add_outputs(outputs)
  731. set_module_tracing()
  732. return rst
  733. return orig_func(*args, **kwargs)
  734. return wrapped_fn
  735. class TracedModuleBuilder(NodeMixin):
  736. _mod = None # type: Module
  737. _body = None # type: InternalGraph
  738. _is_builtin = None # type: bool
  739. _argdef_graph_map = None # type: Dict[Treedef, "InternalGraph"]
  740. _argdef_outdef_map = None # type: Dict[Treedef, Treedef]
  741. nodes = None
  742. __builder_attributes__ = [
  743. "_mod",
  744. "_body",
  745. "_NodeMixin__node",
  746. "_is_builtin",
  747. "build",
  748. "_record_wrapped_nodes",
  749. "_argdef_graph_map",
  750. "_argdef_outdef_map",
  751. "nodes",
  752. "__class__",
  753. "__dict__",
  754. ]
  755. def __init__(self, mod, is_top_module=False):
  756. super(TracedModuleBuilder, self).__init__()
  757. assert isinstance(mod, Module)
  758. self._mod = mod
  759. self._body = None
  760. self._is_top = is_top_module
  761. self._is_builtin = (
  762. True
  763. if isinstance(mod, (Observer, _FakeQuantize))
  764. else module_tracer.is_builtin(mod)
  765. )
  766. if isinstance(self._mod, QATModule):
  767. unset_module_tracing()
  768. self._check_qat_module(self._mod)
  769. set_module_tracing()
  770. self._argdef_graph_map = {}
  771. self._argdef_outdef_map = {}
  772. self.nodes = set()
  773. # The builder will be passed to self._mod.forward as 'self' argument. If the 'forward' uses super().xxx to call method of its base classes, the trace procedure will throw exceprion, because the builder doesn't inherit from self._mod.__bases__.
  774. # modify self.__class__ and let the builder inherit from TracedModuleBuilder and mod.__class__.
  775. self.__class__ = type(
  776. "TracedModuleBuilder",
  777. (TracedModuleBuilder, mod.__class__),
  778. dict(TracedModuleBuilder.__dict__),
  779. )
  780. def _check_qat_module(self, qat_module):
  781. def isbuiltin(m):
  782. return m is None or module_tracer.is_builtin(m)
  783. if qat_module.with_act:
  784. act_observer = qat_module.act_observer
  785. act_fakequant = qat_module.act_fake_quant
  786. if not isbuiltin(act_observer) or not isbuiltin(act_fakequant):
  787. qparams = (
  788. act_observer.get_qparams()
  789. if hasattr(act_observer, "get_qparams")
  790. else act_fakequant.get_qparams()
  791. )
  792. dtype = (
  793. act_observer.dtype
  794. if hasattr(act_observer, "dtype")
  795. else act_fakequant.dtype
  796. )
  797. qat_module.act_observer = None
  798. qat_module.act_fake_quant = TM_FakeQuant(dtype)
  799. qat_module.act_fake_quant.set_qparams(qparams)
  800. if qat_module.with_weight:
  801. weight_observer = qat_module.weight_observer
  802. weight_fakequant = qat_module.weight_fake_quant
  803. if not isbuiltin(weight_observer) or not isbuiltin(weight_fakequant):
  804. qparams = (
  805. weight_observer.get_qparams()
  806. if hasattr(weight_observer, "get_qparams")
  807. else weight_fakequant.get_qparams()
  808. )
  809. dtype = (
  810. weight_observer.dtype
  811. if hasattr(weight_observer, "dtype")
  812. else weight_fakequant.dtype
  813. )
  814. qat_module.weight_observer = None
  815. qat_module.weight_fake_quant = TM_FakeQuant(dtype)
  816. qat_module.weight_fake_quant.set_qparams(qparams)
  817. def build(self):
  818. if self._is_builtin or isinstance(self._mod, TracedModule):
  819. if module_tracer.is_builtin(self._mod) or isinstance(
  820. self._mod, TracedModule
  821. ):
  822. mod_type = type(self._mod)
  823. else:
  824. assert isinstance(self._mod, (Observer, _FakeQuantize))
  825. mod_type = (
  826. Observer if isinstance(self._mod, Observer) else _FakeQuantize
  827. )
  828. for node in self.nodes:
  829. node.module_type = mod_type
  830. return self._mod
  831. else:
  832. is_qat = isinstance(self._mod, QATModule)
  833. traced_module = TracedModule(
  834. self._is_top, self._argdef_graph_map, self._argdef_outdef_map, is_qat
  835. )
  836. for _, g in self._argdef_graph_map.items():
  837. g.compile()
  838. for k, v in self.__dict__.items():
  839. if k not in TracedModuleBuilder.__builder_attributes__:
  840. if isinstance(v, TracedModuleBuilder):
  841. v = v.build()
  842. setattr(traced_module, k, v)
  843. elif isinstance(v, RawTensor):
  844. setattr(traced_module, k, v)
  845. if isinstance(self._mod, QATModule):
  846. unset_module_tracing()
  847. traced_module.with_act = self._mod.with_act
  848. traced_module.with_weight = self._mod.with_weight
  849. if not hasattr(traced_module, "act_fake_quant"):
  850. traced_module.act_fakequant = None
  851. if not hasattr(traced_module, "act_observer"):
  852. traced_module.act_observer = None
  853. if not hasattr(traced_module, "weight_fake_quant"):
  854. traced_module.weight_fakequant = None
  855. if not hasattr(traced_module, "weight_observer"):
  856. traced_module.weight_observer = None
  857. set_module_tracing()
  858. return traced_module
  859. def _record_wrapped_nodes(self, node):
  860. self.nodes.add(node)
  861. def __call__(self, *args, **kwargs):
  862. assert isinstance(self._mod, Module)
  863. # prepare args and kwargs for inner graph
  864. if "method_func" in kwargs:
  865. kwargs.pop("method_func")
  866. def mark_constant(x):
  867. node = NodeMixin.get(x, None)
  868. if node is None: # capture as constant
  869. NodeMixin.wrap(x, lambda: Constant.make(x))
  870. inputs, tree_def = tree_flatten(((self, *args), kwargs))
  871. for i in inputs:
  872. mark_constant(i)
  873. callnode = CallMethod.make(NodeMixin.get(self))
  874. callnode.add_inputs(inputs[1:])
  875. callnode.arg_def = tree_def
  876. if (
  877. self._is_builtin
  878. or tree_def in self._argdef_graph_map
  879. or isinstance(self._mod, TracedModule)
  880. ):
  881. unset_module_tracing()
  882. rst = self._mod(*args, **kwargs)
  883. outputs, out_def = tree_flatten(rst, is_leaf=_is_leaf)
  884. set_module_tracing()
  885. if self._is_builtin:
  886. self._body = None
  887. elif tree_def in self._argdef_graph_map:
  888. self._body = self._argdef_graph_map[tree_def]
  889. else:
  890. self._mod._is_top = False
  891. self._body = self._mod.graph
  892. else:
  893. self_node = None
  894. orig_self = NodeMixin.get(self)
  895. top_graph = active_module_tracer().current_scope()
  896. graph_prefix_name = top_graph._name
  897. if top_graph._prefix_name:
  898. graph_prefix_name = "{}_{}".format(
  899. top_graph._prefix_name, graph_prefix_name.lstrip("_")
  900. )
  901. module_name = orig_self._orig_name
  902. if top_graph._module_name:
  903. module_name = "{}.{}".format(top_graph._module_name, module_name)
  904. self._body = InternalGraph(
  905. orig_self._name, prefix_name=graph_prefix_name, module_name=module_name
  906. )
  907. active_module_tracer().push_scope(self._body)
  908. # rebind self to new input node
  909. if self_node:
  910. NodeMixin.wrap_safe(self, self_node)
  911. active_module_tracer().current_scope()._add_input(self_node)
  912. else:
  913. NodeMixin.wrap_safe(
  914. self,
  915. self_node
  916. if self_node
  917. else Input.make("self", NodeMixin.get_wrapped_type(self), ""),
  918. )
  919. origin_inp_node = [NodeMixin.get(i, None) for i in inputs[1:]]
  920. # prepare args and kwargs for inner graph
  921. index_args, index_kwargs = tree_def.unflatten(
  922. [
  923. ArgsIndex(0),
  924. *list(ArgsIndex(i + 1) for i in range(len(origin_inp_node))),
  925. ]
  926. )
  927. key2idx = getcallargs(type(self._mod).forward, *index_args, **index_kwargs)
  928. idx2key = {}
  929. for k, v in key2idx.items():
  930. if isinstance(v, ArgsIndex):
  931. idx2key[v.index] = k
  932. else:
  933. flatten_argidx, _ = tree_flatten(v)
  934. for _i, v in enumerate(flatten_argidx):
  935. if isinstance(v, ArgsIndex):
  936. idx2key[v.index] = k + "_%d" % _i
  937. def wrap(x, name):
  938. if isinstance(x, (RawTensor, NodeMixin)):
  939. NodeMixin.wrap(
  940. x,
  941. lambda: Input.make(
  942. type=NodeMixin.get_wrapped_type(x), name=name
  943. ),
  944. )
  945. return x
  946. args = [self]
  947. for i, v in enumerate(inputs[1:]):
  948. args.append(wrap(v, idx2key[i + 1]))
  949. args, kwargs = tree_def.unflatten(args)
  950. active_module_tracer().patcher.auto_patch(
  951. getattr(getattr(self._mod, "forward", self._mod), "__globals__", {})
  952. )
  953. rst = type(self._mod).forward(*args, **kwargs)
  954. if _convert_node_flag():
  955. rst = _node_to_tensor(rst)[0][0]
  956. outputs, out_def = tree_flatten(rst, is_leaf=_is_leaf)
  957. for i in (
  958. outputs if isinstance(outputs, collections.abc.Sequence) else (outputs,)
  959. ):
  960. active_module_tracer().current_scope()._add_output(NodeMixin.get(i))
  961. NodeMixin.wrap_safe(self, orig_self)
  962. for arg, node in zip(inputs[1:], origin_inp_node):
  963. if node:
  964. NodeMixin.wrap_safe(arg, node)
  965. active_module_tracer().pop_scope()
  966. # rebind output to outer graph
  967. callnode.out_def = out_def
  968. callnode.add_outputs(outputs)
  969. self._argdef_graph_map[callnode.arg_def] = self._body
  970. self._argdef_outdef_map[callnode.arg_def] = out_def
  971. return rst
  972. def __setattr__(self, name, value):
  973. object.__setattr__(self, name, value)
  974. def __repr__(self):
  975. return repr(self._mod)
  976. def __getattr__(self, name):
  977. if name not in self._mod.__dict__:
  978. attr = getattr(type(self._mod), name).__get__(self, type(self))
  979. else:
  980. attr = getattr(self._mod, name)
  981. full_name = None
  982. if id(attr) in active_module_tracer().id2name:
  983. full_name = active_module_tracer().id2name[id(attr)]
  984. if isinstance(attr, (List, Dict)):
  985. unset_module_tracing()
  986. has_module, m_container = replace_container_with_module_container(attr)
  987. if m_container:
  988. attr = m_container
  989. if has_module and not m_container:
  990. raise ValueError(
  991. "Can not trace the module that uses the same container to store Module and Non-Module objects "
  992. )
  993. set_module_tracing()
  994. if isinstance(attr, Module):
  995. attr = TracedModuleBuilder(attr)
  996. if isinstance(attr, (Module, RawTensor)):
  997. setattr(self, name, attr)
  998. active_module_tracer().id2name[id(attr)] = full_name
  999. if full_name:
  1000. scope_name = active_module_tracer().current_scope()._module_name
  1001. if scope_name:
  1002. full_name = full_name[len(scope_name) + 1 :]
  1003. else:
  1004. full_name = name
  1005. else:
  1006. full_name = name
  1007. NodeMixin.wrap(
  1008. attr,
  1009. lambda: GetAttr.make(
  1010. NodeMixin.get(self),
  1011. name,
  1012. type=NodeMixin.get_wrapped_type(attr),
  1013. orig_name=full_name,
  1014. ),
  1015. )
  1016. return attr
  1017. def __getattribute__(self, name):
  1018. if name in TracedModuleBuilder.__builder_attributes__:
  1019. return object.__getattribute__(self, name)
  1020. else:
  1021. wrapped = object.__getattribute__(self, name)
  1022. class_members = dict(inspect.getmembers(self.__class__))
  1023. if name in self._mod.__dict__:
  1024. mod_attr = getattr(self._mod, name)
  1025. if name in class_members:
  1026. if (
  1027. not isinstance(wrapped, TracedModuleBuilder)
  1028. and wrapped is not mod_attr
  1029. ):
  1030. wrapped = self.__getattr__(name)
  1031. if isinstance(wrapped, TracedModuleBuilder):
  1032. if not isinstance(mod_attr, (List, Dict)):
  1033. assert mod_attr is wrapped._mod
  1034. else:
  1035. assert mod_attr is wrapped
  1036. full_name = None
  1037. if id(mod_attr) in active_module_tracer().id2name:
  1038. full_name = active_module_tracer().id2name[id(mod_attr)]
  1039. scope_name = active_module_tracer().current_scope()._module_name
  1040. if full_name and scope_name:
  1041. full_name = full_name[len(scope_name) + 1 :]
  1042. else:
  1043. full_name = name
  1044. else:
  1045. full_name = name
  1046. # assert not self._is_builtin
  1047. if isinstance(wrapped, (NodeMixin, RawTensor)):
  1048. NodeMixin.wrap(
  1049. wrapped,
  1050. lambda: GetAttr.make(
  1051. NodeMixin.get(self),
  1052. name,
  1053. type=NodeMixin.get_wrapped_type(wrapped),
  1054. orig_name=full_name,
  1055. ),
  1056. )
  1057. return wrapped
  1058. class _expr_iter:
  1059. def __init__(self, graph: InternalGraph, recursive: bool = True):
  1060. self.graph = graph
  1061. self.recursive = recursive
  1062. def __iter__(self):
  1063. for expr in self.graph._exprs:
  1064. if isinstance(expr, CallMethod) and isinstance(expr.inputs[0], ModuleNode):
  1065. yield expr
  1066. if self.recursive and expr.graph is not None:
  1067. yield from expr.graph.exprs(self.recursive)
  1068. else:
  1069. yield expr
  1070. class _node_iter:
  1071. def __init__(self, graph: InternalGraph, recursive: bool = True) -> None:
  1072. nodes = []
  1073. node_ids = set()
  1074. for expr in graph.exprs(recursive):
  1075. for n in expr.inputs + expr.outputs:
  1076. if n._id in node_ids:
  1077. continue
  1078. nodes.append(n)
  1079. node_ids.add(n._id)
  1080. self.nodes = list(sorted(nodes, key=lambda x: x._id))
  1081. def __iter__(self):
  1082. for node in self.nodes:
  1083. yield node
  1084. class BaseFilter:
  1085. def __init__(self, expr_iter: Iterable):
  1086. self._iter = expr_iter
  1087. def __iter__(self):
  1088. return iter(self._iter)
  1089. def as_list(self):
  1090. return list(self)
  1091. def as_dict(self):
  1092. return collections.OrderedDict((i._id, i) for i in self)
  1093. def as_unique(self):
  1094. rst = self.as_list()
  1095. assert len(rst) == 1, "{} elements found".format(len(rst))
  1096. (expr,) = self
  1097. return expr
  1098. def as_count(self):
  1099. return sum(1 for _ in self)
  1100. class ExprFilter(BaseFilter):
  1101. def call_function(self, func):
  1102. return ExprFilterCallFunction(self, func)
  1103. def call_method(self, method):
  1104. return ExprFilterCallMethod(self, method)
  1105. def expr_id(self, expr_id: List[int]):
  1106. return ExprFilterExprId(self, expr_id)
  1107. class NodeFilter(BaseFilter):
  1108. def type(self, owner_type, node_type):
  1109. return NodeFilterType(self, owner_type, node_type)
  1110. def node_id(self, node_id: List[int]):
  1111. return NodeFilterNodeId(self, node_id)
  1112. def name(self, name: str, ignorecase: bool = True):
  1113. return NodeFilterName(self, name, ignorecase)
  1114. class NodeFilterType(NodeFilter):
  1115. def __init__(self, expr_iter, owner_type, node_type):
  1116. super().__init__(expr_iter)
  1117. self.owner_type = owner_type
  1118. self.node_type = node_type
  1119. def __iter__(self):
  1120. for node in self._iter:
  1121. if not isinstance(node, self.node_type):
  1122. continue
  1123. if not hasattr(node, "owner"):
  1124. continue
  1125. if isinstance(node.owner, self.owner_type):
  1126. yield node
  1127. class NodeFilterNodeId(NodeFilter):
  1128. def __init__(self, expr_iter, node_id: List[int]):
  1129. super().__init__(expr_iter)
  1130. if not isinstance(node_id, Sequence):
  1131. node_id = [node_id]
  1132. self.node_id = node_id
  1133. def __iter__(self):
  1134. for node in self._iter:
  1135. if node._id in self.node_id:
  1136. yield node
  1137. class NodeFilterName(NodeFilter):
  1138. _re = None
  1139. def __init__(self, node_iter, pattern, ignorecase):
  1140. super().__init__(node_iter)
  1141. self.pattern = pattern
  1142. self._re = self.make_re(pattern, ignorecase)
  1143. @classmethod
  1144. def make_re(cls, pattern, ignorecase=True):
  1145. assert isinstance(pattern, str), "bad pattern: {!r}".format(pattern)
  1146. assert isinstance(ignorecase, bool)
  1147. flags = 0
  1148. if ignorecase:
  1149. flags |= re.IGNORECASE
  1150. return re.compile(fnmatch.translate(pattern), flags=flags)
  1151. def __iter__(self):
  1152. for i in self._iter:
  1153. graph = i.top_graph
  1154. name = "{}_{}".format(graph._name, i._name.lstrip("_"))
  1155. if graph._prefix_name:
  1156. name = "{}_{}".format(graph._prefix_name, name.lstrip("_"))
  1157. if self.pattern == name or self._re.match(name):
  1158. yield i
  1159. class ExprFilterCallFunction(ExprFilter):
  1160. def __init__(self, expr_iter, func: Callable = None):
  1161. super().__init__(expr_iter)
  1162. self.func = func
  1163. def __iter__(self):
  1164. for expr in self._iter:
  1165. if not isinstance(expr, CallFunction):
  1166. continue
  1167. if self.func is None or expr.func == self.func:
  1168. yield expr
  1169. class ExprFilterCallMethod(ExprFilter):
  1170. def __init__(self, expr_iter, method: str = None):
  1171. super().__init__(expr_iter)
  1172. self.method = method
  1173. def __iter__(self):
  1174. for expr in self._iter:
  1175. if not isinstance(expr, CallMethod):
  1176. continue
  1177. if self.method is None or expr.method == self.method:
  1178. yield expr
  1179. class ExprFilterExprId(ExprFilter):
  1180. def __init__(self, expr_iter, expr_id: List[int]):
  1181. super().__init__(expr_iter)
  1182. if not isinstance(expr_id, Sequence):
  1183. expr_id = [expr_id]
  1184. self.expr_id = expr_id
  1185. def __iter__(self):
  1186. for expr in self._iter:
  1187. if expr._id in self.expr_id:
  1188. yield expr
  1189. class TracedModule(Module):
  1190. """
  1191. `TracedModule` is the Module created by tracing normal module. It owns an argdef to graph(InternalGraph) map. The forward method of `TracedModule` will get a graph from `argdef_graph_map` according to the argdef of input args/kwargs and interpret it.
  1192. """
  1193. # m_node = None # type: ModuleNode
  1194. argdef_graph_map = None
  1195. argdef_outdef_map = None
  1196. def __init__(self, is_top, argdef_graph_map, argdef_outdef_map, is_qat=False):
  1197. super(TracedModule, self).__init__()
  1198. self.argdef_graph_map = argdef_graph_map
  1199. self.argdef_outdef_map = argdef_outdef_map
  1200. self._is_top = is_top
  1201. self.watch_points = []
  1202. self.watch_node_value = {}
  1203. self.end_points = []
  1204. self.is_qat = is_qat
  1205. def forward(self, *args, **kwargs):
  1206. inputs, treedef = tree_flatten(((self, *args), kwargs))
  1207. assert treedef in self.argdef_graph_map
  1208. inputs = filter(
  1209. lambda i: isinstance(i, (Module, TracedModuleBuilder, RawTensor)), inputs
  1210. ) # allow TracedModuleBuilder for retrace.
  1211. outputs = self.argdef_graph_map[treedef].interpret(*inputs)
  1212. if self.watch_points:
  1213. self.watch_node_value = {}
  1214. for n in self.watch_points:
  1215. self.watch_node_value[n] = n.top_graph._rst.pop(n)
  1216. if self.end_points:
  1217. return outputs
  1218. out_def = self.argdef_outdef_map[treedef]
  1219. outputs = out_def.unflatten(outputs)
  1220. return outputs
  1221. def set_watch_points(self, nodes):
  1222. if not isinstance(nodes, Sequence):
  1223. nodes = [nodes]
  1224. self.watch_points = nodes
  1225. for n in nodes:
  1226. n.top_graph._watch_point.append(n)
  1227. def clear_watch_points(self):
  1228. for n in self.watch_points:
  1229. n.top_graph._watch_point = []
  1230. self.watch_points = []
  1231. self.watch_node_value = {}
  1232. def set_end_points(self, nodes):
  1233. if not isinstance(nodes, Sequence):
  1234. nodes = [nodes]
  1235. self.end_points = nodes
  1236. graphs = list(self.argdef_graph_map.values())
  1237. for n in nodes:
  1238. assert n.top_graph in graphs
  1239. n.top_graph._end_point.append(n)
  1240. def clear_end_points(self):
  1241. for n in self.end_points:
  1242. n.top_graph._end_point = []
  1243. self.end_points = []
  1244. @property
  1245. def graph(self) -> InternalGraph:
  1246. if self._is_top:
  1247. self._update_ref()
  1248. assert len(self.argdef_graph_map) == 1
  1249. return list(self.argdef_graph_map.values())[0]
  1250. def _update_ref(self, actual_node_map: Union[Dict] = None, top_graph=None):
  1251. for inp_def, graph in self.argdef_graph_map.items():
  1252. if top_graph is not None:
  1253. graph._top_graph = weakref.ref(top_graph)
  1254. for n in graph._inputs + graph.outputs:
  1255. n._top_graph = weakref.ref(graph)
  1256. graph._inputs[0]._owner = weakref.ref(self)
  1257. for i, n in enumerate(graph._inputs):
  1258. n.actual_node = []
  1259. if actual_node_map is not None and inp_def in actual_node_map.keys():
  1260. n.actual_node = list(list(zip(*(actual_node_map[inp_def])))[i])
  1261. node2obj = {}
  1262. next_actual_node_map = collections.defaultdict(
  1263. lambda: collections.defaultdict(list)
  1264. )
  1265. node2obj[graph._inputs[0]] = self
  1266. for expr in graph._exprs:
  1267. for n in expr.inputs + expr.outputs:
  1268. n._top_graph = weakref.ref(graph)
  1269. expr._top_graph = weakref.ref(graph)
  1270. if isinstance(expr, GetAttr) and isinstance(
  1271. expr.outputs[0], ModuleNode
  1272. ):
  1273. obj = getattr(node2obj[expr.inputs[0]], expr.name)
  1274. expr.outputs[0]._owner = weakref.ref(obj)
  1275. node2obj[expr.outputs[0]] = obj
  1276. if isinstance(expr, Constant) and isinstance(
  1277. expr.outputs[0], ModuleNode
  1278. ):
  1279. obj = expr.value
  1280. expr.outputs[0]._owner = weakref.ref(obj)
  1281. node2obj[expr.outputs[0]] = obj
  1282. if (
  1283. isinstance(expr, CallMethod)
  1284. and expr.method == "__call__"
  1285. and isinstance(expr.inputs[0], ModuleNode)
  1286. ):
  1287. obj = node2obj[expr.inputs[0]]
  1288. if expr.arg_def is not None:
  1289. next_actual_node_map[obj][expr.arg_def].append(expr.inputs)
  1290. for obj in node2obj.values():
  1291. if obj is self:
  1292. continue
  1293. mnode_map = None
  1294. if obj in next_actual_node_map.keys():
  1295. mnode_map = next_actual_node_map[obj]
  1296. if isinstance(obj, TracedModule):
  1297. obj._update_ref(mnode_map, graph)
  1298. def flatten(self):
  1299. """
  1300. Get a new module, which eliminates ``GetAttr`` and has no hierarchy.
  1301. :return: :class:`TracedModule`
  1302. """
  1303. new_module = copy.deepcopy(self)
  1304. assert active_module_tracer() is None
  1305. id2name = _init_id2name(new_module, "self")
  1306. set_active_module_tracer(module_tracer(lambda x: x, {}))
  1307. active_module_tracer().push_scope(new_module.graph)
  1308. def _flatten_subgraph(
  1309. graph: InternalGraph,
  1310. module: Module,
  1311. call=None,
  1312. prefix_name="",
  1313. module_name="",
  1314. ):
  1315. if isinstance(prefix_name, str) and prefix_name and prefix_name[-1] != "_":
  1316. prefix_name += "_"
  1317. if isinstance(module_name, str) and module_name:
  1318. module_name += "."
  1319. if graph is None or module.is_qat:
  1320. assert not isinstance(module, TracedModule) or module.is_qat
  1321. const = Constant(module, id2name[id(module)])
  1322. m_node = call.inputs[0]
  1323. if m_node.top_graph != active_module_tracer().current_scope():
  1324. m_node._name = (
  1325. active_module_tracer()
  1326. .current_scope()
  1327. ._create_unique_name(prefix_name)
  1328. )
  1329. m_node._orig_name = id2name[id(module)][5:]
  1330. const.outputs[0] = m_node
  1331. const.outputs[0].expr = const
  1332. return [const, call]
  1333. if call is not None:
  1334. graph = copy.deepcopy(graph)
  1335. exprs = []
  1336. node2obj = {}
  1337. node2obj[graph._inputs[0]] = module
  1338. if call:
  1339. node2obj[call.inputs[0]] = module
  1340. # replace inputs for submodule's exprx
  1341. if call:
  1342. repl_dict = dict(zip(graph._inputs, call.inputs))
  1343. for ind, out in enumerate(graph.outputs):
  1344. if isinstance(out.expr, Input):
  1345. assert out in repl_dict
  1346. call_out = call.outputs[ind]
  1347. for expr in call.outputs[ind].users:
  1348. for index, inp in enumerate(expr.inputs):
  1349. if inp is call_out:
  1350. expr.inputs[index] = repl_dict[out]
  1351. continue
  1352. repl_dict[out] = call.outputs[ind]
  1353. graph._replace_inputs_outputs(repl_dict, prefix_name, module_name)
  1354. for expr in graph._exprs:
  1355. if isinstance(expr, GetAttr):
  1356. # replace GetAttr with Constant
  1357. if isinstance(expr.outputs[0], TensorNode):
  1358. const = Constant(getattr(node2obj[expr.inputs[0]], expr.name))
  1359. const.outputs = expr.outputs
  1360. const.outputs[0].expr = const
  1361. exprs.append(const)
  1362. elif isinstance(expr.outputs[0], ModuleNode):
  1363. node2obj[expr.outputs[0]] = getattr(
  1364. node2obj[expr.inputs[0]], expr.name
  1365. )
  1366. elif isinstance(expr, CallMethod):
  1367. obj_node = expr.inputs[0]
  1368. if isinstance(obj_node, ModuleNode):
  1369. pre_expr = expr.inputs[0].expr
  1370. if isinstance(pre_expr, GetAttr):
  1371. (obj,) = pre_expr.interpret(node2obj[pre_expr.inputs[0]])
  1372. expr_graph = (
  1373. obj.argdef_graph_map[expr.arg_def]
  1374. if hasattr(obj, "argdef_graph_map")
  1375. else None
  1376. )
  1377. exprs.extend(
  1378. _flatten_subgraph(
  1379. expr_graph,
  1380. obj,
  1381. expr,
  1382. prefix_name + obj_node._name.lstrip("_"),
  1383. module_name + obj_node._orig_name,
  1384. )
  1385. )
  1386. else:
  1387. # module has been replaced.
  1388. assert isinstance(pre_expr, Constant)
  1389. exprs.append(expr)
  1390. else:
  1391. exprs.append(expr)
  1392. else:
  1393. exprs.append(expr)
  1394. if call is not None:
  1395. for i in call.inputs:
  1396. i.users.remove(call)
  1397. return exprs
  1398. new_module.graph._exprs = _flatten_subgraph(new_module.graph, new_module)
  1399. new_module.graph.compile()
  1400. set_active_module_tracer(None)
  1401. for _id, expr in enumerate(new_module.graph._exprs):
  1402. expr._id = _id
  1403. total_node_id = 0
  1404. for i in new_module.graph._inputs:
  1405. i._id = total_node_id
  1406. total_node_id += 1
  1407. for expr in new_module.graph._exprs:
  1408. for o in expr.outputs:
  1409. o._id = total_node_id
  1410. total_node_id += 1
  1411. return new_module
  1412. def __getstate__(self):
  1413. d = self.__dict__
  1414. for k in Module.__dict__:
  1415. d.pop(k, None)
  1416. return d
  1417. def cpp_apply_module_trace(opdef, *args):
  1418. return Apply.apply_module_trace_hook(opdef, *args)
  1419. def register_as_builtin(mod_cls: Type[Module]) -> None:
  1420. """
  1421. Registers class ``mod_cls`` (subclass of megengine.module.Module) as builtin module.
  1422. param mod_cls: the Module class which will be threated as builtin module in tracing
  1423. """
  1424. module_tracer.register_as_builtin(mod_cls)
  1425. def wrap(func: Callable):
  1426. """
  1427. Call this function to register func as a builtin function.
  1428. """
  1429. assert callable(func), "func must be a callable"
  1430. assert hasattr(func, "__code__")
  1431. fn_name = func.__code__.co_name
  1432. currentframe = inspect.currentframe()
  1433. assert currentframe is not None
  1434. f = currentframe.f_back
  1435. assert f is not None
  1436. assert (
  1437. f.f_code.co_name == "<module>"
  1438. ), "wrap must be called at the top level of a module"
  1439. Patcher._builtin_functions.append((f.f_globals, fn_name))
  1440. return func
  1441. def _register_all_builtin_module():
  1442. for sub_mod in [M, M.qat, M.quantized]:
  1443. for m in getmembers(sub_mod):
  1444. if (
  1445. isclass(m[1])
  1446. and issubclass(m[1], M.Module)
  1447. and m[1] is not M.Sequential
  1448. ):
  1449. module_tracer.register_as_builtin(m[1])
  1450. module_tracer.register_as_builtin(Observer)
  1451. module_tracer.register_as_builtin(MinMaxObserver)
  1452. module_tracer.register_as_builtin(SyncMinMaxObserver)
  1453. module_tracer.register_as_builtin(ExponentialMovingAverageObserver)
  1454. module_tracer.register_as_builtin(SyncExponentialMovingAverageObserver)
  1455. module_tracer.register_as_builtin(HistogramObserver)
  1456. module_tracer.register_as_builtin(PassiveObserver)
  1457. module_tracer.register_as_builtin(LSQ)
  1458. module_tracer.register_as_builtin(TQT)
  1459. module_tracer.register_as_builtin(FakeQuantize)
  1460. module_tracer.register_as_builtin(TM_FakeQuant)
  1461. def trace_module(mod: Module, *args: Tensor, **kwargs: Tensor) -> TracedModule:
  1462. """
  1463. Traces module ``mod`` and returns corresponding TracedModule.
  1464. param mod: the module will be converted to TracedModule
  1465. param input: the positional arguments passed to forward method of ``mod``
  1466. param kwargs: the keyword arguments passed to forward method of ``mod``
  1467. """
  1468. assert active_module_tracer() is None
  1469. assert isinstance(mod, Module)
  1470. try:
  1471. use_sym_shape = set_symbolic_shape(True)
  1472. set_module_tracing()
  1473. set_active_module_tracer(
  1474. module_tracer(_wrapped_function, _init_id2name(mod, "self"))
  1475. )
  1476. with active_module_tracer().patcher:
  1477. global_scope = InternalGraph(name="")
  1478. active_module_tracer().push_scope(global_scope)
  1479. builder = TracedModuleBuilder(mod, True)
  1480. name = mod._name if mod._name else mod.__class__.__name__
  1481. NodeMixin.wrap_safe(builder, Input.make(name, ModuleNode, orig_name="self"))
  1482. inputs, _ = tree_flatten((args, kwargs))
  1483. for _, i in enumerate(inputs):
  1484. # assert isinstance(i, Tensor), "not support "
  1485. if isinstance(i, RawTensor):
  1486. NodeMixin.wrap_safe(
  1487. i, Input.make("arg_{}".format(_), NodeMixin.get_wrapped_type(i))
  1488. )
  1489. builder(*args, **kwargs)
  1490. active_module_tracer().pop_scope()
  1491. return builder.build()
  1492. finally:
  1493. set_symbolic_shape(use_sym_shape)
  1494. set_active_module_tracer(None)
  1495. unset_module_tracing()

MegEngine 安装包中集成了使用 GPU 运行代码所需的 CUDA 环境,不用区分 CPU 和 GPU 版。 如果想要运行 GPU 程序,请确保机器本身配有 GPU 硬件设备并安装好驱动。 如果你想体验在云端 GPU 算力平台进行深度学习开发的感觉,欢迎访问 MegStudio 平台