Tianqi Chen
275114b327
## Summary - Make `PrimExpr` a typed C++ view over `Expr` values whose `ExprNode::ty` is `PrimType`, instead of using a separate runtime node class as the proof of primitive-ness. - Use the shared `ir::Call` node for Relax, TIRX, and primitive-valued calls, while keeping primitive-only APIs explicit at their semantic boundaries. - Keep Python on the general `Expr` surface for primitive-typed values so `isinstance` behavior does not imply a nominal primitive-expression subclass. ## Design Rationale The main advantage of this change is that common expression nodes such as `Call` can be unified without specializing each one to `PrimType`. A single `ir::Call` can represent a Relax tensor call, a Relax scalar call, or a primitive-valued intrinsic call; the result type stored in `ExprNode::ty` determines whether that particular value can be viewed as `PrimExpr`. This keeps the IR node hierarchy focused on expression structure rather than result-type categories. Nodes that are intrinsically primitive, such as integer and floating-point literals or TIRX primitive operators, still have strongly typed C++ APIs and data structures. General nodes whose result type may vary, such as `Call`, remain general `Expr` nodes and are narrowed to `PrimExpr` only where primitive-only semantics are required. The PR also keeps the compatibility surface practical: C++ primitive-only APIs continue to accept `PrimExpr`, Python exposes a compatibility predicate for checking the primitive typed category, and visitors/printers use one natural `Call` path rather than duplicating Relax and primitive call handling. Missing expression types are represented explicitly with `Type::Missing()` so constructors can leave type inference to later analysis without relying on nullable `Type` values.
102 lines
3.2 KiB
Python
102 lines
3.2 KiB
Python
# 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.
|
|
# pylint: disable=no-member, super-init-not-called
|
|
|
|
"""Definition of execution scope."""
|
|
|
|
from tvm_ffi import register_object
|
|
|
|
from tvm.runtime import Object
|
|
|
|
from . import _ffi_api
|
|
from .expr import Expr, Var
|
|
|
|
|
|
@register_object("tirx.ScopeIdDef")
|
|
class ScopeIdDef(Object):
|
|
"""Definition of scope identifiers with their extents and parent-child relationships.
|
|
|
|
The constructor accepts ``parent`` and ``cur`` as scope-name strings; they
|
|
are converted by the FFI into the closed ``ScopeBinding`` enum and stored
|
|
on the ``scope`` field (an ``int`` value of that enum).
|
|
|
|
``extents=None`` defers the extent: the value is inferred from sibling
|
|
ScopeIdDef relationships at LowerTIRx entry via the verifier's closure.
|
|
Deferred form requires ``def_ids`` to contain exactly one Var.
|
|
"""
|
|
|
|
def_ids: list[Var]
|
|
extents: list[Expr] | None
|
|
scope: int
|
|
|
|
def __init__(
|
|
self,
|
|
def_ids: list[Var],
|
|
extents: list[Expr] | None,
|
|
parent: str,
|
|
cur: str,
|
|
preferred_extents: list[Expr] | None = None,
|
|
):
|
|
self.__init_handle_by_constructor__(
|
|
_ffi_api.ScopeIdDef, def_ids, extents, parent, cur, preferred_extents
|
|
)
|
|
|
|
|
|
_SCOPE_KIND_TO_NAME = {
|
|
2: "cluster",
|
|
3: "cta",
|
|
4: "warpgroup",
|
|
5: "warp",
|
|
6: "thread",
|
|
}
|
|
|
|
|
|
# Mirror of ``enum class ScopeBinding`` in tvm/tirx/exec_scope.h. Maps the
|
|
# ``int`` value of ``ScopeIdDef.scope`` back to the ``(parent, cur)`` pair
|
|
# that ``ScopeIdDef.__init__`` accepts — needed when Python code wants to
|
|
# rebuild a ``ScopeIdDef`` from an existing one (e.g. a StmtMutator
|
|
# walking and rewriting extents).
|
|
_SCOPE_BINDING_TO_PARENT_CUR = {
|
|
0: ("kernel", "cluster"),
|
|
1: ("kernel", "cta"),
|
|
2: ("cluster", "cta"),
|
|
3: ("cta", "warpgroup"),
|
|
4: ("cta", "warp"),
|
|
5: ("warpgroup", "warp"),
|
|
6: ("warp", "thread"),
|
|
7: ("cta", "thread"),
|
|
8: ("warpgroup", "thread"),
|
|
9: ("cluster", "cta_pair"),
|
|
}
|
|
|
|
|
|
@register_object("tirx.ExecScope")
|
|
class ExecScope(Object):
|
|
"""An execution scope, identified by one of {cluster, cta, warpgroup, warp,
|
|
thread}. The ctor FATALs on any other name."""
|
|
|
|
kind: int
|
|
scope_id_def: list[ScopeIdDef]
|
|
|
|
def __init__(self, name: str):
|
|
self.__init_handle_by_constructor__(_ffi_api.ExecScope, name)
|
|
|
|
@property
|
|
def name(self) -> str:
|
|
"""Human-readable name of this scope (derived from ``kind``)."""
|
|
return _SCOPE_KIND_TO_NAME[self.kind]
|