torch-mlir/include/npcomp/Dialect/Numpy/IR/NumpyDialect.td

119 lines
4.5 KiB
TableGen
Raw Normal View History

2020-04-27 08:20:58 +08:00
//===- NumpyDialect.td - Core numpy dialect ----------------*- tablegen -*-===//
//
// This file is licensed under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
#ifndef NPCOMP_DIALECT_NUMPY_IR_NUMPY_DIALECT
#define NPCOMP_DIALECT_NUMPY_IR_NUMPY_DIALECT
2020-04-27 08:20:58 +08:00
include "mlir/IR/OpBase.td"
include "npcomp/Dialect/Basicpy/IR/BasicpyDialect.td"
2020-04-27 08:20:58 +08:00
2020-04-30 08:49:56 +08:00
//===----------------------------------------------------------------------===//
// Dialect definition
//===----------------------------------------------------------------------===//
2020-04-27 08:20:58 +08:00
def Numpy_Dialect : Dialect {
let name = "numpy";
let summary = "Core numpy dialect";
let description = [{
Dialect of types and core numpy ops and abstractions.
}];
let cppNamespace = "::mlir::NPCOMP::Numpy";
2020-04-27 08:20:58 +08:00
}
2020-04-30 08:49:56 +08:00
//===----------------------------------------------------------------------===//
// Op templates
//===----------------------------------------------------------------------===//
2020-04-27 08:20:58 +08:00
class Numpy_Op<string mnemonic, list<OpTrait> traits = []> :
Op<Numpy_Dialect, mnemonic, traits> {
let parser = [{ return parse$cppClass(parser, &result); }];
2020-06-29 08:37:20 +08:00
let printer = [{ return print$cppClass(p, *this); }];
}
2020-04-27 08:20:58 +08:00
2020-04-30 09:20:42 +08:00
//===----------------------------------------------------------------------===//
// Dialect types
//===----------------------------------------------------------------------===//
def Numpy_AnyDtype : DialectType<Numpy_Dialect,
CPred<"$_self.isa<::mlir::NPCOMP::Numpy::AnyDtypeType>()">, "any dtype">,
BuildableType<"$_builder.getType<::mlir::NPCOMP::Numpy::AnyDtypeType>()"> {
2020-04-30 09:20:42 +08:00
let typeDescription = [{
Placeholder for an unknown dtype in a tensor.
}];
}
2020-06-29 08:37:20 +08:00
def Numpy_NdArrayType : DialectType<Numpy_Dialect,
CPred<"$_self.isa<::mlir::NPCOMP::Numpy::NdArrayType>()">, "ndarray type">,
BuildableType<"$_builder.getType<::mlir::NPCOMP::Numpy::NdArrayType>()"> {
let typeDescription = [{
NdArrayType: Models a numpy.ndarray and compatible types.
Unlike lower level representations, this type solely exists to represent
top-level semantics and source-dialect transformations. As such, it
is not a general modeling like `tensor` or `memref`, instead being just
enough to infer proper lowerings to those types.
Like its numpy counterparts, NdArrayType represents a mutable array of
some value type (dtype), with a shape, strides, and various controls
around contiguity. Most of that is not modeled in this type, which focuses
on a representation sufficient to infer high level types and aliasing
based on program flow.
Note that most operations in numpy can be legally defined similar to the
following:
%0 = ... -> !numpy.ndarray<...>
%1 = numpy.copy_to_tensor %0 -> tensor<...>
%2 = numpy.some_operation %1
%4 = numpy.copy_from_tensor -> !numpy.ndarray<...>
(in other words, the operation does not alias any of its operands to its
results)
When this is the case, the operation will *only* be defined for tensors,
as staying in the value domain makes sense for as many operations as
can be reasonably represented as such. It is left to subsequent parts of
the compiler to transform the program in such a way as to elide the copies
that such sequences encode.
Only ops that mutate or alias their operands should accept and/or produce
ndarray types.
}];
}
2020-04-30 08:49:56 +08:00
//===----------------------------------------------------------------------===//
// Type predicates
//===----------------------------------------------------------------------===//
// Any tensor type legal for numpy ops.
def Numpy_AnyTensor : TensorOf<[AnyType]>;
// Any type, at any stage of analysis that can represent a numpy array.
def Numpy_AnyArray : AnyTypeOf<[
Numpy_AnyTensor,
Numpy_NdArrayType
]>;
2020-04-30 08:49:56 +08:00
def Numpy_SliceTupleElement : AnyTypeOf<[
// Supports both "Index Arrays" and "Boolean mask index arrays".
Numpy_AnyArray,
2020-06-29 08:37:20 +08:00
// Indicates that an axis should be added (np.newaxis == None).
Basicpy_NoneType,
// Indicates that intervening axes should be preserved.
Basicpy_EllipsisType,
// A discrete numeric index (represented as IndexType so that a proper
// width can be target dependent).
Index,
// A generalized slice object.
Basicpy_SliceSlotObjectType,
], "types that are legal elements of a __getitem__ tuple operating on arrays">;
#endif // NPCOMP_DIALECT_NUMPY_IR_NUMPY_DIALECT