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.

gen_param_defs.py 29 kB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831
  1. #!/usr/bin/env python3
  2. # -*- coding: utf-8 -*-
  3. import argparse
  4. import collections
  5. import textwrap
  6. import os
  7. import hashlib
  8. import struct
  9. class member_defs:
  10. """contain classes to define members of an opr param"""
  11. Dtype = collections.namedtuple('Dtype', ['cname', 'pycvt', 'pyfmt',
  12. 'cppjson', 'cname_attr'])
  13. Dtype.__new__.__defaults__ = ('', )
  14. uint32 = Dtype('uint32_t', 'int', 'I', 'NumberInt')
  15. uint64 = Dtype('uint64_t', 'int', 'Q', 'NumberInt',
  16. 'alignas(sizeof(uint64_t)) ')
  17. int32 = Dtype('int32_t', 'int', 'i', 'NumberInt')
  18. float32 = Dtype('float', 'float', 'f', 'Number')
  19. float64 = Dtype('double', 'float', 'd', 'Number')
  20. dtype = Dtype('DTypeEnum', '_as_dtype_num', 'I', 'Number')
  21. bool = Dtype('bool', 'bool', '?', 'Bool')
  22. class Base:
  23. pass
  24. class Doc:
  25. """wrap an identifier to associate document
  26. note: if the doc starts with a linebreak, it would not be reforamtted.
  27. """
  28. __slots__ = ['id', 'doc']
  29. def __init__(self, id_, doc):
  30. assert isinstance(id_, str) and isinstance(doc, str), (id_, doc)
  31. self.id = id_
  32. self.doc = doc
  33. @property
  34. def no_reformat(self):
  35. """whether reformat is disallowed for this doc string"""
  36. return self.doc.startswith('\n')
  37. @property
  38. def raw_lines(self):
  39. """the doc lines when ``no_format`` is true"""
  40. ret = self.doc.split('\n')
  41. assert not ret[0]
  42. return ret[1:]
  43. @classmethod
  44. def make(cls, v):
  45. """make doc object from str or doc"""
  46. if isinstance(v, cls):
  47. return v
  48. assert isinstance(v, str)
  49. return cls(v, '')
  50. def __str__(self):
  51. return self.id
  52. def __eq__(self, rhs):
  53. if isinstance(rhs, str):
  54. return self.id == rhs
  55. return (isinstance(rhs, Doc) and
  56. (self.id, self.doc) == (rhs.id, rhs.doc))
  57. class Enum(Base):
  58. """define an enum; the result would contain both an enum class def and its
  59. corresponding data field
  60. :param default: index of default member value
  61. :attr name_field: name of the data field of this enum in the param
  62. struct
  63. :attr member_alias: list of (member, alias) pairs
  64. """
  65. __slots__ = ['name', 'name_field', 'members', 'default',
  66. 'member_alias']
  67. all_enums = {}
  68. """(param_name, name) => enum"""
  69. def __init__(self, param_name, name, name_field, members, default,
  70. member_alias):
  71. name = member_defs.Doc.make(name)
  72. assert name.id[0].isupper()
  73. members = tuple(map(member_defs.Doc.make, members))
  74. if isinstance(default, str):
  75. if default not in name_field:
  76. raise ValueError(
  77. "Default value '{}' does not exist.".format(default))
  78. default = name_field.index(default)
  79. assert isinstance(default, int)
  80. self.name = name
  81. self.name_field = self.get_name_field(name.id, name_field)
  82. self.members = members
  83. self.default = default
  84. self.all_enums[(param_name, name.id)] = self
  85. assert isinstance(member_alias, list)
  86. self.member_alias = member_alias
  87. @classmethod
  88. def get_name_field(cls, name, name_field):
  89. if name_field is None:
  90. name_field = name[0].lower() + name[1:]
  91. assert isinstance(name_field, str)
  92. return name_field
  93. class Field(Base):
  94. """define a normal data field"""
  95. __slots__ = ['name', 'dtype', 'default']
  96. def __init__(self, name, dtype, default):
  97. assert isinstance(dtype, member_defs.Dtype)
  98. self.name = member_defs.Doc.make(name)
  99. self.dtype = dtype
  100. self.default = default
  101. class Const(Base):
  102. """define a const data field"""
  103. __slots__ = ['name', 'dtype', 'default']
  104. def __init__(self, name, dtype, default):
  105. assert isinstance(dtype, member_defs.Dtype)
  106. self.name = member_defs.Doc.make(name)
  107. self.dtype = dtype
  108. self.default = default
  109. class EnumAlias(Base):
  110. """alias of enum type from another param"""
  111. __slots__ = ['name', 'name_field', 'src_class', 'src_name', 'default']
  112. def __init__(self, name, name_field, src_class, src_name, default):
  113. self.name = name
  114. self.name_field = member_defs.Enum.get_name_field(name, name_field)
  115. self.src_class = src_class
  116. if src_name is None:
  117. src_name = name
  118. self.src_name = src_name
  119. self.default = default
  120. @property
  121. def src_enum(self):
  122. """source Enum class"""
  123. return member_defs.Enum.all_enums[(self.src_class, self.src_name)]
  124. def get_default(self):
  125. """get default index; fallback to src index if default is not
  126. set"""
  127. if self.default is None:
  128. return self.src_enum.default
  129. return self.default
  130. class ParamDef:
  131. """"""
  132. __all_tags = set()
  133. all_param_defs = []
  134. __slots__ = ['name', 'members', 'tag', 'is_legacy']
  135. def __init__(self, name, doc='', *, version=0, is_legacy=False):
  136. self.members = []
  137. self.all_param_defs.append(self)
  138. h = hashlib.sha256(name.encode('utf-8'))
  139. if version:
  140. h.update(struct.pack('<I', version))
  141. if is_legacy:
  142. name += 'V{}'.format(version)
  143. self.name = member_defs.Doc(name, doc)
  144. self.tag = int(h.hexdigest()[:8], 16)
  145. self.is_legacy = is_legacy
  146. if self.tag < 1024:
  147. self.tag += 1024
  148. assert self.tag not in self.__all_tags, (
  149. 'tag hash confliction: name={} tag={}'.format(name, self.tag))
  150. self.__all_tags.add(self.tag)
  151. def add_fields(self, dtype, *names_defaults):
  152. assert isinstance(dtype, str)
  153. dtype = getattr(member_defs, dtype)
  154. assert len(names_defaults) % 2 == 0
  155. for i, j in zip(names_defaults[::2], names_defaults[1::2]):
  156. self.members.append(member_defs.Field(i, dtype, j))
  157. return self
  158. def add_enum(self, name, *members, default=0, name_field=None,
  159. member_alias=[]):
  160. self.members.append(member_defs.Enum(
  161. self.name.id, name, name_field, members, default, member_alias))
  162. return self
  163. def add_enum_alias(self, name, src_class, src_name=None, name_field=None,
  164. default=None):
  165. self.members.append(member_defs.EnumAlias(
  166. name, name_field, src_class, src_name, default))
  167. return self
  168. def add_const(self, dtype, *names_defaults):
  169. assert isinstance(dtype, str)
  170. dtype = getattr(member_defs, dtype)
  171. assert len(names_defaults) % 2 == 0
  172. for i, j in zip(names_defaults[::2], names_defaults[1::2]):
  173. self.members.append(member_defs.Const(i, dtype, j))
  174. return self
  175. class WriterBase:
  176. """base class for output file writer"""
  177. _fout = None
  178. _input_hash = None
  179. def __call__(self, fout):
  180. self._fout = fout
  181. def set_input_hash(self, h):
  182. self._input_hash = h
  183. return self
  184. def _get_header(self):
  185. return 'generated by {} for {}'.format(
  186. os.path.basename(__file__),
  187. self._input_hash
  188. )
  189. def _process(self, defs):
  190. dispatch = {
  191. member_defs.Enum: self._on_member_enum,
  192. member_defs.EnumAlias: self._on_member_enum_alias,
  193. member_defs.Field: self._on_member_field,
  194. member_defs.Const: self._on_const_field
  195. }
  196. for i in defs:
  197. assert isinstance(i, ParamDef)
  198. self._on_param_begin(i)
  199. for j in i.members:
  200. dispatch[type(j)](j)
  201. self._on_param_end(i)
  202. def _on_param_begin(self, p):
  203. """:type p: :class:`.ParamDef`"""
  204. def _on_param_end(self, p):
  205. """:type p: :class:`.ParamDef`"""
  206. def _on_member_enum(self, e):
  207. """:type p: :class:`.Enum`"""
  208. def _on_member_enum_alias(self, e):
  209. """:type p: :class:`.EnumAlias`"""
  210. def _on_member_field(self, f):
  211. """:type p: :class:`.Field`"""
  212. def _on_const_field(self, f):
  213. """:type p: :class:`.Const`"""
  214. class IndentWriterBase(WriterBase):
  215. _cur_indent = ''
  216. def _indent(self):
  217. self._cur_indent += ' ' * 4
  218. def _unindent(self):
  219. self._cur_indent = self._cur_indent[:-4]
  220. def _write(self, content, *fmt, indent=0):
  221. if indent < 0:
  222. self._unindent()
  223. self._fout.write(self._cur_indent)
  224. if fmt:
  225. content = content % fmt
  226. self._fout.write(content)
  227. self._fout.write('\n')
  228. if indent > 0:
  229. self._indent()
  230. class PyWriter(IndentWriterBase):
  231. FieldDef = collections.namedtuple(
  232. 'FieldDef', ['name', 'cvt', 'fmt', 'default', 'type', 'doc'])
  233. # see _on_param_end() for the use of those fields
  234. _cur_param_name = None
  235. _cur_fields = None
  236. _cur_struct_fmt = None
  237. _enum_member2num = None
  238. def __init__(self, for_imperative=False):
  239. self._imperative = for_imperative
  240. def __call__(self, fout, defs):
  241. super().__call__(fout)
  242. self._enum_member2num = []
  243. self._write('# %s', self._get_header())
  244. self._write('import struct')
  245. self._write('from . import enum36 as enum')
  246. self._write(
  247. 'class _ParamDefBase:\n'
  248. ' def serialize(self):\n'
  249. ' tag = struct.pack("I", type(self).TAG)\n'
  250. ' pdata = [getattr(self, i) for i in self.__slots__]\n'
  251. ' for idx, v in enumerate(pdata):\n'
  252. ' if isinstance(v, _EnumBase):\n'
  253. ' pdata[idx] = _enum_member2num[id(v)]\n'
  254. ' return tag + self._packer.pack(*pdata)\n'
  255. '\n'
  256. )
  257. self._write(
  258. 'class _EnumBase(enum.Enum):\n'
  259. ' @classmethod\n'
  260. ' def __normalize(cls, val):\n'
  261. ' if isinstance(val, str):\n'
  262. ' if not hasattr(cls, "__member_upper_dict__"):\n'
  263. ' cls.__member_upper_dict__ = {k.upper(): v\n'
  264. ' for k, v in cls.__members__.items()}\n'
  265. ' val = cls.__member_upper_dict__.get(val.upper(),val)\n'
  266. ' return val\n'
  267. ' @classmethod\n'
  268. ' def convert(cls, val):\n'
  269. ' val = cls.__normalize(val)\n'
  270. ' if isinstance(val, cls):\n'
  271. ' return val\n'
  272. ' return cls(val)\n'
  273. ' @classmethod\n'
  274. ' def _missing_(cls, value):\n'
  275. ' vnorm = cls.__normalize(value)\n'
  276. ' if vnorm is not value:\n'
  277. ' return cls(vnorm)\n'
  278. ' return super()._missing_(value)\n'
  279. '\n'
  280. )
  281. if not self._imperative:
  282. self._write(
  283. 'def _as_dtype_num(dtype):\n'
  284. ' import megbrain.mgb as m\n'
  285. ' return m._get_dtype_num(dtype)\n'
  286. '\n'
  287. )
  288. self._write(
  289. 'def _as_serialized_dtype(dtype):\n'
  290. ' import megbrain.mgb as m\n'
  291. ' return m._get_serialized_dtype(dtype)\n'
  292. '\n'
  293. )
  294. else:
  295. self._write(
  296. 'def _as_dtype_num(dtype):\n'
  297. ' import megengine.core._imperative_rt.utils as m\n'
  298. ' return m._get_dtype_num(dtype)\n'
  299. '\n'
  300. )
  301. self._write(
  302. 'def _as_serialized_dtype(dtype):\n'
  303. ' import megengine.core._imperative_rt.utils as m\n'
  304. ' return m._get_serialized_dtype(dtype)\n'
  305. '\n'
  306. )
  307. self._process(defs)
  308. self._write(
  309. '''
  310. class SerializedDType(_ParamDefBase):
  311. TAG = FakeSerializedDType.TAG
  312. __slots__ = ['dtype']
  313. class IdentityPacker:
  314. def pack(self, *args):
  315. assert all([isinstance(x, bytes) for x in args])
  316. return b''.join(args)
  317. _packer = IdentityPacker()
  318. def __init__(self, dtype):
  319. """
  320. :type dtype: :class:`np.dtype` compatible
  321. """
  322. self.dtype = _as_serialized_dtype(dtype)
  323. '''
  324. )
  325. self._write('_enum_member2num = {\n %s}',
  326. ',\n '.join(self._enum_member2num))
  327. def _write_doc(self, doc):
  328. assert isinstance(doc, member_defs.Doc)
  329. if not doc.doc:
  330. return
  331. if doc.no_reformat:
  332. self._write('"""')
  333. for i in doc.raw_lines:
  334. self._write(i)
  335. self._write('"""')
  336. return
  337. doc = doc.doc.replace('\n', ' ')
  338. textwidth = 80 - len(self._cur_indent)
  339. self._write('"""')
  340. for i in textwrap.wrap(doc, textwidth):
  341. self._write(i)
  342. self._write('"""')
  343. def _on_param_begin(self, p):
  344. self._cur_param_name = str(p.name)
  345. self._cur_fields = []
  346. self._cur_enum_names = []
  347. self._write('class %s(_ParamDefBase):', p.name, indent=1)
  348. self._write_doc(p.name)
  349. self._write('TAG = %d', p.tag)
  350. def _on_param_end(self, p):
  351. # gen slots and packer
  352. self._write('__slots__ = [%s]', ', '.join(
  353. map('"{.name}"'.format, self._cur_fields)))
  354. struct_fmt = ''.join(i.fmt for i in self._cur_fields)
  355. if not struct_fmt:
  356. struct_fmt = 'x'
  357. else:
  358. # add padding at end
  359. max_t = max(struct_fmt, key=struct.calcsize)
  360. struct_fmt += '0{}'.format(max_t)
  361. self._write('_packer = struct.Struct("%s")', struct_fmt)
  362. # gen __init__ signature
  363. self._write('def __init__(%s):',
  364. ', '.join(['self'] +
  365. list('{}={}'.format(i.name, i.default)
  366. for i in self._cur_fields)),
  367. indent=1)
  368. # gen __init__ doc
  369. self._write('"""')
  370. for i in self._cur_fields:
  371. self._write(':type {}: :class:`.{}`'.format(i.name, i.type))
  372. if i.doc:
  373. self._write(':param {}: {}'.format(i.name, i.doc))
  374. self._write('"""')
  375. # gen cvt in __init__
  376. for i in self._cur_fields:
  377. self._write('self.%s = %s', i.name, i.cvt)
  378. self._unindent()
  379. self._unindent()
  380. self._write('')
  381. def _on_member_enum(self, e):
  382. qualname = '{}.{}'.format(self._cur_param_name, e.name)
  383. self._write('class %s(_EnumBase):', e.name, indent=1)
  384. self._write_doc(e.name)
  385. for idx, emem in enumerate(e.members):
  386. self._write('%s = "%s"', emem, emem)
  387. self._write_doc(emem)
  388. self._enum_member2num.append('id({}.{}):{}'.format(
  389. qualname, emem, idx))
  390. for emem, emem_alis in e.member_alias:
  391. self._write('%s = %s', emem_alis, emem)
  392. self._unindent()
  393. self._write('')
  394. self._cur_fields.append(self.FieldDef(
  395. name=e.name_field,
  396. cvt='{}.convert({})'.format(qualname, e.name_field),
  397. fmt='I',
  398. default="'{}'".format(e.members[e.default]),
  399. type=qualname,
  400. doc=None))
  401. def _on_member_enum_alias(self, e):
  402. self._write('%s = %s.%s', e.name, e.src_class, e.src_name)
  403. s = e.src_enum
  404. qualname = '{}.{}'.format(e.src_class, e.src_name)
  405. self._cur_fields.append(self.FieldDef(
  406. name=e.name_field,
  407. cvt='{}.convert({})'.format(qualname, e.name_field),
  408. fmt='I',
  409. default="'{}'".format(s.members[e.get_default()]),
  410. type=qualname,
  411. doc=None))
  412. def _get_py_default(self, cppdefault):
  413. if not isinstance(cppdefault, str):
  414. return cppdefault
  415. d = cppdefault
  416. if d.endswith('f'): # 1.f
  417. return d[:-1]
  418. if d.endswith('ull'):
  419. return d[:-3]
  420. if d == 'false':
  421. return 'False'
  422. if d == 'true':
  423. return 'True'
  424. if d.startswith('DTypeEnum::'):
  425. return '"{}"'.format(d.split(':')[2].lower())
  426. return d
  427. def _on_member_field(self, f):
  428. d = self._get_py_default(f.default)
  429. self._cur_fields.append(self.FieldDef(
  430. name=f.name,
  431. cvt='{}({})'.format(f.dtype.pycvt, f.name),
  432. fmt=f.dtype.pyfmt,
  433. default=d,
  434. type=f.dtype.pycvt,
  435. doc=f.name.doc
  436. ))
  437. def _on_const_field(self, f):
  438. d = self._get_py_default(f.default)
  439. self._write_doc(f.name)
  440. self._write('%s = %s', f.name, d)
  441. class CPPWriter(IndentWriterBase):
  442. _param_namespace = 'param'
  443. _ctor_args = None
  444. """list of (text in func param, var name); func param name must be var name
  445. appended by an underscore"""
  446. _non_static_members = None
  447. def __call__(self, fout, defs):
  448. super().__call__(fout)
  449. self._write('// %s', self._get_header())
  450. self._write('#pragma once')
  451. self._write('#include "megdnn/dtype.h"')
  452. self._write('#include <stdint.h>')
  453. if self._param_namespace == 'param':
  454. self._write('#include <string.h>')
  455. self._write('namespace megdnn {')
  456. self._write('namespace %s {', self._param_namespace)
  457. self._process(defs)
  458. self._write('} // namespace megdnn')
  459. self._write('} // namespace %s', self._param_namespace)
  460. self._write('// vim: syntax=cpp.doxygen')
  461. def _write_doc(self, doc):
  462. assert isinstance(doc, member_defs.Doc)
  463. if not doc.doc:
  464. return
  465. if doc.no_reformat:
  466. self._write('/*')
  467. for i in doc.raw_lines:
  468. self._write('* ' + i)
  469. self._write('*/')
  470. return
  471. doc = doc.doc.replace('\n', ' ')
  472. textwidth = 80 - len(self._cur_indent) - 4
  473. if len(doc) <= textwidth:
  474. self._write('//! ' + doc)
  475. return
  476. self._write('/*!')
  477. for i in textwrap.wrap(doc, textwidth):
  478. self._write(' * ' + i)
  479. self._write(' */')
  480. def _on_param_begin(self, p):
  481. self._write_doc(p.name)
  482. self._write('struct %s {', p.name, indent=1)
  483. self._write('static MEGDNN_CONSTEXPR uint32_t TAG = %du;', p.tag)
  484. self._ctor_args = []
  485. self._non_static_members = []
  486. def _add_ctor_args(self, typename, default, varname):
  487. self._ctor_args.append((
  488. '{} {}_={}'.format(typename, varname, default),
  489. varname))
  490. def _on_param_end(self, p):
  491. '''
  492. MegDNN param structures are not packed and we need to initialize the structure
  493. paddings to zero or it would break MegBrain hash system. We do memset(0) in default
  494. ctor and use a trick, wrapping non-static members in a anonymous union which would
  495. copy the object representation in its default copy/move ctor, for copy/move ctor.
  496. > The implicitly-defined copy/move constructor for a non-union class X performs
  497. > a memberwise copy/move of its bases and members. [class.copy.ctor 14]
  498. > The implicitly-defined copy/move constructor for a union X copies the object
  499. > representation (6.9) of X. [class.copy.ctor 15]
  500. '''
  501. if self._non_static_members:
  502. self._write('union { struct {')
  503. for i in self._non_static_members:
  504. if isinstance(i, member_defs.Field):
  505. self._write_doc(i.name)
  506. self._write('%s%s %s;', i.dtype.cname_attr, i.dtype.cname, i.name)
  507. else:
  508. assert isinstance(i, (member_defs.Enum, member_defs.EnumAlias))
  509. self._write('%s %s;', i.name, i.name_field)
  510. self._write('}; };')
  511. if self._ctor_args:
  512. pdefs, varnames = zip(*self._ctor_args)
  513. self._write('%s(%s) {', p.name, ', '.join(pdefs), indent=1)
  514. self._write('memset(this, 0, sizeof(*this));')
  515. for var in varnames:
  516. self._write('this->%s = %s_;', var, var)
  517. self._write('}', indent=-1)
  518. self._write('};\n', indent=-1)
  519. def _on_member_enum(self, e):
  520. self._write_doc(e.name)
  521. self._write('enum class %s: uint32_t {', e.name, indent=1)
  522. for idx, i in enumerate(e.members):
  523. self._write_doc(i)
  524. v = '{} = {}'.format(i, idx)
  525. if i is not e.members[-1] or e.member_alias:
  526. v += ','
  527. self._write(v)
  528. for mem, alias in e.member_alias:
  529. self._write('%s = %s,', alias, mem)
  530. self._write('};', indent=-1)
  531. self._non_static_members.append(e)
  532. self._write('static MEGDNN_CONSTEXPR uint32_t %s_NR_MEMBER = %d;',
  533. str(e.name).upper(), len(e.members))
  534. self._add_ctor_args(e.name,
  535. '{}::{}'.format(e.name, e.members[e.default]),
  536. e.name_field)
  537. def _on_member_enum_alias(self, e):
  538. s = e.src_enum
  539. self._write('using %s = %s::%s;', e.name, e.src_class, e.src_name)
  540. self._non_static_members.append(e)
  541. self._write('static MEGDNN_CONSTEXPR uint32_t %s_NR_MEMBER = %d;',
  542. str(e.name).upper(), len(s.members))
  543. self._add_ctor_args(e.name,
  544. '{}::{}'.format(e.name,
  545. s.members[e.get_default()]),
  546. e.name_field)
  547. def _on_member_field(self, f):
  548. self._non_static_members.append(f)
  549. self._add_ctor_args(f.dtype.cname, f.default, f.name)
  550. def _on_const_field(self, f):
  551. self._write_doc(f.name)
  552. if 'int' in f.dtype.cname:
  553. self._write('static constexpr %s%s %s = %s;', f.dtype.cname_attr, f.dtype.cname, f.name, f.default)
  554. else:
  555. self._write('static const %s%s %s = %s;', f.dtype.cname_attr, f.dtype.cname, f.name, f.default)
  556. class CPPEnumValueWriter(CPPWriter):
  557. _param_namespace = 'param_enumv'
  558. def _on_member_enum(self, e):
  559. self._write_doc(e.name)
  560. self._write('struct %s {', e.name, indent=1)
  561. for idx, val in enumerate(e.members):
  562. self._write_doc(val)
  563. self._write('static const uint32_t %s = %d;', val, idx)
  564. for mem, alias in e.member_alias:
  565. self._write('static const uint32_t %s = %s;', alias, mem)
  566. self._write('};', indent=-1)
  567. def _on_member_enum_alias(self, e):
  568. s = e.src_enum
  569. self._write('typedef %s::%s %s;', e.src_class, e.src_name, e.name)
  570. def _on_member_field(self, f):
  571. pass
  572. def _on_const_field(self, f):
  573. pass
  574. class CPPEnumItemWriter(WriterBase):
  575. _class_name = None
  576. _enum_name = None
  577. _enable = False
  578. def __init__(self, enum_def):
  579. self._class_name, self._enum_name = enum_def.split(':')
  580. def __call__(self, fout, defs):
  581. super().__call__(fout)
  582. self._process(defs)
  583. def _on_param_begin(self, p):
  584. self._enable = p.name == self._class_name
  585. def _on_member_enum(self, e):
  586. if self._enable and e.name == self._enum_name:
  587. for i in e.members:
  588. self._fout.write('{}\n'.format(i))
  589. class CPPParamJsonFuncWriter(IndentWriterBase):
  590. _param_namespace = 'param'
  591. _param_name = None
  592. _items = None
  593. def _write_json_item(self, json_cls, field):
  594. cls2ctype = {
  595. 'NumberInt': 'int64_t',
  596. 'Number': 'double',
  597. 'Bool': 'bool',
  598. }
  599. self._items.append('{"%s", json::%s::make(static_cast<%s>(p.%s))},' % (
  600. field, json_cls, cls2ctype[json_cls], field))
  601. def __call__(self, fout, defs):
  602. super().__call__(fout)
  603. self._write('// %s', self._get_header())
  604. self._write('// this file can only be included in '
  605. 'megbrain/src/plugin/impl/opr_footprint.cpp\n'
  606. '// please do not include it directly')
  607. self._write('#include "megdnn/opr_param_defs.h"')
  608. self._write('#pragma once')
  609. self._write('using namespace megdnn;')
  610. self._write('namespace mgb {')
  611. self._write('namespace opr {')
  612. self._write('template<class OprParam>')
  613. self._write('std::shared_ptr<mgb::json::Value> opr_param_to_json(const OprParam &param);')
  614. self._process(defs)
  615. self._write('} // namespace opr')
  616. self._write('} // namespace mgb')
  617. self._write('\n// vim: syntax=cpp.doxygen')
  618. def _on_param_begin(self, p):
  619. self._write('template<>', indent=0)
  620. self._write(
  621. 'std::shared_ptr<mgb::json::Value> opr_param_to_json(const param::%s &p) {',
  622. p.name, indent=1)
  623. self._param_name = 'param::{}'.format(p.name)
  624. self._items = []
  625. def _on_param_end(self, p):
  626. self._write('return json::Object::make({', indent=1)
  627. for i in self._items:
  628. self._write(i, indent=0)
  629. self._write('});', indent=-1)
  630. self._write('}', indent=-1)
  631. def _on_member_enum(self, e):
  632. self._write('auto %s2str = [](const %s::%s arg) -> std::string {',
  633. e.name, self._param_name, e.name, indent=1)
  634. self._write('switch (arg) {', indent=1)
  635. enum2str = []
  636. if isinstance(e, member_defs.EnumAlias):
  637. members = e.src_enum.members
  638. else:
  639. members = e.members
  640. for idx, i in enumerate(members):
  641. self._write('case %s::%s::%s: return "%s";',
  642. self._param_name, e.name, i, i, indent=0)
  643. self._write('default: mgb_throw(MegBrainError, "Invalid %s::%s:%%d", static_cast<int>(arg));',
  644. self._param_name, e.name, indent=0)
  645. self._write('}', indent=-1)
  646. self._write('};', indent=-1)
  647. self._items.append('{"%s", json::String::make(%s2str(p.%s))},' % (
  648. e.name_field, e.name, e.name_field))
  649. def _on_member_enum_alias(self, e):
  650. self._on_member_enum(e)
  651. def _on_member_field(self, f):
  652. self._write_json_item(f.dtype.cppjson, f.name)
  653. def _on_const_field(self, f):
  654. pass
  655. def main():
  656. parser = argparse.ArgumentParser(
  657. 'generate opr param defs from description file')
  658. parser.add_argument('--enumv', action='store_true',
  659. help='generate c++03 compatible code which only '
  660. 'contains enum values')
  661. parser.add_argument('-t', '--type', choices=['c++', 'py'], default='c++',
  662. help='output type')
  663. parser.add_argument('--write-enum-items',
  664. help='write enum item names to output file; argument '
  665. 'should be given in the CLASS:ENUM format')
  666. parser.add_argument('--write-cppjson',
  667. help='generate megbrain json serialization implemention'
  668. 'cpp file')
  669. parser.add_argument('input')
  670. parser.add_argument('output')
  671. parser.add_argument('--imperative', action='store_true',
  672. help='generate files for imperatvie ')
  673. args = parser.parse_args()
  674. for_imperative = args.imperative
  675. with open(args.input) as fin:
  676. inputs = fin.read()
  677. exec(inputs, {'pdef': ParamDef, 'Doc': member_defs.Doc})
  678. input_hash = hashlib.sha256()
  679. input_hash.update(inputs.encode(encoding='UTF-8'))
  680. input_hash = input_hash.hexdigest()
  681. if args.type == 'py':
  682. writer = PyWriter(for_imperative=for_imperative)
  683. else:
  684. assert args.type == 'c++'
  685. if args.enumv:
  686. writer = CPPEnumValueWriter()
  687. elif args.write_enum_items:
  688. writer = CPPEnumItemWriter(args.write_enum_items)
  689. else:
  690. writer = CPPWriter()
  691. with open(args.output, 'w') as fout:
  692. writer.set_input_hash(input_hash)(fout, ParamDef.all_param_defs)
  693. if args.write_cppjson:
  694. writer = CPPParamJsonFuncWriter()
  695. with open(args.write_cppjson, 'w') as fout:
  696. writer.set_input_hash(input_hash)(fout, ParamDef.all_param_defs)
  697. if __name__ == '__main__':
  698. main()

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