# Licensed to the Apache Software Foundation (ASF) under one # or more contributor license agreements. See the NOTICE file # distributed with this work for additional information # regarding copyright ownership. The ASF licenses this file # to you under the Apache License, Version 2.0 (the # "License"); you may not use this file except in compliance # with the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, # software distributed under the License is distributed on an # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. """TVM Attribute module, which is mainly used for defining attributes of operators.""" import tvm_ffi import tvm_ffi._ffi_api as _tvm_ffi_api from tvm.runtime import Object from . import _ffi_api @tvm_ffi.register_object("ir.Attrs") class Attrs(Object): """Attribute node, which is mainly use for defining attributes of operators. Used by function registered in python side, such as compute, schedule and alter_layout. Attrs is passed as the first argument to these functions. """ def get_int_tuple(self, key): """Get a python int tuple of a key Parameters ---------- key: str Returns ------- value: Tuple of int """ return tuple(x if isinstance(x, int) else x.value for x in getattr(self, key)) def get_int(self, key): """Get a python int value of a key Parameters ---------- key: str Returns ------- value: int """ return getattr(self, key) def get_str(self, key): """Get a python int value of a key Parameters ---------- key: str Returns ------- value: int """ return getattr(self, key) def __getitem__(self, item): return getattr(self, item) @tvm_ffi.register_object("ir.DictAttrs") class DictAttrs(Attrs): """Dictionary attributes.""" @property def __dict__(self): """Return the underlying key-value map as a Python dict. Defined explicitly so that tvm_ffi's _add_class_attrs skips registering the C++ reflection field named '__dict__' (Python forbids adding a class attribute named '__dict__' via setattr on extension-type subclasses). """ return dict(self._dict()) def _dict(self): """Get internal dict""" return _ffi_api.DictAttrsGetDict(self) def keys(self): """Get list of names in the attribute. Returns ------- keys : list of str List of keys """ return [k for k, _ in self.items()] def __getitem__(self, k): return self._dict().__getitem__(k) def get(self, key, default=None): """Get an element with a default value.""" return self._dict().get(key, default) def __contains__(self, k): return self._dict().__contains__(k) def __getattr__(self, name): try: return self._dict().__getitem__(name) except KeyError: raise AttributeError(f"DictAttrs has no attribute {name}") def items(self): """Get items from the map.""" return self._dict().items() def __len__(self): return self._dict().__len__() def make_node(type_key, **kwargs): """Make a new IR node by its type key and fields Parameters ---------- type_key : str The type key of the node. **kwargs : dict The fields of the node. Returns ------- node : Node The corresponding IR Node Note ---- If the created node is instance of AttrsNode, then the creator function will also run bound checks and default value setup as supported by Attrs. Example ------- The following code constructs a IntImm object .. code-block:: python x = tvm.ir.make_node("ir.IntImm", dtype="int32", value=10, span=None) assert isinstance(x, tvm.tirx.IntImm) assert x.value == 10 """ if type_key == "ir.DictAttrs": # DictAttrs stores kwargs as a key-value dict, not as named fields. # MakeObjectFromPackedArgs would look for a field named "__dict__". return _tvm_ffi_api.MakeObjectFromPackedArgs("ir.DictAttrs", "__dict__", kwargs) args = [type_key] for k, v in kwargs.items(): args += [k, v] return _tvm_ffi_api.MakeObjectFromPackedArgs(*args)