//===----------------------------------------------------------------------===// // // Part of the LLVM Project, 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 // //===----------------------------------------------------------------------===// #include "mlir/Dialect/Affine/IR/AffineOps.h" #include "mlir/Dialect/Arith/IR/Arith.h" #include "mlir/Dialect/Arith/Utils/Utils.h" #include "mlir/Dialect/Complex/IR/Complex.h" #include "mlir/Dialect/Tensor/IR/Tensor.h" #include "mlir/Dialect/Utils/IndexingUtils.h" #include "mlir/Dialect/Utils/ReshapeOpsUtils.h" #include "mlir/Dialect/Utils/StaticValueUtils.h" #include "mlir/IR/BlockAndValueMapping.h" #include "mlir/IR/Builders.h" #include "mlir/IR/BuiltinAttributeInterfaces.h" #include "mlir/IR/BuiltinTypes.h" #include "mlir/IR/Matchers.h" #include "mlir/IR/OpDefinition.h" #include "mlir/IR/TypeUtilities.h" #include "mlir/Interfaces/DestinationStyleOpInterface.h" #include "mlir/Support/MathExtras.h" #include "llvm/ADT/DenseSet.h" #include "llvm/ADT/STLExtras.h" #include "llvm/ADT/SmallBitVector.h" #include "llvm/ADT/StringRef.h" #include using namespace mlir; using namespace mlir::tensor; /// Materialize a single constant operation from a given attribute value with /// the desired resultant type. Operation *TensorDialect::materializeConstant(OpBuilder &builder, Attribute value, Type type, Location loc) { if (arith::ConstantOp::isBuildableWith(value, type)) return builder.create(loc, value, type); if (complex::ConstantOp::isBuildableWith(value, type)) return builder.create(loc, type, value.cast()); return nullptr; } SmallVector tensor::getMixedSizes(OpBuilder &builder, Location loc, Value value) { auto tensorType = value.getType().cast(); SmallVector result; for (int64_t i = 0; i < tensorType.getRank(); ++i) { if (tensorType.isDynamicDim(i)) { Value size = builder.create(loc, value, i); result.push_back(size); } else { result.push_back(builder.getIndexAttr(tensorType.getDimSize(i))); } } return result; } FailureOr tensor::getOrCreateDestination(OpBuilder &b, Location loc, OpResult opResult) { auto tensorType = opResult.getType().dyn_cast(); assert(tensorType && "expected tensor type"); // If the op has a destination, it implements DestinationStyleOpInterface and // we can query the destination operand from that interface. auto destOp = opResult.getDefiningOp(); if (destOp) return destOp.getTiedOpOperand(opResult)->get(); // Otherwise, create a new destination tensor with the same shape. OpBuilder::InsertionGuard g(b); b.setInsertionPoint(opResult.getDefiningOp()); // Compute sizes. SmallVector mixedSizes; if (!tensorType.hasStaticShape()) { // Dynamic shape: Query ReifyRankedShapedTypeOpInterface. ReifiedRankedShapedTypeDims reifiedShapes; ReifyRankedShapedTypeOpInterface reifyShapedTypeInterface = dyn_cast(opResult.getDefiningOp()); if (!reifyShapedTypeInterface) return failure(); if (failed(reifyShapedTypeInterface.reifyResultShapes(b, reifiedShapes))) return failure(); mixedSizes = getAsOpFoldResult(reifiedShapes[opResult.getResultNumber()]); } else { // Static shape: Take static sizes directly. for (int64_t sz : tensorType.getShape()) mixedSizes.push_back(b.getIndexAttr(sz)); } // Create empty tensor. Value emptyTensor = b.create(loc, mixedSizes, tensorType.getElementType()); return emptyTensor; } LogicalResult tensor::getOrCreateDestinations(OpBuilder &b, Location loc, Operation *op, SmallVector &result) { for (OpResult opResult : op->getResults()) { if (opResult.getType().isa()) { FailureOr destination = getOrCreateDestination(b, loc, opResult); if (failed(destination)) return failure(); result.push_back(*destination); } } return success(); } //===----------------------------------------------------------------------===// // CastOp //===----------------------------------------------------------------------===// void CastOp::getAsmResultNames(function_ref setNameFn) { setNameFn(getResult(), "cast"); } /// Returns true if `target` is a ranked tensor type that preserves static /// information available in the `source` ranked tensor type. bool mlir::tensor::preservesStaticInformation(Type source, Type target) { auto sourceType = source.dyn_cast(); auto targetType = target.dyn_cast(); // Requires RankedTensorType. if (!sourceType || !targetType) return false; // Requires same elemental type. if (sourceType.getElementType() != targetType.getElementType()) return false; // Requires same rank. if (sourceType.getRank() != targetType.getRank()) return false; // If cast is towards more static sizes along any dimension, don't fold. for (auto t : llvm::zip(sourceType.getShape(), targetType.getShape())) { if (!ShapedType::isDynamic(std::get<0>(t)) && ShapedType::isDynamic(std::get<1>(t))) return false; } return true; } /// Determines whether tensor::CastOp casts to a more dynamic version of the /// source tensor. This is useful to fold a tensor.cast into a consuming op and /// implement canonicalization patterns for ops in different dialects that may /// consume the results of tensor.cast operations. Such foldable tensor.cast /// operations are typically inserted as `slice` ops and are canonicalized, /// to preserve the type compatibility of their uses. /// /// Returns true when all conditions are met: /// 1. source and result are ranked tensors with same element type and rank. /// 2. the tensor type has more static information than the result /// /// Example: /// ```mlir /// %1 = tensor.cast %0 : tensor<8x16xf32> to tensor /// %2 = consumer %1 ... : tensor ... /// ``` /// /// folds into: /// /// ```mlir /// %2 = consumer %0 ... : tensor<8x16xf32> ... /// ``` bool mlir::tensor::canFoldIntoConsumerOp(CastOp castOp) { if (!castOp) return false; // Can fold if the source of cast has at least as much static information as // its results. return preservesStaticInformation(castOp.getType(), castOp.getSource().getType()); } /// Determines whether the tensor::CastOp casts to a more static version of the /// source tensor. This is useful to fold into a producing op and implement /// canonicaliation patterns with the `tensor.cast` op as the root, but producer /// being from different dialects. Returns true when all conditions are met: /// 1. source and result and ranked tensors with same element type and rank. /// 2. the result type has more static information than the source. /// /// Example: /// ```mlir /// %1 = producer ... : tensor /// %2 = tensor.cast %1 : tensor to tensor<8x16xf32> /// ``` /// /// can be canonicalized to : /// /// ```mlir /// %2 = producer ... : tensor<8x16xf32> /// ``` /// Not all ops might be canonicalizable this way, but for those that can be, /// this method provides a check that it is worth doing the canonicalization. bool mlir::tensor::canFoldIntoProducerOp(CastOp castOp) { if (!castOp) return false; return preservesStaticInformation(castOp.getSource().getType(), castOp.getType()); } /// Performs folding of any operand of `op` if it comes from a tensor::CastOp /// that can be folded. LogicalResult mlir::tensor::foldTensorCast(Operation *op) { bool folded = false; for (OpOperand &operand : op->getOpOperands()) { auto castOp = operand.get().getDefiningOp(); if (castOp && tensor::canFoldIntoConsumerOp(castOp)) { operand.set(castOp.getOperand()); folded = true; } } return success(folded); } bool CastOp::areCastCompatible(TypeRange inputs, TypeRange outputs) { if (inputs.size() != 1 || outputs.size() != 1) return false; Type a = inputs.front(), b = outputs.front(); auto aT = a.dyn_cast(); auto bT = b.dyn_cast(); if (!aT || !bT) return false; if (aT.getElementType() != bT.getElementType()) return false; return succeeded(verifyCompatibleShape(aT, bT)); } /// Compute a TensorType that has the joined shape knowledge of the two /// given TensorTypes. The element types need to match. static TensorType joinShapes(TensorType one, TensorType two) { assert(one.getElementType() == two.getElementType()); if (!one.hasRank()) return two; if (!two.hasRank()) return one; int64_t rank = one.getRank(); if (rank != two.getRank()) return {}; SmallVector join; join.reserve(rank); for (int64_t i = 0; i < rank; ++i) { if (one.isDynamicDim(i)) { join.push_back(two.getDimSize(i)); continue; } if (two.isDynamicDim(i)) { join.push_back(one.getDimSize(i)); continue; } if (one.getDimSize(i) != two.getDimSize(i)) return {}; join.push_back(one.getDimSize(i)); } return RankedTensorType::get(join, one.getElementType()); } namespace { /// Replaces chains of two tensor.cast operations by a single tensor.cast /// operation if doing so does not remove runtime constraints. struct ChainedTensorCast : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(CastOp tensorCast, PatternRewriter &rewriter) const final { auto tensorCastOperand = tensorCast.getOperand().getDefiningOp(); if (!tensorCastOperand) return failure(); auto sourceType = tensorCastOperand.getOperand().getType().cast(); auto intermediateType = tensorCastOperand.getType().cast(); auto resultType = tensorCast.getType().cast(); // We can remove the intermediate cast if joining all three produces the // same result as just joining the source and result shapes. auto firstJoin = joinShapes(joinShapes(sourceType, intermediateType), resultType); // The join might not exist if the cast sequence would fail at runtime. if (!firstJoin) return failure(); // The newJoin always exists if the above join exists, it might just contain // less information. If so, we cannot drop the intermediate cast, as doing // so would remove runtime checks. auto newJoin = joinShapes(sourceType, resultType); if (firstJoin != newJoin) return failure(); rewriter.replaceOpWithNewOp(tensorCast, resultType, tensorCastOperand.getOperand()); return success(); } }; /// Fold tensor.cast into tesor.extract_slice producer. /// Example: /// ``` /// %0 = tensor.extract_slice %arg0[%o, 0] [%s, 512] [1, 1] : /// tensor<128x512xf32> to tensor /// %1 = tensor.cast %0 : tensor to tensor<16x512xf32> /// ``` /// -> /// ``` /// %1 = tensor.extract_slice %arg0[%o, 0] [16, 512] [1, 1] : /// tensor<128x512xf32> to tensor<16x512xf32> /// ``` struct TensorCastExtractSlice : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(CastOp tensorCast, PatternRewriter &rewriter) const final { auto extractOperand = tensorCast.getOperand().getDefiningOp(); if (!extractOperand || !canFoldIntoProducerOp(tensorCast) || tensorCast.getType().getShape() == tensorCast.getSource() .getType() .cast() .getShape()) return failure(); SmallVector sizes = extractOperand.getMixedSizes(); auto dimMask = computeRankReductionMask( extractOperand.getStaticSizes(), extractOperand.getType().getShape()); size_t dimIndex = 0; for (size_t i = 0, e = sizes.size(); i < e; i++) { if (dimMask && dimMask->count(i)) continue; int64_t dim = tensorCast.getType().getShape()[dimIndex++]; if (ShapedType::isDynamic(dim)) continue; sizes[i] = rewriter.getIndexAttr(dim); } rewriter.replaceOpWithNewOp( tensorCast, tensorCast.getType().cast(), extractOperand.getSource(), extractOperand.getMixedOffsets(), sizes, extractOperand.getMixedStrides()); return success(); } }; } // namespace void CastOp::getCanonicalizationPatterns(RewritePatternSet &results, MLIRContext *context) { results.add(context); } //===----------------------------------------------------------------------===// // DimOp //===----------------------------------------------------------------------===// void DimOp::getAsmResultNames(function_ref setNameFn) { setNameFn(getResult(), "dim"); } void DimOp::build(OpBuilder &builder, OperationState &result, Value source, int64_t index) { auto loc = result.location; Value indexValue = builder.create(loc, index); build(builder, result, source, indexValue); } std::optional DimOp::getConstantIndex() { return getConstantIntValue(getIndex()); } Speculation::Speculatability DimOp::getSpeculatability() { auto constantIndex = getConstantIndex(); if (!constantIndex) return Speculation::NotSpeculatable; auto rankedSourceType = dyn_cast(getSource().getType()); if (!rankedSourceType) return Speculation::NotSpeculatable; // The verifier rejects operations that violate this assertion. assert(constantIndex < rankedSourceType.getRank()); return Speculation::Speculatable; } LogicalResult DimOp::verify() { // Assume unknown index to be in range. std::optional index = getConstantIndex(); if (!index) return success(); // Check that constant index is not knowingly out of range. auto type = getSource().getType(); if (auto tensorType = type.dyn_cast()) { if (*index >= tensorType.getRank()) return emitOpError("index is out of range"); } else if (type.isa()) { // Assume index to be in range. } else { llvm_unreachable("expected operand with tensor type"); } return success(); } OpFoldResult DimOp::fold(ArrayRef operands) { // All forms of folding require a known index. auto index = operands[1].dyn_cast_or_null(); if (!index) return {}; // Folding for unranked types (UnrankedTensorType) is not supported. auto tensorType = getSource().getType().dyn_cast(); if (!tensorType) return {}; // Fold if the shape extent along the given index is known. if (!tensorType.isDynamicDim(index.getInt())) { Builder builder(getContext()); return builder.getIndexAttr(tensorType.getShape()[index.getInt()]); } Operation *definingOp = getSource().getDefiningOp(); // Fold dim to the operand of tensor.generate. if (auto fromElements = dyn_cast_or_null(definingOp)) { auto resultType = fromElements.getResult().getType().cast(); // The case where the type encodes the size of the dimension is handled // above. assert(ShapedType::isDynamic(resultType.getShape()[index.getInt()])); // Find the operand of the fromElements that corresponds to this index. auto dynExtents = fromElements.getDynamicExtents().begin(); for (auto dim : resultType.getShape().take_front(index.getInt())) if (ShapedType::isDynamic(dim)) dynExtents++; return Value{*dynExtents}; } // The size at the given index is now known to be a dynamic size. unsigned unsignedIndex = index.getValue().getZExtValue(); if (auto sliceOp = dyn_cast_or_null(definingOp)) { // Fold only for non-rank reduced ops. For the rank-reduced version, rely on // `resolve-shaped-type-result-dims` pass. if (sliceOp.getType().getRank() == sliceOp.getSourceType().getRank() && sliceOp.isDynamicSize(unsignedIndex)) { return {sliceOp.getDynamicSize(unsignedIndex)}; } } // dim(cast) -> dim if (succeeded(foldTensorCast(*this))) return getResult(); return {}; } namespace { /// Fold dim of a cast into the dim of the source of the tensor cast. struct DimOfCastOp : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(DimOp dimOp, PatternRewriter &rewriter) const override { auto castOp = dimOp.getSource().getDefiningOp(); if (!castOp) return failure(); Value newSource = castOp.getOperand(); rewriter.replaceOpWithNewOp(dimOp, newSource, dimOp.getIndex()); return success(); } }; } // namespace void DimOp::getCanonicalizationPatterns(RewritePatternSet &results, MLIRContext *context) { results.add(context); } //===----------------------------------------------------------------------===// // EmptyOp //===----------------------------------------------------------------------===// void EmptyOp::build(OpBuilder &builder, OperationState &result, ArrayRef staticShape, Type elementType, Attribute encoding) { assert(all_of(staticShape, [](int64_t sz) { return !ShapedType::isDynamic(sz); }) && "expected only static sizes"); build(builder, result, staticShape, elementType, ValueRange{}, encoding); } void EmptyOp::build(OpBuilder &builder, OperationState &result, ArrayRef staticShape, Type elementType, ValueRange dynamicSizes, Attribute encoding) { auto tensorType = RankedTensorType::get(staticShape, elementType, encoding); build(builder, result, tensorType, dynamicSizes); } void EmptyOp::build(OpBuilder &builder, OperationState &result, ArrayRef sizes, Type elementType, Attribute encoding) { SmallVector staticShape; SmallVector dynamicSizes; dispatchIndexOpFoldResults(sizes, dynamicSizes, staticShape); build(builder, result, staticShape, elementType, dynamicSizes, encoding); } LogicalResult EmptyOp::verify() { if (getType().getNumDynamicDims() != static_cast(getDynamicSizes().size())) return emitOpError("incorrect number of dynamic sizes, has ") << getDynamicSizes().size() << ", expected " << getType().getNumDynamicDims(); return success(); } LogicalResult EmptyOp::reifyResultShapes(OpBuilder &builder, ReifiedRankedShapedTypeDims &reifiedReturnShapes) { reifiedReturnShapes.resize(1, SmallVector(getType().getRank())); unsigned ctr = 0; for (int64_t i = 0; i < getType().getRank(); ++i) { if (getType().isDynamicDim(i)) { reifiedReturnShapes[0][i] = getDynamicSizes()[ctr++]; } else { reifiedReturnShapes[0][i] = builder.create(getLoc(), i); } } return success(); } Value EmptyOp::getDynamicSize(unsigned idx) { assert(getType().isDynamicDim(idx) && "expected dynamic dim"); unsigned ctr = 0; for (int64_t i = 0; i < static_cast(idx); ++i) if (getType().isDynamicDim(i)) ++ctr; return getDynamicSizes()[ctr]; } SmallVector EmptyOp::getMixedSizes() { SmallVector result; unsigned ctr = 0; OpBuilder b(getContext()); for (int64_t i = 0; i < getType().getRank(); ++i) { if (getType().isDynamicDim(i)) { result.push_back(getDynamicSizes()[ctr++]); } else { result.push_back(b.getIndexAttr(getType().getShape()[i])); } } return result; } namespace { /// Change the type of the result of a `tensor.empty` by making the result /// type statically sized along dimensions that in the original operation were /// defined as dynamic, but the size was defined using a `constant` op. For /// example /// /// %c5 = arith.constant 5: index /// %0 = tensor.empty(%arg0, %c5) : tensor /// /// to /// /// %0 = tensor.empty(%arg0) : tensor struct ReplaceEmptyTensorStaticShapeDims : OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(EmptyOp op, PatternRewriter &rewriter) const override { SmallVector staticShape(op.getType().getShape().begin(), op.getType().getShape().end()); SmallVector dynamicSizes; // Compute new static and dynamic sizes. unsigned ctr = 0; bool changedType = false; for (int64_t i = 0; i < op.getType().getRank(); ++i) { if (op.getType().isDynamicDim(i)) { Value dynamicSize = op.getDynamicSizes()[ctr++]; std::optional cst = getConstantIntValue(dynamicSize); if (cst.has_value()) { staticShape[i] = *cst; changedType = true; } else { dynamicSizes.push_back(dynamicSize); } } } // Stop here if no dynamic size was promoted to static. if (!changedType) return failure(); auto tensorType = RankedTensorType::get( staticShape, op.getType().getElementType(), op.getType().getEncoding()); auto newOp = rewriter.create(op.getLoc(), tensorType, dynamicSizes); rewriter.replaceOpWithNewOp(op, op.getType(), newOp); return success(); } }; struct FoldEmptyTensorWithDimOp : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(tensor::DimOp dimOp, PatternRewriter &rewriter) const override { std::optional maybeConstantIndex = dimOp.getConstantIndex(); auto emptyTensorOp = dimOp.getSource().getDefiningOp(); if (!emptyTensorOp || !maybeConstantIndex) return failure(); if (!emptyTensorOp.getType().isDynamicDim(*maybeConstantIndex)) return failure(); rewriter.replaceOp(dimOp, emptyTensorOp.getDynamicSize(*maybeConstantIndex)); return success(); } }; /// Canonicalize /// /// ```mlir /// %0 = tensor.empty(%d0, %d1) : tensor /// %1 = tensor.cast %0 : tensor to tensor<4x?xf32> /// ``` /// /// into /// /// ```mlir /// %0 = tensor.empty(%d1) : tensor<4x?xf32> /// ``` /// /// This assumes the input program is correct in terms of its shape. So it is /// safe to assume that `%d0` is in fact 4. struct FoldEmptyTensorWithCastOp : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(CastOp castOp, PatternRewriter &rewriter) const override { if (!canFoldIntoProducerOp(castOp)) return failure(); auto producer = castOp.getSource().getDefiningOp(); if (!producer) return failure(); auto resultType = castOp->getResult(0).getType().cast(); ArrayRef resultShape = resultType.getShape(); SmallVector currMixedSizes = producer.getMixedSizes(); SmallVector newMixedSizes; newMixedSizes.reserve(currMixedSizes.size()); assert(resultShape.size() == currMixedSizes.size() && "mismatch in result shape and sizes of empty op"); for (auto it : llvm::zip(resultShape, currMixedSizes)) { int64_t newDim = std::get<0>(it); OpFoldResult currDim = std::get<1>(it); // Case 1: The empty tensor dim is static. Check that the tensor cast // result dim matches. if (auto attr = currDim.dyn_cast()) { if (ShapedType::isDynamic(newDim) || newDim != attr.cast().getInt()) { // Something is off, the cast result shape cannot be more dynamic // than the empty tensor result shape (enforced by // `canFoldIntoProducer`). Abort for now. return rewriter.notifyMatchFailure( producer, "mismatch in static value of shape of empty tensor " "result and cast result"); } newMixedSizes.push_back(attr); continue; } // Case 2 : The tensor cast shape is static, but empty tensor result // shape is dynamic. if (!ShapedType::isDynamic(newDim)) { newMixedSizes.push_back(rewriter.getIndexAttr(newDim)); continue; } // Case 3 : The tensor cast shape is dynamic and empty tensor result // shape is dynamic. Use the dynamic value from the empty tensor op. newMixedSizes.push_back(currDim); } // TODO: Do not drop tensor encoding. rewriter.replaceOpWithNewOp(castOp, newMixedSizes, resultType.getElementType()); return success(); } }; } // namespace void EmptyOp::getCanonicalizationPatterns(RewritePatternSet &results, MLIRContext *context) { results.add(context); } //===----------------------------------------------------------------------===// // ExtractOp //===----------------------------------------------------------------------===// namespace { /// Canonicalizes the pattern of the form /// /// %val = tensor.cast %source : : tensor to tensor<2xi32> /// %extracted_element = tensor.extract %val[%c0] : tensor<2xi32> /// /// to /// /// %extracted_element = tensor.extract %source[%c0] : tensor struct ExtractFromTensorCast : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(tensor::ExtractOp extract, PatternRewriter &rewriter) const final { auto tensorCast = extract.getTensor().getDefiningOp(); if (!tensorCast) return failure(); if (!tensorCast.getSource().getType().isa()) return failure(); rewriter.replaceOpWithNewOp( extract, tensorCast.getSource(), extract.getIndices()); return success(); } }; } // namespace void ExtractOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "extracted"); } LogicalResult ExtractOp::verify() { // Verify the # indices match if we have a ranked type. auto tensorType = getTensor().getType().cast(); if (tensorType.getRank() != static_cast(getIndices().size())) return emitOpError("incorrect number of indices for extract_element"); return success(); } OpFoldResult ExtractOp::fold(ArrayRef operands) { // If this is a splat elements attribute, simply return the value. All of // the elements of a splat attribute are the same. if (Attribute tensor = operands.front()) if (auto splatTensor = tensor.dyn_cast()) return splatTensor.getSplatValue(); // Collect the constant indices into the tensor. SmallVector indices; for (Attribute indice : llvm::drop_begin(operands, 1)) { if (!indice || !indice.isa()) return {}; indices.push_back(indice.cast().getInt()); } // Fold extract(from_elements(...)). if (auto fromElementsOp = getTensor().getDefiningOp()) { auto tensorType = fromElementsOp.getType().cast(); auto rank = tensorType.getRank(); assert(static_cast(indices.size()) == tensorType.getRank() && "rank mismatch"); int flatIndex = 0; int stride = 1; for (int i = rank - 1; i >= 0; --i) { if (i < rank - 1) stride *= tensorType.getDimSize(i); flatIndex += indices[i] * stride; } // Prevent out of bounds accesses. This can happen in invalid code that // will never execute. if (static_cast(fromElementsOp.getElements().size()) <= flatIndex || flatIndex < 0) return {}; return fromElementsOp.getElements()[flatIndex]; } // If this is an elements attribute, query the value at the given indices. if (Attribute tensor = operands.front()) { auto elementsAttr = tensor.dyn_cast(); if (elementsAttr && elementsAttr.isValidIndex(indices)) return elementsAttr.getValues()[indices]; } return {}; } void ExtractOp::getCanonicalizationPatterns(RewritePatternSet &results, MLIRContext *context) { results.add(context); } //===----------------------------------------------------------------------===// // FromElementsOp //===----------------------------------------------------------------------===// void FromElementsOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "from_elements"); } void FromElementsOp::build(OpBuilder &builder, OperationState &result, Type resultType, ValueRange elements) { result.addOperands(elements); result.addTypes(resultType); } void FromElementsOp::build(OpBuilder &builder, OperationState &result, ValueRange elements) { assert(!elements.empty() && "expected at least one element"); Type resultType = RankedTensorType::get( {static_cast(elements.size())}, elements.front().getType()); build(builder, result, resultType, elements); } OpFoldResult FromElementsOp::fold(ArrayRef operands) { if (!llvm::is_contained(operands, nullptr)) return DenseElementsAttr::get(getType(), operands); return {}; } namespace { // Pushes the index_casts that occur before extractions to after the extract. // This minimizes type conversion in some cases and enables the extract // canonicalizer. This changes: // // %cast = arith.index_cast %tensor : tensor<1xi32> to tensor<1xindex> // %extract = tensor.extract %cast[%index] : tensor<1xindex> // // to the following: // // %extract = tensor.extract %tensor[%index] : tensor<1xindex> // %cast = arith.index_cast %extract : i32 to index // // to just %element. // // Consider expanding this to a template and handle all tensor cast // operations. struct ExtractElementFromIndexCast : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(tensor::ExtractOp extract, PatternRewriter &rewriter) const final { Location loc = extract.getLoc(); auto indexCast = extract.getTensor().getDefiningOp(); if (!indexCast) return failure(); Type elementTy = getElementTypeOrSelf(indexCast.getIn()); auto newExtract = rewriter.create( loc, elementTy, indexCast.getIn(), extract.getIndices()); rewriter.replaceOpWithNewOp(extract, extract.getType(), newExtract); return success(); } }; } // namespace void FromElementsOp::getCanonicalizationPatterns(RewritePatternSet &results, MLIRContext *context) { results.add(context); } //===----------------------------------------------------------------------===// // GatherOp //===----------------------------------------------------------------------===// void GatherOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "gather"); } /// Return the inferred result type for a gatherOp where: /// - sourceType is the type of the source tensor gathered from /// - indicesType is the type of the indices used to gather /// - gatherDims are the dims along which the gather occurs. /// Return a full rank or ranked-reduced variant of the type depending on /// the value of rankReduced. /// /// The leading dimensions of the index tensor give the result tensor its /// leading dimensions. /// The trailing dimensions of the result tensor are obtained from the source /// tensor by setting the dimensions specified in gather_dims to `1` (if /// rankedReduced is false), or skipping them (otherwise). RankedTensorType GatherOp::inferResultType(RankedTensorType sourceType, RankedTensorType indicesType, ArrayRef gatherDims, bool rankReduced) { SmallVector resultShape(indicesType.getShape().drop_back()); resultShape.reserve(resultShape.size() + sourceType.getRank()); for (int64_t idx : llvm::seq(0, sourceType.getRank())) { if (std::binary_search(gatherDims.begin(), gatherDims.end(), idx)) { if (!rankReduced) resultShape.push_back(1); continue; } resultShape.push_back(sourceType.getDimSize(idx)); } return RankedTensorType::Builder(sourceType).setShape(resultShape); } static LogicalResult verifyGatherOrScatterDims(Operation *op, ArrayRef dims, int64_t rank, StringRef gatherOrScatter, StringRef sourceOrDest) { if (dims.empty()) return op->emitOpError(gatherOrScatter) << "_dims must be non-empty"; int64_t numGatherDims = dims.size(); if (numGatherDims > rank) return op->emitOpError(gatherOrScatter) << "_dims overflow " << sourceOrDest << " rank"; for (int64_t val : dims) { if (val < 0) return op->emitOpError(gatherOrScatter) << "_dims value must be non-negative"; if (val >= rank) return op->emitOpError(gatherOrScatter) << "_dims value must be smaller than " << sourceOrDest << " rank"; } for (int64_t i = 1; i < numGatherDims; ++i) { if (dims[i - 1] >= dims[i]) return op->emitOpError(gatherOrScatter) << "_dims values must be strictly increasing"; } return success(); } LogicalResult GatherOp::verify() { int64_t sourceRank = getSourceType().getRank(); ArrayRef gatherDims = getGatherDims(); if (failed(verifyGatherOrScatterDims(getOperation(), gatherDims, sourceRank, "gather", "source"))) return failure(); RankedTensorType expectedResultType = GatherOp::inferResultType( getSourceType(), getIndicesType(), gatherDims, /*rankReduced=*/false); RankedTensorType expectedRankReducedResultType = GatherOp::inferResultType( getSourceType(), getIndicesType(), gatherDims, /*rankReduced=*/true); if (getResultType() != expectedResultType && getResultType() != expectedRankReducedResultType) { return emitOpError("result type " "mismatch: " "expected ") << expectedResultType << " or its rank-reduced variant " << expectedRankReducedResultType << " (got: " << getResultType() << ")"; } return success(); } //===----------------------------------------------------------------------===// // InsertOp //===----------------------------------------------------------------------===// void InsertOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "inserted"); } LogicalResult InsertOp::verify() { // Verify the # indices match if we have a ranked type. auto destType = getDest().getType().cast(); if (destType.getRank() != static_cast(getIndices().size())) return emitOpError("incorrect number of indices"); return success(); } OpFoldResult InsertOp::fold(ArrayRef operands) { Attribute scalar = operands[0]; Attribute dest = operands[1]; if (scalar && dest) if (auto splatDest = dest.dyn_cast()) if (scalar == splatDest.getSplatValue()) return dest; return {}; } //===----------------------------------------------------------------------===// // GenerateOp //===----------------------------------------------------------------------===// void GenerateOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "generated"); } LogicalResult GenerateOp::reifyResultShapes( OpBuilder &builder, ReifiedRankedShapedTypeDims &reifiedReturnShapes) { reifiedReturnShapes.resize(1, SmallVector(getType().getRank())); int idx = 0; for (auto dim : llvm::seq(0, getType().getRank())) { if (getType().isDynamicDim(dim)) { reifiedReturnShapes[0][dim] = getOperand(idx++); } else { reifiedReturnShapes[0][dim] = builder.create( getLoc(), getType().getDimSize(dim)); } } return success(); } LogicalResult GenerateOp::verify() { // Ensure that the tensor type has as many dynamic dimensions as are // specified by the operands. RankedTensorType resultTy = getType().cast(); if (getNumOperands() != resultTy.getNumDynamicDims()) return emitError("must have as many index operands as dynamic extents " "in the result type"); return success(); } LogicalResult GenerateOp::verifyRegions() { RankedTensorType resultTy = getType().cast(); // Ensure that region arguments span the index space. if (!llvm::all_of(getBody().getArgumentTypes(), [](Type ty) { return ty.isIndex(); })) return emitError("all body arguments must be index"); if (getBody().getNumArguments() != resultTy.getRank()) return emitError("must have one body argument per input dimension"); // Ensure that the region yields an element of the right type. auto yieldOp = cast(getBody().getBlocks().front().getTerminator()); if (yieldOp.getValue().getType() != resultTy.getElementType()) return emitOpError( "body must be terminated with a `yield` operation of the tensor " "element type"); return success(); } void GenerateOp::build( OpBuilder &b, OperationState &result, Type resultTy, ValueRange dynamicExtents, function_ref bodyBuilder) { build(b, result, resultTy, dynamicExtents); // Build and populate body. OpBuilder::InsertionGuard guard(b); Region *bodyRegion = result.regions.front().get(); auto rank = resultTy.cast().getRank(); SmallVector argumentTypes(rank, b.getIndexType()); SmallVector argumentLocs(rank, result.location); Block *bodyBlock = b.createBlock(bodyRegion, bodyRegion->end(), argumentTypes, argumentLocs); bodyBuilder(b, result.location, bodyBlock->getArguments()); } namespace { /// Canonicalizes tensor.generate operations with a constant /// operand into the equivalent operation with the operand expressed in the /// result type, instead. We also insert a type cast to make sure that the /// resulting IR is still well-typed. struct StaticTensorGenerate : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(GenerateOp tensorFromElements, PatternRewriter &rewriter) const final { auto resultType = tensorFromElements.getResult().getType().cast(); if (resultType.hasStaticShape()) return failure(); SmallVector newOperands; SmallVector newShape; auto operandsIt = tensorFromElements.getDynamicExtents().begin(); for (int64_t dim : resultType.getShape()) { if (!ShapedType::isDynamic(dim)) { newShape.push_back(dim); continue; } APInt index; if (!matchPattern(*operandsIt, m_ConstantInt(&index))) { newShape.push_back(ShapedType::kDynamic); newOperands.push_back(*operandsIt++); continue; } newShape.push_back(index.getSExtValue()); operandsIt++; } if (newOperands.size() == tensorFromElements.getDynamicExtents().size()) return failure(); auto loc = tensorFromElements.getLoc(); auto newOp = rewriter.create( loc, RankedTensorType::get(newShape, resultType.getElementType()), newOperands); rewriter.inlineRegionBefore(tensorFromElements.getBody(), newOp.getBody(), newOp.getBody().begin()); rewriter.replaceOpWithNewOp(tensorFromElements, resultType, newOp); return success(); } }; /// Canonicalizes the pattern of the form /// /// %tensor = tensor.generate %x { /// ^bb0(%arg0: index): /// /// yield %1 : index /// } : tensor /// %extracted_element = tensor.extract %tensor[%c0] : tensor /// /// to just with %arg0 replaced by %c0. We only do this if the /// tensor.generate operation has no side-effects. struct ExtractFromTensorGenerate : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(tensor::ExtractOp extract, PatternRewriter &rewriter) const final { auto tensorFromElements = extract.getTensor().getDefiningOp(); if (!tensorFromElements || !wouldOpBeTriviallyDead(tensorFromElements)) return failure(); BlockAndValueMapping mapping; Block *body = &tensorFromElements.getBody().front(); mapping.map(body->getArguments(), extract.getIndices()); for (auto &op : body->without_terminator()) rewriter.clone(op, mapping); auto yield = cast(body->getTerminator()); rewriter.replaceOp(extract, mapping.lookupOrDefault(yield.getValue())); return success(); } }; } // namespace void GenerateOp::getCanonicalizationPatterns(RewritePatternSet &results, MLIRContext *context) { // TODO: Move extract pattern to tensor::ExtractOp. results.add(context); } //===----------------------------------------------------------------------===// // RankOp //===----------------------------------------------------------------------===// void RankOp::getAsmResultNames(function_ref setNameFn) { setNameFn(getResult(), "rank"); } OpFoldResult RankOp::fold(ArrayRef operands) { // Constant fold rank when the rank of the operand is known. auto type = getOperand().getType(); auto shapedType = type.dyn_cast(); if (shapedType && shapedType.hasRank()) return IntegerAttr::get(IndexType::get(getContext()), shapedType.getRank()); return IntegerAttr(); } //===----------------------------------------------------------------------===// // ReshapeOp //===----------------------------------------------------------------------===// void ReshapeOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "reshape"); } static int64_t getNumElements(ShapedType type) { int64_t numElements = 1; for (auto dim : type.getShape()) numElements *= dim; return numElements; } LogicalResult ReshapeOp::verify() { TensorType operandType = getSource().getType().cast(); TensorType resultType = getResult().getType().cast(); if (operandType.getElementType() != resultType.getElementType()) return emitOpError("element types of source and destination tensor " "types should be the same"); int64_t shapeSize = getShape().getType().cast().getDimSize(0); auto resultRankedType = resultType.dyn_cast(); auto operandRankedType = operandType.dyn_cast(); if (resultRankedType) { if (operandRankedType && resultRankedType.hasStaticShape() && operandRankedType.hasStaticShape()) { if (getNumElements(operandRankedType) != getNumElements(resultRankedType)) return emitOpError("source and destination tensor should have the " "same number of elements"); } if (ShapedType::isDynamic(shapeSize)) return emitOpError("cannot use shape operand with dynamic length to " "reshape to statically-ranked tensor type"); if (shapeSize != resultRankedType.getRank()) return emitOpError( "length of shape operand differs from the result's tensor rank"); } return success(); } //===----------------------------------------------------------------------===// // Reassociative reshape ops //===----------------------------------------------------------------------===// void CollapseShapeOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "collapsed"); } void ExpandShapeOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "expanded"); } int64_t ExpandShapeOp::getCorrespondingSourceDim(int64_t resultDim) { assert(resultDim >= 0 && resultDim < getResultType().getRank() && "invalid resultDim"); for (const auto &it : llvm::enumerate(getReassociationIndices())) if (llvm::find(it.value(), resultDim) != it.value().end()) return it.index(); llvm_unreachable("could not find reassociation group"); } SmallVector CollapseShapeOp::getReassociationMaps() { return getSymbolLessAffineMaps(getReassociationExprs()); } SmallVector CollapseShapeOp::getReassociationExprs() { return convertReassociationIndicesToExprs(getContext(), getReassociationIndices()); } SmallVector ExpandShapeOp::getReassociationMaps() { return getSymbolLessAffineMaps(getReassociationExprs()); } SmallVector ExpandShapeOp::getReassociationExprs() { return convertReassociationIndicesToExprs(getContext(), getReassociationIndices()); } /// Compute the RankedTensorType obtained by applying `reassociation` to /// `type`. static RankedTensorType computeTensorReshapeCollapsedType(RankedTensorType type, ArrayRef reassociation) { auto shape = type.getShape(); SmallVector newShape; newShape.reserve(reassociation.size()); // Use the fact that reassociation is valid to simplify the logic: only use // each map's rank. assert(isReassociationValid(reassociation) && "invalid reassociation"); unsigned currentDim = 0; for (AffineMap m : reassociation) { unsigned dim = m.getNumResults(); auto band = shape.slice(currentDim, dim); int64_t size = 1; if (llvm::is_contained(band, ShapedType::kDynamic)) size = ShapedType::kDynamic; else for (unsigned d = 0; d < dim; ++d) size *= shape[currentDim + d]; newShape.push_back(size); currentDim += dim; } return RankedTensorType::get(newShape, type.getElementType()); } void CollapseShapeOp::build(OpBuilder &b, OperationState &result, Value src, ArrayRef reassociation, ArrayRef attrs) { auto resultType = computeTensorReshapeCollapsedType( src.getType().cast(), getSymbolLessAffineMaps( convertReassociationIndicesToExprs(b.getContext(), reassociation))); build(b, result, resultType, src, attrs); result.addAttribute(getReassociationAttrStrName(), getReassociationIndicesAttribute(b, reassociation)); } // Checks if types are the same, but ignoring encoding on ranked tensors. static bool isSameTypesWithoutEncoding(Type tp1, Type tp2) { if (auto rtp1 = tp1.dyn_cast()) { if (auto rtp2 = tp2.dyn_cast()) return rtp1.getShape() == rtp2.getShape() && rtp1.getElementType() == rtp2.getElementType(); return false; } // Default implementation. return tp1 == tp2; } template ::value> static LogicalResult verifyTensorReshapeOp(TensorReshapeOp op, RankedTensorType expandedType, RankedTensorType collapsedType) { if (failed( verifyReshapeLikeTypes(op, expandedType, collapsedType, isExpansion))) return failure(); auto maps = op.getReassociationMaps(); RankedTensorType expectedType = computeTensorReshapeCollapsedType(expandedType, maps); if (!isSameTypesWithoutEncoding(collapsedType, expectedType)) return op.emitOpError("expected collapsed type to be ") << expectedType << ", but got " << collapsedType; return success(); } LogicalResult ExpandShapeOp::verify() { auto srcType = getSrcType(); auto resultType = getResultType(); if (srcType.getRank() >= resultType.getRank()) return emitOpError("expected rank expansion, but found source rank ") << srcType.getRank() << " >= result rank " << resultType.getRank(); return verifyTensorReshapeOp(*this, getResultType(), getSrcType()); } LogicalResult CollapseShapeOp::verify() { auto srcType = getSrcType(); auto resultType = getResultType(); if (srcType.getRank() <= resultType.getRank()) return emitOpError("expected rank reduction, but found source rank ") << srcType.getRank() << " <= result rank " << resultType.getRank(); return verifyTensorReshapeOp(*this, getSrcType(), getResultType()); } namespace { /// Reshape of a splat constant can be replaced with a constant of the result /// type. template struct FoldReshapeWithConstant : OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(TensorReshapeOp reshapeOp, PatternRewriter &rewriter) const override { DenseElementsAttr attr; if (!matchPattern(reshapeOp.getSrc(), m_Constant(&attr))) return failure(); if (!attr || !attr.isSplat()) return failure(); DenseElementsAttr newAttr = DenseElementsAttr::getFromRawBuffer( reshapeOp.getResultType(), attr.getRawData()); rewriter.replaceOpWithNewOp(reshapeOp, newAttr); return success(); } }; // Folds TensorReshapeOp(splat x : src_type) : res_type into splat x : res_type. template class FoldReshapeWithSplat : public OpRewritePattern { public: using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(TensorReshapeOp reshapeOp, PatternRewriter &rewriter) const override { auto splatOp = reshapeOp.getSrc().template getDefiningOp(); if (!splatOp) return failure(); rewriter.replaceOpWithNewOp( reshapeOp, reshapeOp.getResultType(), splatOp.getInput()); return success(); } }; /// Reshape of a FromElements can be replaced with a FromElements of the /// result type template struct FoldReshapeWithFromElements : OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(TensorReshapeOp reshapeOp, PatternRewriter &rewriter) const override { auto fromElements = reshapeOp.getSrc().template getDefiningOp(); if (!fromElements) return failure(); auto shapedTy = reshapeOp.getType().template cast(); if (!shapedTy.hasStaticShape()) return failure(); rewriter.replaceOpWithNewOp(reshapeOp, reshapeOp.getType(), fromElements.getElements()); return success(); } }; // Fold CastOp into CollapseShapeOp when adding static information. struct FoldCollapseOfCastOp : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(CollapseShapeOp collapseShapeOp, PatternRewriter &rewriter) const override { auto castOp = collapseShapeOp.getSrc().getDefiningOp(); if (!tensor::canFoldIntoConsumerOp(castOp)) return failure(); RankedTensorType srcType = castOp.getSource().getType().cast(); RankedTensorType newResultType = computeTensorReshapeCollapsedType( srcType, collapseShapeOp.getReassociationMaps()); if (newResultType == collapseShapeOp.getResultType()) { rewriter.updateRootInPlace(collapseShapeOp, [&]() { collapseShapeOp.getSrcMutable().assign(castOp.getSource()); }); } else { auto newOp = rewriter.create( collapseShapeOp.getLoc(), newResultType, castOp.getSource(), collapseShapeOp.getReassociation()); rewriter.replaceOpWithNewOp( collapseShapeOp, collapseShapeOp.getResultType(), newOp); } return success(); } }; struct FoldDimOfExpandShape : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(DimOp dimOp, PatternRewriter &rewriter) const override { auto expandShapeOp = dimOp.getSource().getDefiningOp(); if (!expandShapeOp) return failure(); // Only constant dimension values are supported. std::optional dim = dimOp.getConstantIndex(); if (!dim.has_value()) return failure(); // Skip static dims. These are folded to constant ops. TensorType resultType = expandShapeOp.getResultType(); if (!resultType.isDynamicDim(*dim)) return failure(); // Find reassociation group that contains this result dimension. int64_t srcDim = expandShapeOp.getCorrespondingSourceDim(*dim); // `dim` is the only dynamic dimension in `group`. (Otherwise, the // ExpandShapeOp would be ambiguous.) int64_t product = 1; ReassociationIndices grp = expandShapeOp.getReassociationIndices()[srcDim]; for (int64_t d : grp) { if (d != dim) { assert(!resultType.isDynamicDim(d) && "expected static dim"); product *= resultType.getDimSize(d); } } // result dim size = src dim size / (product(other dims in reassoc group)) Value srcDimSz = rewriter.create(dimOp.getLoc(), expandShapeOp.getSrc(), srcDim); AffineExpr expr; bindSymbols(dimOp.getContext(), expr); rewriter.replaceOpWithNewOp(dimOp, expr.floorDiv(product), srcDimSz); return success(); } }; struct FoldDimOfCollapseShape : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(DimOp dimOp, PatternRewriter &rewriter) const override { auto collapseShapeOp = dimOp.getSource().getDefiningOp(); if (!collapseShapeOp) return failure(); // Only constant dimension values are supported. std::optional dim = dimOp.getConstantIndex(); if (!dim.has_value()) return failure(); // Skip static dims. These are folded to constant ops. TensorType resultType = collapseShapeOp.getResultType(); if (!resultType.isDynamicDim(*dim)) return failure(); // Get reassociation group of the result dimension. ReassociationIndices group = collapseShapeOp.getReassociationIndices()[*dim]; // result dim size = product(dims in reassoc group) SmallVector srcDimSizes; SmallVector syms; AffineExpr product; for (const auto &it : llvm::enumerate(group)) { srcDimSizes.push_back(rewriter.create( dimOp.getLoc(), collapseShapeOp.getSrc(), it.value())); syms.push_back(rewriter.getAffineSymbolExpr(it.index())); product = product ? product * syms.back() : syms.back(); } rewriter.replaceOpWithNewOp(dimOp, product, srcDimSizes); return success(); } }; } // namespace void ExpandShapeOp::getCanonicalizationPatterns(RewritePatternSet &results, MLIRContext *context) { results.add, ComposeExpandOfCollapseOp, FoldReshapeWithConstant, FoldReshapeWithSplat, FoldReshapeWithFromElements, FoldDimOfExpandShape, FoldDimOfCollapseShape>(context); } void CollapseShapeOp::getCanonicalizationPatterns(RewritePatternSet &results, MLIRContext *context) { results .add, ComposeCollapseOfExpandOp, FoldReshapeWithConstant, FoldReshapeWithSplat, FoldReshapeWithFromElements, FoldCollapseOfCastOp>( context); } OpFoldResult ExpandShapeOp::fold(ArrayRef operands) { return foldReshapeOp(*this, operands); } OpFoldResult CollapseShapeOp::fold(ArrayRef operands) { return foldReshapeOp(*this, operands); } //===----------------------------------------------------------------------===// // ExtractSliceOp //===----------------------------------------------------------------------===// void ExtractSliceOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "extracted_slice"); } /// An extract_slice result type can be inferred, when it is not /// rank-reduced, from the source type and the static representation of /// offsets, sizes and strides. Special sentinels encode the dynamic case. RankedTensorType ExtractSliceOp::inferResultType( ShapedType sourceShapedTensorType, ArrayRef staticOffsets, ArrayRef staticSizes, ArrayRef staticStrides) { // An extract_slice op may specify only a leading subset of offset/sizes/ // strides in which case we complete with offset=0, sizes from memref type // and strides=1. assert(static_cast(staticSizes.size()) == sourceShapedTensorType.getRank() && "unexpected staticSizes not equal to rank of source"); return RankedTensorType::get(staticSizes, sourceShapedTensorType.getElementType()); } RankedTensorType ExtractSliceOp::inferResultType( ShapedType sourceShapedTensorType, ArrayRef offsets, ArrayRef sizes, ArrayRef strides) { SmallVector staticOffsets, staticSizes, staticStrides; SmallVector dynamicOffsets, dynamicSizes, dynamicStrides; dispatchIndexOpFoldResults(offsets, dynamicOffsets, staticOffsets); dispatchIndexOpFoldResults(sizes, dynamicSizes, staticSizes); dispatchIndexOpFoldResults(strides, dynamicStrides, staticStrides); return ExtractSliceOp::inferResultType(sourceShapedTensorType, staticOffsets, staticSizes, staticStrides); } /// If the rank is reduced (i.e. the desiredResultRank is smaller than the /// number of sizes), drop as many size 1 as needed to produce an inferred /// type with the desired rank. /// /// Note that there may be multiple ways to compute this rank-reduced type: /// e.g. 1x6x1 can rank-reduce to either 1x6 or 6x1 2-D tensors. /// /// To disambiguate, this function always drops the first 1 sizes occurrences. RankedTensorType ExtractSliceOp::inferCanonicalRankReducedResultType( unsigned desiredResultRank, RankedTensorType sourceRankedTensorType, ArrayRef offsets, ArrayRef sizes, ArrayRef strides) { // Type inferred in the absence of rank-reducing behavior. auto inferredType = inferResultType(sourceRankedTensorType, offsets, sizes, strides) .cast(); int rankDiff = inferredType.getRank() - desiredResultRank; if (rankDiff > 0) { auto shape = inferredType.getShape(); llvm::SmallBitVector dimsToProject = getPositionsOfShapeOne(rankDiff, shape); SmallVector projectedShape; // Best effort rank-reducing: drop 1s in order. for (unsigned pos = 0, e = shape.size(); pos < e; ++pos) if (!dimsToProject.test(pos)) projectedShape.push_back(shape[pos]); inferredType = RankedTensorType::get(projectedShape, inferredType.getElementType()); } return inferredType; } RankedTensorType ExtractSliceOp::inferCanonicalRankReducedResultType( unsigned desiredResultRank, RankedTensorType sourceRankedTensorType, ArrayRef offsets, ArrayRef sizes, ArrayRef strides) { SmallVector staticOffsets, staticSizes, staticStrides; SmallVector dynamicOffsets, dynamicSizes, dynamicStrides; dispatchIndexOpFoldResults(offsets, dynamicOffsets, staticOffsets); dispatchIndexOpFoldResults(sizes, dynamicSizes, staticSizes); dispatchIndexOpFoldResults(strides, dynamicStrides, staticStrides); return ExtractSliceOp::inferCanonicalRankReducedResultType( desiredResultRank, sourceRankedTensorType, staticOffsets, staticSizes, staticStrides); } /// Build an ExtractSliceOp with mixed static and dynamic entries and custom /// result type. If the type passed is nullptr, it is inferred. void ExtractSliceOp::build(OpBuilder &b, OperationState &result, RankedTensorType resultType, Value source, ArrayRef offsets, ArrayRef sizes, ArrayRef strides, ArrayRef attrs) { SmallVector staticOffsets, staticSizes, staticStrides; SmallVector dynamicOffsets, dynamicSizes, dynamicStrides; dispatchIndexOpFoldResults(offsets, dynamicOffsets, staticOffsets); dispatchIndexOpFoldResults(sizes, dynamicSizes, staticSizes); dispatchIndexOpFoldResults(strides, dynamicStrides, staticStrides); auto sourceRankedTensorType = source.getType().cast(); // Structuring implementation this way avoids duplication between builders. if (!resultType) { resultType = ExtractSliceOp::inferResultType(sourceRankedTensorType, staticOffsets, staticSizes, staticStrides) .cast(); } build(b, result, resultType, source, dynamicOffsets, dynamicSizes, dynamicStrides, b.getDenseI64ArrayAttr(staticOffsets), b.getDenseI64ArrayAttr(staticSizes), b.getDenseI64ArrayAttr(staticStrides)); result.addAttributes(attrs); } /// Build an ExtractSliceOp with mixed static and dynamic entries and inferred /// result type. void ExtractSliceOp::build(OpBuilder &b, OperationState &result, Value source, ArrayRef offsets, ArrayRef sizes, ArrayRef strides, ArrayRef attrs) { build(b, result, RankedTensorType(), source, offsets, sizes, strides, attrs); } /// Build an ExtractSliceOp with mixed static and dynamic entries packed into /// a Range vector. void ExtractSliceOp::build(OpBuilder &b, OperationState &result, Value source, ArrayRef ranges, ArrayRef attrs) { auto [offsets, sizes, strides] = getOffsetsSizesAndStrides(ranges); build(b, result, RankedTensorType(), source, offsets, sizes, strides, attrs); } /// Build an ExtractSliceOp with dynamic entries and custom result type. If /// the type passed is nullptr, it is inferred. void ExtractSliceOp::build(OpBuilder &b, OperationState &result, RankedTensorType resultType, Value source, ValueRange offsets, ValueRange sizes, ValueRange strides, ArrayRef attrs) { SmallVector offsetValues = llvm::to_vector<4>( llvm::map_range(offsets, [](Value v) -> OpFoldResult { return v; })); SmallVector sizeValues = llvm::to_vector<4>( llvm::map_range(sizes, [](Value v) -> OpFoldResult { return v; })); SmallVector strideValues = llvm::to_vector<4>( llvm::map_range(strides, [](Value v) -> OpFoldResult { return v; })); build(b, result, resultType, source, offsetValues, sizeValues, strideValues); } /// Build an ExtractSliceOp with dynamic entries and inferred result type. void ExtractSliceOp::build(OpBuilder &b, OperationState &result, Value source, ValueRange offsets, ValueRange sizes, ValueRange strides, ArrayRef attrs) { build(b, result, RankedTensorType(), source, offsets, sizes, strides, attrs); } template static LogicalResult produceSliceErrorMsg(SliceVerificationResult result, OpTy op, Type expectedType) { auto memrefType = expectedType.cast(); switch (result) { case SliceVerificationResult::Success: return success(); case SliceVerificationResult::RankTooLarge: return op.emitError("expected rank to be smaller or equal to ") << "the other rank. "; case SliceVerificationResult::SizeMismatch: return op.emitError("expected type to be ") << expectedType << " or a rank-reduced version. (size mismatch) "; case SliceVerificationResult::ElemTypeMismatch: return op.emitError("expected element type to be ") << memrefType.getElementType(); default: llvm_unreachable("unexpected extract_slice op verification result"); } } /// Verifier for ExtractSliceOp. LogicalResult ExtractSliceOp::verify() { // Verify result type against inferred type. RankedTensorType expectedType = ExtractSliceOp::inferResultType( getSourceType(), getMixedOffsets(), getMixedSizes(), getMixedStrides()); SliceVerificationResult result = isRankReducedType(expectedType, getType()); return produceSliceErrorMsg(result, *this, expectedType); } llvm::SmallBitVector ExtractSliceOp::getDroppedDims() { ArrayRef resultShape = getType().getShape(); SmallVector mixedSizes = getMixedSizes(); llvm::SmallBitVector droppedDims(mixedSizes.size()); unsigned shapePos = 0; for (const auto &size : enumerate(mixedSizes)) { std::optional sizeVal = getConstantIntValue(size.value()); // If the size is not 1, or if the current matched dimension of the result // is the same static shape as the size value (which is 1), then the // dimension is preserved. if (!sizeVal || *sizeVal != 1 || (shapePos < resultShape.size() && resultShape[shapePos] == 1)) { shapePos++; continue; } droppedDims.set(size.index()); } return droppedDims; } FailureOr ExtractSliceOp::rankReduceIfNeeded(OpBuilder &b, Location loc, Value value, ArrayRef desiredShape) { auto sourceTensorType = value.getType().dyn_cast(); assert(sourceTensorType && "not a ranked tensor type"); auto sourceShape = sourceTensorType.getShape(); if (sourceShape.equals(desiredShape)) return value; auto maybeRankReductionMask = mlir::computeRankReductionMask(sourceShape, desiredShape); if (!maybeRankReductionMask) return failure(); return createCanonicalRankReducingExtractSliceOp( b, loc, value, RankedTensorType::Builder(sourceTensorType).setShape(desiredShape)); } LogicalResult ExtractSliceOp::reifyResultShapes( OpBuilder &builder, ReifiedRankedShapedTypeDims &reifiedReturnShapes) { reifiedReturnShapes.resize(1); reifiedReturnShapes[0].reserve(getType().getRank()); SmallVector mixedSizes = getMixedSizes(); llvm::SmallBitVector droppedDims = getDroppedDims(); Location loc = getLoc(); for (const auto &size : enumerate(mixedSizes)) { if (droppedDims.test(size.index())) continue; if (auto attr = size.value().dyn_cast()) { reifiedReturnShapes[0].push_back(builder.create( loc, attr.cast().getInt())); continue; } reifiedReturnShapes[0].push_back(size.value().get()); } return success(); } namespace { /// Pattern to rewrite an extract_slice op with tensor::Cast arguments. /// This essentially pushes memref_cast past its consuming slice when /// `canFoldIntoConsumerOp` is true. /// /// Example: /// ``` /// %0 = tensor.cast %V : tensor<16x16xf32> to tensor /// %1 = tensor.extract_slice %0[0, 0][3, 4][1, 1] : tensor to /// tensor<3x4xf32> /// ``` /// is rewritten into: /// ``` /// %0 = tensor.extract_slice %V[0, 0][3, 4][1, 1] : tensor<16x16xf32> to /// tensor<3x4xf32> %1 = tensor.cast %0: tensor<3x4xf32> to tensor<3x4xf32> /// ``` class ExtractSliceOpCastFolder final : public OpRewritePattern { public: using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(ExtractSliceOp sliceOp, PatternRewriter &rewriter) const override { // Any constant operand, just return to let the constant folder kick in. if (llvm::any_of(sliceOp.getOperands(), [](Value operand) { return matchPattern(operand, matchConstantIndex()); })) return failure(); auto castOp = sliceOp.getSource().getDefiningOp(); if (!castOp) return failure(); if (!canFoldIntoConsumerOp(castOp)) return failure(); /// Deduce the type of the result to use for the canonicalized operation. RankedTensorType resultType = ExtractSliceOp::inferCanonicalRankReducedResultType( sliceOp.getType().getRank(), sliceOp.getSourceType(), sliceOp.getMixedOffsets(), sliceOp.getMixedSizes(), sliceOp.getMixedStrides()); Value newSlice = rewriter.create( sliceOp.getLoc(), resultType, castOp.getSource(), sliceOp.getOffsets(), sliceOp.getSizes(), sliceOp.getStrides(), sliceOp.getStaticOffsets(), sliceOp.getStaticSizes(), sliceOp.getStaticStrides()); rewriter.replaceOpWithNewOp(sliceOp, sliceOp.getType(), newSlice); return success(); } }; /// Slice elements from `values` into `outValues`. `counts` represents the /// numbers of elements to stride in the original values for each dimension. /// The output values can be used to construct a DenseElementsAttr. template static void sliceElements(IterTy values, ArrayRef counts, ArrayRef offsets, ArrayRef sizes, ArrayRef strides, llvm::SmallVectorImpl *outValues) { assert(offsets.size() == sizes.size()); assert(offsets.size() == strides.size()); if (offsets.empty()) return; int64_t offset = offsets.front(); int64_t size = sizes.front(); int64_t stride = strides.front(); if (offsets.size() == 1) { for (int64_t i = 0; i < size; ++i, offset += stride) outValues->push_back(*(values + offset)); return; } for (int64_t i = 0; i < size; ++i, offset += stride) { auto begin = values + offset * counts.front(); sliceElements(begin, counts.drop_front(), offsets.drop_front(), sizes.drop_front(), strides.drop_front(), outValues); } } /// Fold arith.constant and tensor.extract_slice into arith.constant. The /// folded operation might introduce more constant data; Users can control /// their heuristics by the control function. class ConstantOpExtractSliceFolder final : public OpRewritePattern { public: using OpRewritePattern::OpRewritePattern; ConstantOpExtractSliceFolder(MLIRContext *context, ControlConstantExtractSliceFusionFn controlFn) : OpRewritePattern(context), controlFn(std::move(controlFn)) {} LogicalResult matchAndRewrite(ExtractSliceOp op, PatternRewriter &rewriter) const override { DenseElementsAttr attr; if (!matchPattern(op.getSource(), m_Constant(&attr))) return failure(); // A constant splat is handled by fold(). if (attr.isSplat()) return failure(); // Dynamic result shape is not supported. auto sourceType = op.getSource().getType().cast(); auto resultType = op.getResult().getType().cast(); if (!sourceType.hasStaticShape() || !resultType.hasStaticShape()) return failure(); // Customized control over the folding. if (!controlFn(op)) return failure(); int64_t count = sourceType.getNumElements(); if (count == 0) return failure(); // Check if there are any dynamic parts, which are not supported. auto offsets = op.getStaticOffsets(); if (llvm::is_contained(offsets, ShapedType::kDynamic)) return failure(); auto sizes = op.getStaticSizes(); if (llvm::is_contained(sizes, ShapedType::kDynamic)) return failure(); auto strides = op.getStaticStrides(); if (llvm::is_contained(strides, ShapedType::kDynamic)) return failure(); // Compute the stride for each dimension. SmallVector counts; ArrayRef shape = sourceType.getShape(); counts.reserve(shape.size()); for (int64_t v : shape) { count = count / v; counts.push_back(count); } // New attribute constructed by the sliced values. DenseElementsAttr newAttr; if (auto elems = attr.dyn_cast()) { SmallVector outValues; outValues.reserve(sourceType.getNumElements()); sliceElements( elems.begin(), counts, offsets, sizes, strides, &outValues); newAttr = DenseElementsAttr::get(resultType, outValues); } else if (auto elems = attr.dyn_cast()) { SmallVector outValues; outValues.reserve(sourceType.getNumElements()); sliceElements( elems.begin(), counts, offsets, sizes, strides, &outValues); newAttr = DenseElementsAttr::get(resultType, outValues); } if (newAttr) { rewriter.replaceOpWithNewOp(op, resultType, newAttr); return success(); } return failure(); } private: /// This additionally controls whether the fold happens or not. Users can /// impose their heuristics in the function. ControlConstantExtractSliceFusionFn controlFn; }; } // namespace void mlir::tensor::populateFoldConstantExtractSlicePatterns( RewritePatternSet &patterns, const ControlConstantExtractSliceFusionFn &controlFn) { patterns.add(patterns.getContext(), controlFn); } /// Return the canonical type of the result of an extract_slice op. struct SliceReturnTypeCanonicalizer { RankedTensorType operator()(ExtractSliceOp op, ArrayRef mixedOffsets, ArrayRef mixedSizes, ArrayRef mixedStrides) { return ExtractSliceOp::inferCanonicalRankReducedResultType( op.getType().getRank(), op.getSourceType(), mixedOffsets, mixedSizes, mixedStrides); } }; /// A canonicalizer wrapper to replace ExtractSliceOps. struct SliceCanonicalizer { void operator()(PatternRewriter &rewriter, ExtractSliceOp op, ExtractSliceOp newOp) { Value replacement = newOp.getResult(); if (replacement.getType() != op.getType()) replacement = rewriter.create(op.getLoc(), op.getType(), replacement); rewriter.replaceOp(op, replacement); } }; void ExtractSliceOp::getCanonicalizationPatterns(RewritePatternSet &results, MLIRContext *context) { results.add< OpWithOffsetSizesAndStridesConstantArgumentFolder< ExtractSliceOp, SliceReturnTypeCanonicalizer, SliceCanonicalizer>, ExtractSliceOpCastFolder>(context); } // static LogicalResult foldIdentityOffsetSizeAndStrideOpInterface(OffsetSizeAndStrideOpInterface op, ShapedType shapedType) { OpBuilder b(op.getContext()); for (OpFoldResult ofr : op.getMixedOffsets()) if (getConstantIntValue(ofr) != static_cast(0)) return failure(); // Rank-reducing noops only need to inspect the leading dimensions: // llvm::zip is appropriate. auto shape = shapedType.getShape(); for (auto it : llvm::zip(op.getMixedSizes(), shape)) if (getConstantIntValue(std::get<0>(it)) != std::get<1>(it)) return failure(); for (OpFoldResult ofr : op.getMixedStrides()) if (getConstantIntValue(ofr) != static_cast(1)) return failure(); return success(); } /// If we have an ExtractSliceOp consuming an InsertSliceOp with the same /// slice, we can return the InsertSliceOp's source directly. // TODO: This only checks the immediate producer; extend to go up the // insert/extract chain if the slices are disjoint. static Value foldExtractAfterInsertSlice(ExtractSliceOp extractOp) { auto insertOp = extractOp.getSource().getDefiningOp(); auto isSame = [](OpFoldResult a, OpFoldResult b) { return a == b; }; if (insertOp && insertOp.getSource().getType() == extractOp.getType() && insertOp.isSameAs(extractOp, isSame)) return insertOp.getSource(); return {}; } OpFoldResult ExtractSliceOp::fold(ArrayRef operands) { if (auto splat = operands[0].dyn_cast_or_null()) { auto resultType = getResult().getType().cast(); if (resultType.hasStaticShape()) return splat.resizeSplat(resultType); } if (getSourceType() == getType() && succeeded(foldIdentityOffsetSizeAndStrideOpInterface(*this, getType()))) return this->getSource(); if (Value slice = foldExtractAfterInsertSlice(*this)) return slice; return OpFoldResult(); } Value mlir::tensor::createCanonicalRankReducingExtractSliceOp( OpBuilder &b, Location loc, Value tensor, RankedTensorType targetType) { auto rankedTensorType = tensor.getType().cast(); unsigned rank = rankedTensorType.getRank(); SmallVector offsets(rank, b.getIndexAttr(0)); SmallVector sizes = getMixedSizes(b, loc, tensor); SmallVector strides(rank, b.getIndexAttr(1)); return b.createOrFold(loc, targetType, tensor, offsets, sizes, strides); } //===----------------------------------------------------------------------===// // InsertSliceOp //===----------------------------------------------------------------------===// void InsertSliceOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "inserted_slice"); } // Build a InsertSliceOp with mixed static and dynamic entries. void InsertSliceOp::build(OpBuilder &b, OperationState &result, Value source, Value dest, ArrayRef offsets, ArrayRef sizes, ArrayRef strides, ArrayRef attrs) { SmallVector staticOffsets, staticSizes, staticStrides; SmallVector dynamicOffsets, dynamicSizes, dynamicStrides; dispatchIndexOpFoldResults(offsets, dynamicOffsets, staticOffsets); dispatchIndexOpFoldResults(sizes, dynamicSizes, staticSizes); dispatchIndexOpFoldResults(strides, dynamicStrides, staticStrides); build(b, result, dest.getType(), source, dest, dynamicOffsets, dynamicSizes, dynamicStrides, b.getDenseI64ArrayAttr(staticOffsets), b.getDenseI64ArrayAttr(staticSizes), b.getDenseI64ArrayAttr(staticStrides)); result.addAttributes(attrs); } /// Build an InsertSliceOp with mixed static and dynamic entries packed into a /// Range vector. void InsertSliceOp::build(OpBuilder &b, OperationState &result, Value source, Value dest, ArrayRef ranges, ArrayRef attrs) { auto [offsets, sizes, strides] = getOffsetsSizesAndStrides(ranges); build(b, result, source, dest, offsets, sizes, strides, attrs); } // Build a InsertSliceOp with dynamic entries. void InsertSliceOp::build(OpBuilder &b, OperationState &result, Value source, Value dest, ValueRange offsets, ValueRange sizes, ValueRange strides, ArrayRef attrs) { SmallVector offsetValues = llvm::to_vector<4>( llvm::map_range(offsets, [](Value v) -> OpFoldResult { return v; })); SmallVector sizeValues = llvm::to_vector<4>( llvm::map_range(sizes, [](Value v) -> OpFoldResult { return v; })); SmallVector strideValues = llvm::to_vector<4>( llvm::map_range(strides, [](Value v) -> OpFoldResult { return v; })); build(b, result, source, dest, offsetValues, sizeValues, strideValues); } /// Rank-reducing type verification for both InsertSliceOp and /// ParallelInsertSliceOp. static SliceVerificationResult verifyInsertSliceOp( ShapedType srcType, ShapedType dstType, ArrayRef staticOffsets, ArrayRef staticSizes, ArrayRef staticStrides, ShapedType *expectedType = nullptr) { // insert_slice is the inverse of extract_slice, use the same type // inference. RankedTensorType expected = ExtractSliceOp::inferResultType( dstType, staticOffsets, staticSizes, staticStrides); if (expectedType) *expectedType = expected; return isRankReducedType(expected, srcType); } /// Verifier for InsertSliceOp. LogicalResult InsertSliceOp::verify() { ShapedType expectedType; SliceVerificationResult result = verifyInsertSliceOp(getSourceType(), getType(), getStaticOffsets(), getStaticSizes(), getStaticStrides(), &expectedType); return produceSliceErrorMsg(result, *this, expectedType); } /// If we have two consecutive InsertSliceOp writing to the same slice, we /// can mutate the second InsertSliceOp's destination to the first one's. /// /// Example: /// /// ```mlir /// %0 = tensor.insert_slice %slice0 into %input[0, 0] [64, 64] [1, 1] /// %1 = tensor.insert_slice %slice1 into %0[0, 0] [64, 64] [1, 1] /// ``` /// /// folds into: /// /// ```mlir /// %1 = tensor.insert_slice %slice1 into %input[0, 0] [64, 64] [1, 1] /// ``` /// /// This pattern works with both InsertSliceOp and ParallelInsertSliceOp. static LogicalResult foldInsertAfterInsertSlice(InsertSliceOp insertOp) { auto prevInsertOp = insertOp.getDest().getDefiningOp(); auto isSame = [](OpFoldResult a, OpFoldResult b) { return a == b; }; if (!prevInsertOp || prevInsertOp.getSource().getType() != insertOp.getSource().getType() || !prevInsertOp.isSameAs(insertOp, isSame)) return failure(); insertOp.getDestMutable().assign(prevInsertOp.getDest()); return success(); } /// Folds round-trip extract/insert slice op pairs. /// Example: /// ```mlir /// %0 = tensor.extract_slice %val[0, 0, 0, 0] [1, 1, 2, 4] [1, 1, 1, 1] /// %1 = tensor.insert_slice %0 into %val[0, 0, 0, 0] [1, 1, 2, 4] [1, 1, 1, 1] /// ``` /// can be folded into %val. static Value foldInsertAfterExtractSlice(InsertSliceOp insertOp) { auto extractOp = insertOp.getSource().getDefiningOp(); auto isSame = [](OpFoldResult a, OpFoldResult b) { return a == b; }; if (!extractOp || extractOp.getSource() != insertOp.getDest() || !extractOp.isSameAs(insertOp, isSame)) return nullptr; return extractOp.getSource(); } OpFoldResult InsertSliceOp::fold(ArrayRef) { if (getSourceType().hasStaticShape() && getType().hasStaticShape() && getSourceType() == getType() && succeeded(foldIdentityOffsetSizeAndStrideOpInterface(*this, getType()))) return this->getSource(); if (succeeded(foldInsertAfterInsertSlice(*this))) return getResult(); if (auto result = foldInsertAfterExtractSlice(*this)) return result; return OpFoldResult(); } LogicalResult InsertSliceOp::reifyResultShapes( OpBuilder &builder, ReifiedRankedShapedTypeDims &reifiedReturnShapes) { reifiedReturnShapes.resize(1, SmallVector(getType().getRank())); for (auto dim : llvm::seq(0, getType().getRank())) { reifiedReturnShapes[0][dim] = builder.createOrFold(getLoc(), getDest(), dim); } return success(); } namespace { /// Pattern to rewrite a insert_slice op with constant arguments. /// /// This pattern works with both InsertSliceOp and ParallelInsertSliceOp. template class InsertSliceOpConstantArgumentFolder final : public OpRewritePattern { public: using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(InsertOpTy insertSliceOp, PatternRewriter &rewriter) const override { // No constant operand, just return. if (llvm::none_of(insertSliceOp.getOperands(), [](Value operand) { return matchPattern(operand, matchConstantIndex()); })) return failure(); // At least one of offsets/sizes/strides is a new constant. // Form the new list of operands and constant attributes from the // existing. SmallVector mixedOffsets(insertSliceOp.getMixedOffsets()); SmallVector mixedSizes(insertSliceOp.getMixedSizes()); SmallVector mixedStrides(insertSliceOp.getMixedStrides()); canonicalizeSubViewPart(mixedOffsets, ShapedType::isDynamic); canonicalizeSubViewPart(mixedSizes, ShapedType::isDynamic); canonicalizeSubViewPart(mixedStrides, ShapedType::isDynamic); // Create the new op in canonical form. auto sourceType = ExtractSliceOp::inferCanonicalRankReducedResultType( insertSliceOp.getSourceType().getRank(), insertSliceOp.getDestType(), mixedOffsets, mixedSizes, mixedStrides); Value toInsert = insertSliceOp.getSource(); if (sourceType != insertSliceOp.getSourceType()) { OpBuilder::InsertionGuard g(rewriter); // The only difference between InsertSliceOp and ParallelInsertSliceOp // is the the insertion point is just before the ParallelCombiningOp in // the parallel case. if (std::is_same::value) rewriter.setInsertionPoint(insertSliceOp->getParentOp()); toInsert = rewriter.create(insertSliceOp.getLoc(), sourceType, toInsert); } rewriter.replaceOpWithNewOp( insertSliceOp, toInsert, insertSliceOp.getDest(), mixedOffsets, mixedSizes, mixedStrides); return success(); } }; /// Fold tensor_casts with insert_slice operations. If the source or /// destination tensor is a tensor_cast that removes static type information, /// the cast is folded into the insert_slice operation. E.g.: /// /// ```mlir /// %1 = tensor.cast %0 : tensor<8x16xf32> to tensor /// %2 = tensor.insert_slice %1 into ... : tensor into ... /// ``` /// /// folds into: /// /// ```mlir /// %2 = tensor.insert_slice %0 into ... : tensor<8x16xf32> into ... /// ``` /// /// Note: When folding a cast on the destination tensor, the result of the /// insert_slice operation is casted to ensure that the type of the result did /// not change. /// /// This pattern works with both InsertSliceOp and ParallelInsertSliceOp. template struct InsertSliceOpCastFolder final : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(InsertOpTy insertSliceOp, PatternRewriter &rewriter) const override { if (llvm::any_of(insertSliceOp.getOperands(), [](Value operand) { return matchPattern(operand, matchConstantIndex()); })) return failure(); auto getSourceOfCastOp = [](Value v) -> std::optional { auto castOp = v.getDefiningOp(); if (!castOp || !canFoldIntoConsumerOp(castOp)) return std::nullopt; return castOp.getSource(); }; std::optional sourceCastSource = getSourceOfCastOp(insertSliceOp.getSource()); std::optional destCastSource = getSourceOfCastOp(insertSliceOp.getDest()); if (!sourceCastSource && !destCastSource) return failure(); auto src = (sourceCastSource ? *sourceCastSource : insertSliceOp.getSource()); auto dst = (destCastSource ? *destCastSource : insertSliceOp.getDest()); auto srcType = src.getType().template cast(); auto dstType = dst.getType().template cast(); if (verifyInsertSliceOp(srcType, dstType, insertSliceOp.getStaticOffsets(), insertSliceOp.getStaticSizes(), insertSliceOp.getStaticStrides()) != SliceVerificationResult::Success) return failure(); Operation *replacement = rewriter.create( insertSliceOp.getLoc(), src, dst, insertSliceOp.getMixedOffsets(), insertSliceOp.getMixedSizes(), insertSliceOp.getMixedStrides()); // In the parallel case there is no result and so nothing to cast. bool isParallelInsert = std::is_same::value; if (!isParallelInsert && dst.getType() != insertSliceOp.getDestType()) { replacement = rewriter.create(insertSliceOp.getLoc(), insertSliceOp.getDestType(), replacement->getResult(0)); } rewriter.replaceOp(insertSliceOp, replacement->getResults()); return success(); } }; /// If additional static type information can be deduced from a insert_slice's /// size operands, insert an explicit cast of the op's source operand. This /// enables other canonicalization patterns that are matching for tensor_cast /// ops such as `ForOpTensorCastFolder` in SCF. /// /// Example: /// /// ```mlir /// %r = tensor.insert_slice %0 into %1[...] [64, 64] [1, 1] /// : tensor into ... /// ``` /// /// folds into: /// /// ```mlir /// %tmp = tensor.cast %0 : tensor to tensor<64x64xf32> /// %r = tensor.insert_slice %tmp into %1[...] [64, 64] [1, 1] /// : tensor<64x64xf32> into ... /// ``` /// /// This patterns works with both InsertSliceOp and ParallelInsertSliceOp. template struct InsertSliceOpSourceCastInserter final : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(InsertOpTy insertSliceOp, PatternRewriter &rewriter) const override { RankedTensorType srcType = insertSliceOp.getSourceType(); if (srcType.getRank() != insertSliceOp.getDestType().getRank()) return failure(); SmallVector newSrcShape(srcType.getShape().begin(), srcType.getShape().end()); for (int64_t i = 0; i < srcType.getRank(); ++i) { if (std::optional constInt = getConstantIntValue(insertSliceOp.getMixedSizes()[i])) newSrcShape[i] = *constInt; } RankedTensorType newSrcType = RankedTensorType::get(newSrcShape, srcType.getElementType()); if (srcType == newSrcType || !preservesStaticInformation(srcType, newSrcType) || !tensor::CastOp::areCastCompatible(srcType, newSrcType)) return failure(); // newSrcType is: // 1) Different from srcType. // 2) "More static" than srcType. // 3) Cast-compatible with srcType. // Insert the cast. OpBuilder::InsertionGuard g(rewriter); // The only difference between InsertSliceOp and ParallelInsertSliceOp is // the the insertion point is just before the ParallelCombiningOp in the // parallel case. if (std::is_same::value) rewriter.setInsertionPoint(insertSliceOp->getParentOp()); Value cast = rewriter.create( insertSliceOp.getLoc(), newSrcType, insertSliceOp.getSource()); rewriter.replaceOpWithNewOp( insertSliceOp, cast, insertSliceOp.getDest(), insertSliceOp.getMixedOffsets(), insertSliceOp.getMixedSizes(), insertSliceOp.getMixedStrides()); return success(); } }; } // namespace void InsertSliceOp::getCanonicalizationPatterns(RewritePatternSet &results, MLIRContext *context) { results.add, InsertSliceOpCastFolder, InsertSliceOpSourceCastInserter>(context); } Value mlir::tensor::createCanonicalRankReducingInsertSliceOp(OpBuilder &b, Location loc, Value tensor, Value dest) { auto rankedTensorType = dest.getType().cast(); unsigned rank = rankedTensorType.getRank(); SmallVector offsets(rank, b.getIndexAttr(0)); SmallVector sizes = getMixedSizes(b, loc, dest); SmallVector strides(rank, b.getIndexAttr(1)); return b.createOrFold(loc, tensor, dest, offsets, sizes, strides); } //===----------------------------------------------------------------------===// // PadOp //===----------------------------------------------------------------------===// void PadOp::getAsmResultNames(function_ref setNameFn) { setNameFn(getResult(), "padded"); } // TODO: Replace custom directive with AllTypesMatch as soon as it // supports optional types. void printInferType(OpAsmPrinter &printer, Operation *op, Value optOperand, Type typeToInfer, Type typeToInferFrom) {} ParseResult parseInferType(OpAsmParser &parser, std::optional optOperand, Type &typeToInfer, Type typeToInferFrom) { if (optOperand) typeToInfer = typeToInferFrom; return success(); } LogicalResult PadOp::verify() { auto sourceType = getSource().getType().cast(); auto resultType = getResult().getType().cast(); auto expectedType = PadOp::inferResultType(sourceType, getStaticLow(), getStaticHigh()); for (int i = 0, e = sourceType.getRank(); i < e; ++i) { if (resultType.getDimSize(i) == expectedType.getDimSize(i)) continue; if (expectedType.isDynamicDim(i)) continue; return emitError("specified type ") << resultType << " does not match the inferred type " << expectedType; } return success(); } LogicalResult PadOp::verifyRegions() { auto ®ion = getRegion(); unsigned rank = getResult().getType().cast().getRank(); Block &block = region.front(); if (block.getNumArguments() != rank) return emitError("expected the block to have ") << rank << " arguments"; // Note: the number and type of yield values are checked in the YieldOp. for (const auto &en : llvm::enumerate(block.getArgumentTypes())) { if (!en.value().isIndex()) return emitOpError("expected block argument ") << (en.index() + 1) << " to be an index"; } // Ensure that the region yields an element of the right type. auto yieldOp = llvm::cast(block.getTerminator()); if (yieldOp.getValue().getType() != getType().cast().getElementType()) return emitOpError("expected yield type to match shape element type"); return success(); } RankedTensorType PadOp::inferResultType(RankedTensorType sourceType, ArrayRef staticLow, ArrayRef staticHigh, ArrayRef resultShape) { unsigned rank = sourceType.getRank(); assert(staticLow.size() == rank && "unexpected staticLow size mismatch"); assert(staticHigh.size() == rank && "unexpected staticHigh size mismatch"); assert((resultShape.empty() || resultShape.size() == rank) && "unexpected resultShape size mismatch"); SmallVector inferredShape; for (auto i : llvm::seq(0, rank)) { if (sourceType.isDynamicDim(i) || staticLow[i] == ShapedType::kDynamic || staticHigh[i] == ShapedType::kDynamic) { inferredShape.push_back(resultShape.empty() ? ShapedType::kDynamic : resultShape[i]); } else { int64_t size = sourceType.getDimSize(i) + staticLow[i] + staticHigh[i]; assert((resultShape.empty() || size == resultShape[i] || resultShape[i] == ShapedType::kDynamic) && "mismatch between inferred shape and result shape"); inferredShape.push_back(size); } } return RankedTensorType::get(inferredShape, sourceType.getElementType()); } void PadOp::build(OpBuilder &b, OperationState &result, Value source, ArrayRef staticLow, ArrayRef staticHigh, ValueRange low, ValueRange high, bool nofold, ArrayRef attrs) { auto sourceType = source.getType().cast(); auto resultType = inferResultType(sourceType, staticLow, staticHigh); build(b, result, resultType, source, low, high, b.getDenseI64ArrayAttr(staticLow), b.getDenseI64ArrayAttr(staticHigh), nofold ? b.getUnitAttr() : UnitAttr()); result.addAttributes(attrs); } void PadOp::build(OpBuilder &b, OperationState &result, Value source, ValueRange low, ValueRange high, bool nofold, ArrayRef attrs) { auto sourceType = source.getType().cast(); unsigned rank = sourceType.getRank(); SmallVector staticVector(rank, ShapedType::kDynamic); build(b, result, source, staticVector, staticVector, low, high, nofold, attrs); } void PadOp::build(OpBuilder &b, OperationState &result, Type resultType, Value source, ArrayRef low, ArrayRef high, bool nofold, ArrayRef attrs) { auto sourceType = source.getType().cast(); SmallVector dynamicLow, dynamicHigh; SmallVector staticLow, staticHigh; // staticLow and staticHigh have full information of the padding config. // This will grow staticLow and staticHigh with 1 value. If the config is // dynamic (ie not a constant), dynamicLow and dynamicHigh will grow with 1 // value as well. dispatchIndexOpFoldResults(low, dynamicLow, staticLow); dispatchIndexOpFoldResults(high, dynamicHigh, staticHigh); if (!resultType) { resultType = PadOp::inferResultType(sourceType, staticLow, staticHigh); } assert(resultType.isa()); build(b, result, resultType, source, dynamicLow, dynamicHigh, b.getDenseI64ArrayAttr(staticLow), b.getDenseI64ArrayAttr(staticHigh), nofold ? b.getUnitAttr() : UnitAttr()); result.addAttributes(attrs); } void PadOp::build(OpBuilder &b, OperationState &result, Type resultType, Value source, ArrayRef low, ArrayRef high, Value constantPadValue, bool nofold, ArrayRef attrs) { build(b, result, resultType, source, low, high, nofold, attrs); // Add a region and a block to yield the pad value. Region *region = result.regions[0].get(); int sourceRank = source.getType().cast().getRank(); SmallVector blockArgTypes(sourceRank, b.getIndexType()); SmallVector blockArgLocs(sourceRank, result.location); // `builder.createBlock` changes the insertion point within the block. Create // a guard to reset the insertion point of the builder after it is destroyed. OpBuilder::InsertionGuard guard(b); b.createBlock(region, region->end(), blockArgTypes, blockArgLocs); b.create(result.location, constantPadValue); } llvm::SmallBitVector PadOp::getPaddedDims() { llvm::SmallBitVector paddedDims(getSourceType().getRank()); auto extractPaddedDims = [&](ArrayRef paddingWidths) { for (const auto &en : enumerate(paddingWidths)) if (getConstantIntValue(en.value()) != static_cast(0)) paddedDims.set(en.index()); }; extractPaddedDims(getMixedLowPad()); extractPaddedDims(getMixedHighPad()); return paddedDims; } namespace { // Folds tensor.pad when padding is static zeros and the attribute // doesn't request otherwise. struct FoldStaticZeroPadding : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(PadOp padTensorOp, PatternRewriter &rewriter) const override { if (!padTensorOp.hasZeroLowPad() || !padTensorOp.hasZeroHighPad()) return failure(); if (padTensorOp.getNofold()) return failure(); rewriter.replaceOpWithNewOp( padTensorOp, padTensorOp.getResult().getType(), padTensorOp.getSource()); return success(); } }; // Fold CastOp into PadOp when adding static information. struct FoldSourceTensorCast : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(PadOp padTensorOp, PatternRewriter &rewriter) const override { auto castOp = padTensorOp.getSource().getDefiningOp(); if (!tensor::canFoldIntoConsumerOp(castOp)) return failure(); auto newResultType = PadOp::inferResultType( castOp.getSource().getType().cast(), padTensorOp.getStaticLow(), padTensorOp.getStaticHigh(), padTensorOp.getResultType().getShape()); if (newResultType == padTensorOp.getResultType()) { rewriter.updateRootInPlace(padTensorOp, [&]() { padTensorOp.getSourceMutable().assign(castOp.getSource()); }); } else { auto newOp = rewriter.create( padTensorOp->getLoc(), newResultType, padTensorOp.getSource(), padTensorOp.getLow(), padTensorOp.getHigh(), padTensorOp.getStaticLow(), padTensorOp.getStaticHigh(), padTensorOp.getNofold()); BlockAndValueMapping mapper; padTensorOp.getRegion().cloneInto(&newOp.getRegion(), mapper); rewriter.replaceOpWithNewOp( padTensorOp, padTensorOp.getResultType(), newOp); } return success(); } }; // Fold CastOp using the result of PadOp back into the latter if it adds // static information. struct FoldTargetTensorCast : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(PadOp padTensorOp, PatternRewriter &rewriter) const override { if (!padTensorOp.getResult().hasOneUse()) return failure(); auto tensorCastOp = dyn_cast(*padTensorOp->getUsers().begin()); if (!tensorCastOp) return failure(); if (!tensor::preservesStaticInformation(padTensorOp.getResult().getType(), tensorCastOp.getDest().getType())) return failure(); auto replacementOp = rewriter.create( padTensorOp.getLoc(), tensorCastOp.getDest().getType(), padTensorOp.getSource(), padTensorOp.getLow(), padTensorOp.getHigh(), padTensorOp.getStaticLow(), padTensorOp.getStaticHigh(), padTensorOp.getNofold()); replacementOp.getRegion().takeBody(padTensorOp.getRegion()); rewriter.replaceOp(padTensorOp, replacementOp.getResult()); rewriter.replaceOp(tensorCastOp, replacementOp.getResult()); return success(); } }; /// Fold chains of tensor::ExtractSliceOp, tensor::PadOp pairs that pad /// different dimensions. The pattern applies if the following preconditions /// hold: /// 1) the tensor::ExtractSliceOps are not rank-reducing, /// 2) the tensor::ExtractSliceOps have only unit-strides, /// 3) the tensor::PadOps perform only high-padding, /// 4) the tensor::PadOps have the same constant padding value, /// 5) the tensor::PadOps do not have common padding dimensions, /// 6) one tensor::ExtractSliceOp, tensor::PadOp pair has zero-padding and /// zero-offset for every dimension. /// 7) the tensor::ExtractSliceOp sizes match the source tensor sizes for /// the /// padded source dimensions. /// /// Example: /// /// ```mlir /// %0 = tensor.extract_slice %input[16, 0] [%sz0, 64] [1, 1] /// : tensor<64x64xf32> to tensor /// %1 = tensor.pad %0 low[0, 0] high[%pw0, 0] { ... /// } : tensor to tensor<8x64xf32> /// %2 = tensor.extract_slice %1[0, 4] [8, %sz1] [1, 1] /// : tensor<8x64xf32> to tensor<8x?xf32> /// %res = tensor.pad %2 nofold low[0, 0] high[0, %pw1] { ... /// } : tensor<8x?xf32> to tensor<8x4xf32> /// ``` /// /// folds into: /// /// ```mlir /// %0 = tensor.extract_slice %input[16, 4] [%sz0, %sz1] [1, 1] /// : tensor<64x64xf32> to tensor /// %res = tensor.pad %0 nofold low[0, 0] high[%pw0, %pw1] { ... /// } : tensor to tensor<8x4xf32> /// ``` struct FoldOrthogonalPaddings : public OpRewritePattern { using OpRewritePattern::OpRewritePattern; LogicalResult matchAndRewrite(PadOp padOp, PatternRewriter &rewriter) const override { auto innerSliceOp = padOp.getSource().getDefiningOp(); if (!innerSliceOp) return failure(); auto outerPadOp = innerSliceOp.getSource().getDefiningOp(); if (!outerPadOp || outerPadOp.getNofold()) return failure(); auto outerSliceOp = outerPadOp.getSource().getDefiningOp(); if (!outerSliceOp) return failure(); // 1) Fail if the chain is rank-reducing. int64_t rank = padOp.getSourceType().getRank(); if (outerSliceOp.getSourceType().getRank() != rank) { return rewriter.notifyMatchFailure(padOp, "cannot fold rank-reducing chain"); } // 2) Fail if the tensor::ExtractSliceOps have non-unit strides. if (!innerSliceOp.hasUnitStride() || !outerSliceOp.hasUnitStride()) { return rewriter.notifyMatchFailure( padOp, "cannot fold non-unit stride ExtractSliceOps"); } // 3) Fail if the tensor::PadOps have non-zero low padding. if (!padOp.hasZeroLowPad() || !outerPadOp.hasZeroLowPad()) { return rewriter.notifyMatchFailure(padOp, "cannot fold PadOps with low padding"); } // 4) Fail if the tensor::PadOps padding values do not match. Attribute innerAttr, outerAttr; Value innerValue = padOp.getConstantPaddingValue(); Value outerValue = outerPadOp.getConstantPaddingValue(); if (!innerValue || !outerValue || !matchPattern(innerValue, m_Constant(&innerAttr)) || !matchPattern(outerValue, m_Constant(&outerAttr)) || innerAttr != outerAttr) { return rewriter.notifyMatchFailure( padOp, "cannot fold PadOps with different padding values"); } // 5) Fail if a dimension is padded by both tensor::PadOps. llvm::SmallBitVector innerDims = padOp.getPaddedDims(); llvm::SmallBitVector outerDims = outerPadOp.getPaddedDims(); if (innerDims.anyCommon(outerDims)) { return rewriter.notifyMatchFailure( padOp, "cannot fold PadOps with common padding dimensions"); } // 6) Combine the offsets of the two tensor::ExtractSliceOps. Find the // zero-offset and zero-padding tensor::ExtractSliceOp, tensor::PadOp pair // for every dimension, and use the offset the other pair. Fail if no // zero-offset and zero-padding tensor::ExtractSliceOp, tensor::PadOp pair // exists. SmallVector newOffsets(rank, rewriter.getIndexAttr(0)); for (auto &en : enumerate(newOffsets)) { OpFoldResult innerOffset = innerSliceOp.getMixedOffsets()[en.index()]; OpFoldResult outerOffset = outerSliceOp.getMixedOffsets()[en.index()]; if (!innerDims.test(en.index()) && (getConstantIntValue(innerOffset) == static_cast(0))) { en.value() = outerOffset; continue; } if (!outerDims.test(en.index()) && (getConstantIntValue(outerOffset) == static_cast(0))) { en.value() = innerOffset; continue; } return rewriter.notifyMatchFailure( padOp, "cannot find zero-offset and zero-padding pair"); } // 7) Combine the sizes of the two tensor::ExtractSliceOps. Take the size // of the outer tensor::ExtractSliceOp for the dimensions padded by the // outer tensor::PadOp and fail if the size of the inner // tensor::ExtractSliceOp does not match the size of the padded dimension. // Otherwise, take the size of the inner tensor::ExtractSliceOp. SmallVector newSizes = innerSliceOp.getMixedSizes(); for (auto &en : enumerate(newSizes)) { if (!outerDims.test(en.index())) continue; OpFoldResult sliceSize = innerSliceOp.getMixedSizes()[en.index()]; int64_t sourceSize = innerSliceOp.getSourceType().getShape()[en.index()]; assert(!ShapedType::isDynamic(sourceSize) && "expected padded dimension to have a static size"); if (getConstantIntValue(sliceSize) != sourceSize) { return rewriter.notifyMatchFailure( padOp, "cannot fold since the inner ExtractSliceOp size does not " "match the size of the outer padding"); } en.value() = outerSliceOp.getMixedSizes()[en.index()]; } // Combine the high paddings of the two tensor::PadOps. SmallVector newHighPad(rank, rewriter.getIndexAttr(0)); for (auto &en : enumerate(newHighPad)) { if (innerDims.test(en.index())) newHighPad[en.index()] = padOp.getMixedHighPad()[en.index()]; if (outerDims.test(en.index())) newHighPad[en.index()] = outerPadOp.getMixedHighPad()[en.index()]; } // Create a new tensor::ExtractSliceOp, tensor::PadOp pair that performs // the two paddings in one step. auto newSliceOp = rewriter.create( padOp.getLoc(), outerSliceOp.getSource(), newOffsets, newSizes, innerSliceOp.getMixedStrides()); auto newPadOp = rewriter.create( padOp.getLoc(), padOp.getResultType(), newSliceOp.getResult(), padOp.getMixedLowPad(), newHighPad, padOp.getNofold()); rewriter.inlineRegionBefore(padOp.getRegion(), newPadOp.getRegion(), newPadOp.getRegion().begin()); rewriter.replaceOp(padOp, newPadOp.getResult()); return success(); } }; } // namespace void PadOp::getCanonicalizationPatterns(RewritePatternSet &results, MLIRContext *context) { results.add(context); } /// Return the padding value of the PadOp if it constant. In this context, /// "constant" means an actual constant or "defined outside of the block". /// /// Values are considered constant in three cases: /// - A ConstantLike value. /// - A basic block argument from a different block. /// - A value defined outside of the block. /// /// If the padding value is not constant, an empty Value is returned. Value PadOp::getConstantPaddingValue() { auto yieldOp = dyn_cast(getRegion().front().getTerminator()); if (!yieldOp) return {}; Value padValue = yieldOp.getValue(); // Check if yield value is a constant. if (matchPattern(padValue, m_Constant())) return padValue; // Check if yield value is defined inside the PadOp block. if (padValue.getParentBlock() == &getRegion().front()) return {}; // Else: Yield value defined outside of the PadOp block. return padValue; } OpFoldResult PadOp::fold(ArrayRef) { if (getResultType().hasStaticShape() && getResultType() == getSourceType() && !getNofold()) return getSource(); return {}; } //===----------------------------------------------------------------------===// // ParallelInsertSliceOp //===----------------------------------------------------------------------===// OpResult ParallelInsertSliceOp::getTiedOpResult() { ParallelCombiningOpInterface parallelCombiningParent = getParallelCombiningParent(); for (const auto &it : llvm::enumerate(parallelCombiningParent.getYieldingOps())) { Operation &nextOp = it.value(); if (&nextOp == getOperation()) return parallelCombiningParent.getParentResult(it.index()); } llvm_unreachable("ParallelInsertSliceOp no tied OpResult found"); } // Build a ParallelInsertSliceOp with mixed static and dynamic entries. void ParallelInsertSliceOp::build(OpBuilder &b, OperationState &result, Value source, Value dest, ArrayRef offsets, ArrayRef sizes, ArrayRef strides, ArrayRef attrs) { SmallVector staticOffsets, staticSizes, staticStrides; SmallVector dynamicOffsets, dynamicSizes, dynamicStrides; dispatchIndexOpFoldResults(offsets, dynamicOffsets, staticOffsets); dispatchIndexOpFoldResults(sizes, dynamicSizes, staticSizes); dispatchIndexOpFoldResults(strides, dynamicStrides, staticStrides); build(b, result, {}, source, dest, dynamicOffsets, dynamicSizes, dynamicStrides, b.getDenseI64ArrayAttr(staticOffsets), b.getDenseI64ArrayAttr(staticSizes), b.getDenseI64ArrayAttr(staticStrides)); result.addAttributes(attrs); } /// Build an ParallelInsertSliceOp with mixed static and dynamic entries /// packed into a Range vector. void ParallelInsertSliceOp::build(OpBuilder &b, OperationState &result, Value source, Value dest, ArrayRef ranges, ArrayRef attrs) { auto [offsets, sizes, strides] = getOffsetsSizesAndStrides(ranges); build(b, result, source, dest, offsets, sizes, strides, attrs); } // Build a ParallelInsertSliceOp with dynamic entries. void ParallelInsertSliceOp::build(OpBuilder &b, OperationState &result, Value source, Value dest, ValueRange offsets, ValueRange sizes, ValueRange strides, ArrayRef attrs) { SmallVector offsetValues = llvm::to_vector<4>( llvm::map_range(offsets, [](Value v) -> OpFoldResult { return v; })); SmallVector sizeValues = llvm::to_vector<4>( llvm::map_range(sizes, [](Value v) -> OpFoldResult { return v; })); SmallVector strideValues = llvm::to_vector<4>( llvm::map_range(strides, [](Value v) -> OpFoldResult { return v; })); build(b, result, source, dest, offsetValues, sizeValues, strideValues); } LogicalResult ParallelInsertSliceOp::verify() { if (!isa(getOperation()->getParentOp())) return this->emitError("expected ParallelCombiningOpInterface parent, got:") << *(getOperation()->getParentOp()); ShapedType expectedType; SliceVerificationResult result = verifyInsertSliceOp(getSourceType(), getDestType(), getStaticOffsets(), getStaticSizes(), getStaticStrides(), &expectedType); return produceSliceErrorMsg(result, *this, expectedType); } void ParallelInsertSliceOp::getCanonicalizationPatterns( RewritePatternSet &results, MLIRContext *context) { results.add, InsertSliceOpCastFolder, InsertSliceOpSourceCastInserter>(context); } //===----------------------------------------------------------------------===// // ScatterOp //===----------------------------------------------------------------------===// void ScatterOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "scatter"); } LogicalResult ScatterOp::verify() { int64_t destRank = getDestType().getRank(); ArrayRef scatterDims = getScatterDims(); if (failed(verifyGatherOrScatterDims(getOperation(), scatterDims, destRank, "scatter", "dest"))) return failure(); if (!getUnique()) return emitOpError("requires 'unique' attribute to be set"); // TODO: we could also check statically that there are fewer leading index // tensor dims than the dest dims. If this is not the case, the unique // attribute cannot be true. // Use the GatherOp::inferResultType on the `dest` type and verify the // expected type matches the source type. RankedTensorType expectedSourceType = GatherOp::inferResultType( getDestType(), getIndicesType(), scatterDims, /*rankReduced=*/false); RankedTensorType expectedRankReducedSourceType = GatherOp::inferResultType( getDestType(), getIndicesType(), scatterDims, /*rankReduced=*/true); if (getSourceType() != expectedSourceType && getSourceType() != expectedRankReducedSourceType) { return emitOpError("source type " "mismatch: " "expected ") << expectedSourceType << " or its rank-reduced variant " << expectedRankReducedSourceType << " (got: " << getSourceType() << ")"; } return success(); } //===----------------------------------------------------------------------===// // SplatOp //===----------------------------------------------------------------------===// void SplatOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "splat"); } OpFoldResult SplatOp::fold(ArrayRef operands) { auto constOperand = operands.front(); if (!constOperand.isa_and_nonnull()) return {}; // SplatElementsAttr::get treats single value for second arg as being a // splat. return SplatElementsAttr::get(getType(), {constOperand}); } //===----------------------------------------------------------------------===// // PackOp/UnPackOp Common //===----------------------------------------------------------------------===// template static LogicalResult reifyResultShapesImpl(OpTy op, OpBuilder &builder, ReifiedRankedShapedTypeDims &reifiedReturnShapes) { static_assert(llvm::is_one_of::value, "applies to only pack or unpack operations"); int64_t destRank = op.getDestRank(); reifiedReturnShapes.resize(1, SmallVector(destRank)); for (auto dim : llvm::seq(0, destRank)) { reifiedReturnShapes[0][dim] = builder.createOrFold(op.getLoc(), op.getDest(), dim); } return success(); } template static DenseMap getDimAndTileMappingImpl(OpTy op) { static_assert(llvm::is_one_of::value, "applies to only pack or unpack operations"); DenseMap dimAndTileMapping; ArrayRef dimsToTile = op.getInnerDimsPos(); SmallVector tiles = op.getMixedTiles(); assert(tiles.size() == dimsToTile.size() && "tiles must match indices of dimension to block"); // bind the dimension `i` with the tile factor. for (auto i : llvm::seq(0, dimsToTile.size())) dimAndTileMapping[dimsToTile[i]] = tiles[i]; return dimAndTileMapping; } template static SmallVector getMixedTilesImpl(OpTy op) { static_assert(llvm::is_one_of::value, "applies to only pack or unpack operations"); Builder builder(op); SmallVector mixedInnerTiles; unsigned dynamicValIndex = 0; for (int64_t staticTile : op.getStaticInnerTiles()) { if (!ShapedType::isDynamic(staticTile)) mixedInnerTiles.push_back(builder.getI64IntegerAttr(staticTile)); else mixedInnerTiles.push_back(op.getInnerTiles()[dynamicValIndex++]); } return mixedInnerTiles; } template static SmallVector getStaticTilesImpl(OpTy op) { static_assert(llvm::is_one_of::value, "applies to only pack or unpack operations"); SmallVector dynamicTiles; SmallVector staticTiles; dispatchIndexOpFoldResults(op.getMixedTiles(), dynamicTiles, staticTiles); return staticTiles; } /// Returns true if `dimsPos` is invalid. It is invalid when: /// a) It contains duplicate. /// b) At least one dimension is out of bound (`dimPos` is >= 0 and < rank). /// c) The number of elements in `dimsPos` is > than `rank`. static bool isInvalidPackingPosSpecification(ArrayRef dimsPos, size_t rank) { size_t dimsPosSize = dimsPos.size(); if (dimsPosSize > rank) return true; DenseSet uniqued; for (int64_t dim : dimsPos) uniqued.insert(dim); if (dimsPosSize != uniqued.size()) return true; return llvm::any_of(dimsPos, [rank](int64_t dimPos) { return dimPos < 0 || dimPos >= static_cast(rank); }); } /// Returns true if the dimension of `sourceShape` is smaller than the dimension /// of the `limitShape`. static bool areAllInBound(ArrayRef sourceShape, ArrayRef limitShape) { assert( sourceShape.size() == limitShape.size() && "expected source shape rank, and limit of the shape to have same rank"); return llvm::all_of( llvm::zip(sourceShape, limitShape), [](std::tuple it) { int64_t sourceExtent = std::get<0>(it); int64_t limit = std::get<1>(it); return ShapedType::isDynamic(sourceExtent) || ShapedType::isDynamic(limit) || sourceExtent <= limit; }); } template static LogicalResult commonVerifierPackAndUnPackOp(OpTy packOrUnPack) { static_assert(llvm::is_one_of::value, "applies to only pack or unpack operations"); Operation *op = packOrUnPack.getOperation(); // Return true if we have a zero-value tile. auto hasZeros = [&](ArrayRef tiles) { return llvm::any_of( tiles, [](OpFoldResult tile) { return isConstantIntValue(tile, 0); }); }; // Verify tiles. Do not allow zero tiles. SmallVector mixedTiles = packOrUnPack.getMixedTiles(); if (hasZeros(mixedTiles)) return op->emitError("invalid zero tile factor"); // Verify inner_dims_pos and outer_dims_perm. ShapedType unpackedType = (std::is_same::value) ? packOrUnPack.getSourceType() : packOrUnPack.getDestType(); size_t unpackedRank = unpackedType.getRank(); ArrayRef innerDimsPos = packOrUnPack.getInnerDimsPos(); ArrayRef outerDimPerm = packOrUnPack.getOuterDimsPerm(); if (isInvalidPackingPosSpecification(innerDimsPos, unpackedRank)) return op->emitError("invalid inner_dims_pos vector"); if (isInvalidPackingPosSpecification(outerDimPerm, unpackedRank)) return op->emitError("invalid outer_dims_perm vector"); if (!outerDimPerm.empty() && outerDimPerm.size() != unpackedRank) return op->emitError("outer_dims_perm must be a permutation or empty"); // Tiling factors must be less than or equal to the input rank for pack (or // output rank for unpack), and must match the number of `inner_dims_pos`. if (mixedTiles.size() > unpackedRank) { return op->emitError("tiling factors must be less than or equal to the " "input rank for pack or output rank for unpack"); } if (mixedTiles.size() != innerDimsPos.size()) { return op->emitError( "tiling factors must equal the number of dimensions to tile"); } ShapedType packedType = (std::is_same::value) ? packOrUnPack.getDestType() : packOrUnPack.getSourceType(); size_t packedRank = packedType.getRank(); // Require output rank to match input rank + number of blocking factors. if (unpackedRank + mixedTiles.size() != packedRank) { return op->emitError( "packed rank must equal unpacked rank + tiling factors"); } // Verify result shape is greater than the minimum expected // by the pack operation, and that the output shape // represents full tiles. ShapedType expectedPackedType = PackOp::inferPackedType( unpackedType, packOrUnPack.getStaticTiles(), innerDimsPos, outerDimPerm); if (!areAllInBound(expectedPackedType.getShape(), packedType.getShape())) { return op->emitError("the shape of output is not large enough to hold the " "packed data. Expected at least ") << expectedPackedType << ", got " << packedType; } if (!llvm::all_of( llvm::zip(packedType.getShape().take_back(mixedTiles.size()), mixedTiles), [](std::tuple it) { std::optional constTileSize = getConstantIntValue(std::get<1>(it)); int64_t shape = std::get<0>(it); if (!constTileSize) { // If specified tile size is dynamic, output shape should // be dynamic too. return ShapedType::isDynamic(shape); } if (ShapedType::isDynamic(shape)) { // For the shape being dynamic when tile size is // specified, return true. In canonical form a constant // tile size should lead to constant shape of the tiled // dimension, but not needed for verification. return true; } return shape == constTileSize.value(); })) { return op->emitError("mismatch in inner tile sizes specified and shaped of " "tiled dimension in the packed type"); } return success(); } //===----------------------------------------------------------------------===// // PackOp //===----------------------------------------------------------------------===// void PackOp::getAsmResultNames(function_ref setNameFn) { setNameFn(getResult(), "pack"); } void PackOp::build(OpBuilder &builder, OperationState &state, Value source, Value dest, ArrayRef innerDimsPos, ArrayRef innerTiles, Optional paddingValue, ArrayRef outerDimsPerm) { assert(innerDimsPos.size() == innerTiles.size() && "number of tile sizes specified must match the specified number of " "original dimensions to be tiled"); SmallVector staticTileSizes; SmallVector dynamicTileSizes; dispatchIndexOpFoldResults(innerTiles, dynamicTileSizes, staticTileSizes); build(builder, state, dest.getType(), source, dest, paddingValue ? *paddingValue : nullptr, outerDimsPerm.empty() ? nullptr : builder.getDenseI64ArrayAttr(outerDimsPerm), builder.getDenseI64ArrayAttr(innerDimsPos), dynamicTileSizes, builder.getDenseI64ArrayAttr(staticTileSizes)); } LogicalResult PackOp::reifyResultShapes(OpBuilder &builder, ReifiedRankedShapedTypeDims &reifiedReturnShapes) { return reifyResultShapesImpl(*this, builder, reifiedReturnShapes); } DenseMap PackOp::getDimAndTileMapping() { return getDimAndTileMappingImpl(*this); } SmallVector PackOp::getMixedTiles() { return getMixedTilesImpl(*this); } SmallVector PackOp::getStaticTiles() { return getStaticTilesImpl(*this); } /// Check if we have enough static information to catch undefined behavior when /// the tile size does not divide perfectly the dimension of the input tensor. static bool areNotFullTiles(ArrayRef inputShape, DenseMap const &dimAndTileMapping) { int64_t rank = inputShape.size(); for (int64_t dim = 0; dim < rank; dim++) { if (ShapedType::isDynamic(inputShape[dim])) continue; auto it = dimAndTileMapping.find(dim); if (it == dimAndTileMapping.end()) continue; std::optional constantTile = getConstantIntValue(it->second); if (!constantTile) continue; if (inputShape[dim] % (*constantTile) != 0) return true; } return false; } LogicalResult PackOp::verify() { if (failed(commonVerifierPackAndUnPackOp(*this))) return failure(); // Verify padding value, and bail out if the tile does not divide the // dimension fully. In the case of dynamic tile factors or dimensions, having // a partial tile is undefined behavior. auto paddingValue = getPaddingValue(); if (paddingValue && paddingValue.getType() != getSourceType().getElementType()) { return emitOpError("expected padding_value has ") << getSourceType().getElementType() << " but got: " << paddingValue.getType(); } auto dimAndTileMapping = getDimAndTileMapping(); if (!paddingValue && areNotFullTiles(getSourceType().getShape(), dimAndTileMapping)) { return emitOpError("invalid tile factor provided. Only full tiles are " "supported when padding_value is not set"); } return success(); } /// Get the expected packed type based on source type, tile factors, position of /// the inner tiles and permutation of the outer tiled loop. ShapedType PackOp::inferPackedType(ShapedType sourceType, ArrayRef innerTileSizes, ArrayRef innerDimsPos, ArrayRef outerDimsPerm) { SmallVector resultShape = llvm::to_vector(sourceType.getShape()); for (const auto &tiledDim : llvm::enumerate(innerDimsPos)) { if (ShapedType::isDynamic(resultShape[tiledDim.value()])) continue; if (ShapedType::isDynamic(innerTileSizes[tiledDim.index()])) { resultShape[tiledDim.value()] = ShapedType::kDynamic; continue; } resultShape[tiledDim.value()] = ceilDiv(resultShape[tiledDim.value()], innerTileSizes[tiledDim.index()]); } if (!outerDimsPerm.empty()) applyPermutationToVector(resultShape, outerDimsPerm); // Append the inner tile dimensions. resultShape.append(innerTileSizes.begin(), innerTileSizes.end()); return RankedTensorType::get(resultShape, sourceType.getElementType()); } Value PackOp::createDestinationTensor(OpBuilder &b, Location loc, Value source, ArrayRef innerTileSizes, ArrayRef innerDimsPos, ArrayRef outerDimsPerm) { AffineExpr dim0, dim1; bindDims(b.getContext(), dim0, dim1); auto ceilDiv = [&](OpFoldResult v1, OpFoldResult v2) -> OpFoldResult { return makeComposedFoldedAffineApply(b, loc, dim0.ceilDiv(dim1), {v1, v2}); }; SmallVector mixedSizes; for (auto [index, value] : llvm::enumerate(source.getType().cast().getShape())) { if (ShapedType::isDynamic(value)) mixedSizes.push_back(b.create(loc, source, index).getResult()); else mixedSizes.push_back(b.getIndexAttr(value)); } for (auto it : llvm::zip(innerDimsPos, innerTileSizes)) { int64_t dimPos = std::get<0>(it); OpFoldResult tileSize = std::get<1>(it); mixedSizes[dimPos] = ceilDiv(mixedSizes[dimPos], tileSize); } if (!outerDimsPerm.empty()) applyPermutationToVector(mixedSizes, outerDimsPerm); mixedSizes.append(innerTileSizes.begin(), innerTileSizes.end()); auto elemType = source.getType().cast().getElementType(); return b.create(loc, mixedSizes, elemType); } /// Returns true if the tiles and the tiled dims are constant. template bool areTilesAndTiledDimsAllConstant(OpTy op) { static_assert(llvm::is_one_of::value, "applies to only pack or unpack operations"); ShapedType packedType = (std::is_same::value) ? op.getDestType() : op.getSourceType(); SmallVector mixedTiles = op.getMixedTiles(); for (auto [dimDest, tile] : llvm::zip( packedType.getShape().take_back(mixedTiles.size()), mixedTiles)) { std::optional constTileSize = getConstantIntValue(tile); if (!constTileSize || ShapedType::isDynamic(dimDest)) return false; } return true; } Speculation::Speculatability PackOp::getSpeculatability() { if (auto paddingValue = getPaddingValue()) return Speculation::Speculatable; // The verifier rejects already operations if we can statically prove that the // sizes of the tiles do not divide perfectly the dimension; thus, check only // to have constant tiles and tiled inner dimensions. if (!areTilesAndTiledDimsAllConstant(*this)) return Speculation::NotSpeculatable; return Speculation::Speculatable; } //===----------------------------------------------------------------------===// // UnPackOp //===----------------------------------------------------------------------===// void UnPackOp::getAsmResultNames( function_ref setNameFn) { setNameFn(getResult(), "unpack"); } LogicalResult UnPackOp::reifyResultShapes(OpBuilder &builder, ReifiedRankedShapedTypeDims &reifiedReturnShapes) { return reifyResultShapesImpl(*this, builder, reifiedReturnShapes); } DenseMap UnPackOp::getDimAndTileMapping() { return getDimAndTileMappingImpl(*this); } SmallVector UnPackOp::getMixedTiles() { return getMixedTilesImpl(*this); } SmallVector UnPackOp::getStaticTiles() { return getStaticTilesImpl(*this); } LogicalResult UnPackOp::verify() { return commonVerifierPackAndUnPackOp(*this); } Speculation::Speculatability UnPackOp::getSpeculatability() { // See PackOp::getSpeculatability. if (!areTilesAndTiledDimsAllConstant(*this)) return Speculation::NotSpeculatable; return Speculation::Speculatable; } void UnPackOp::build(OpBuilder &builder, OperationState &state, Value source, Value dest, ArrayRef innerDimsPos, ArrayRef innerTiles, ArrayRef outerDimsPerm) { assert(innerDimsPos.size() == innerTiles.size() && "number of tile sizes specified must match the specified number of " "original dimensions to be tiled"); SmallVector staticTileSizes; SmallVector dynamicTileSizes; dispatchIndexOpFoldResults(innerTiles, dynamicTileSizes, staticTileSizes); build(builder, state, dest.getType(), source, dest, outerDimsPerm.empty() ? nullptr : builder.getDenseI64ArrayAttr(outerDimsPerm), builder.getDenseI64ArrayAttr(innerDimsPos), dynamicTileSizes, builder.getDenseI64ArrayAttr(staticTileSizes)); } /// pack(unpack(x)) -> x LogicalResult UnPackOp::canonicalize(UnPackOp unpackOp, PatternRewriter &rewriter) { PackOp packOp = unpackOp.getSource().getDefiningOp(); if (!packOp || packOp.getDestType() != unpackOp.getSourceType()) return failure(); if (packOp.getInnerDimsPos() != unpackOp.getInnerDimsPos()) return failure(); if (packOp.getOuterDimsPerm() != unpackOp.getOuterDimsPerm()) return failure(); rewriter.replaceOp(unpackOp, packOp.getSource()); return success(); } //===----------------------------------------------------------------------===// // Common Canonicalizers and Folders. //===----------------------------------------------------------------------===// /// Folds a tensor.cast op into a consuming DestinationStyleOpInterface op if /// the `tensor.cast` has source that is more static than the consuming op. /// /// Example: /// ```mlir /// %1 = tensor.cast %0 : tensor<8x16xf32> to tensor /// %2 = consumer %1 ... : tensor ... /// ``` /// /// folds into: /// /// ```mlir /// %2 = consumer %0 ... : tensor<8x16xf32> ... /// ``` /// TODO: Move the pattern to a proper place, so all other DestinationStyleOp /// can add the pattern to their canonicalizers. struct FoldTensorCastProducerOp : public OpInterfaceRewritePattern { using OpInterfaceRewritePattern< DestinationStyleOpInterface>::OpInterfaceRewritePattern; LogicalResult matchAndRewrite(DestinationStyleOpInterface op, PatternRewriter &rewriter) const override { // InsertSliceOp has its own logic about folding tensor.cast ops. if (isa(op.getOperation())) return failure(); // If no operand comes from a tensor::CastOp and can be folded then fail. bool hasTensorCastOperand = llvm::any_of(op->getOpOperands(), [&](OpOperand &opOperand) { if (opOperand.get().isa()) return false; auto castOp = opOperand.get().getDefiningOp(); return castOp && canFoldIntoConsumerOp(castOp); }); if (!hasTensorCastOperand) return failure(); SmallVector newResultTypes; newResultTypes.reserve(op->getNumResults()); SmallVector newOperands; newOperands.reserve(op->getNumOperands()); for (OpOperand &opOperand : op->getOpOperands()) { auto tensorCastOp = opOperand.get().getDefiningOp(); bool fold = canFoldIntoConsumerOp(tensorCastOp); newOperands.push_back(fold ? tensorCastOp.getOperand() : opOperand.get()); if (op.isDpsInit(&opOperand) && !newOperands.back().getType().isa()) newResultTypes.push_back(newOperands.back().getType()); } // Clone op. Operation *newOp = clone(rewriter, op, newResultTypes, newOperands); SmallVector replacements; replacements.reserve(newOp->getNumResults()); for (auto [oldResult, newResult] : llvm::zip(op->getResults(), newOp->getResults())) { if (newResult.getType() != oldResult.getType()) { replacements.push_back(rewriter.create( op->getLoc(), oldResult.getType(), newResult)); } else { replacements.push_back(newResult); } } rewriter.replaceOp(op, replacements); return success(); } }; //===----------------------------------------------------------------------===// // TensorDialect //===----------------------------------------------------------------------===// void TensorDialect::getCanonicalizationPatterns( RewritePatternSet &results) const { results.add(getContext()); } //===----------------------------------------------------------------------===// // TableGen'd op method definitions //===----------------------------------------------------------------------===// #define GET_OP_CLASSES #include "mlir/Dialect/Tensor/IR/TensorOps.cpp.inc"