//===- TestVectorToVectorConversion.cpp - Test VectorTransfers lowering ---===// // // 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 #include "mlir/Analysis/SliceAnalysis.h" #include "mlir/Dialect/Affine/IR/AffineOps.h" #include "mlir/Dialect/Linalg/IR/LinalgOps.h" #include "mlir/Dialect/MemRef/IR/MemRef.h" #include "mlir/Dialect/SCF/SCF.h" #include "mlir/Dialect/StandardOps/IR/Ops.h" #include "mlir/Dialect/Vector/VectorOps.h" #include "mlir/Dialect/Vector/VectorTransforms.h" #include "mlir/Pass/Pass.h" #include "mlir/Transforms/GreedyPatternRewriteDriver.h" using namespace mlir; using namespace mlir::vector; namespace { struct TestVectorToVectorConversion : public PassWrapper { TestVectorToVectorConversion() = default; TestVectorToVectorConversion(const TestVectorToVectorConversion &pass) {} StringRef getArgument() const final { return "test-vector-to-vector-conversion"; } StringRef getDescription() const final { return "Test conversion patterns between ops in the vector dialect"; } void getDependentDialects(DialectRegistry ®istry) const override { registry.insert(); } Option unroll{*this, "unroll", llvm::cl::desc("Include unrolling"), llvm::cl::init(false)}; void runOnFunction() override { auto *ctx = &getContext(); RewritePatternSet patterns(ctx); if (unroll) { populateVectorUnrollPatterns( patterns, UnrollVectorOptions().setNativeShapeFn(getShape).setFilterConstraint( filter)); } populateVectorToVectorCanonicalizationPatterns(patterns); populateBubbleVectorBitCastOpPatterns(patterns); populateCastAwayVectorLeadingOneDimPatterns(patterns); (void)applyPatternsAndFoldGreedily(getFunction(), std::move(patterns)); } private: // Return the target shape based on op type. static Optional> getShape(Operation *op) { if (isa(op)) return SmallVector(2, 2); if (isa(op)) return SmallVector(3, 2); // For transfer ops, just propagate the shape coming from // InsertStridedSlices/ExtractStridedSlices. if (auto readOp = dyn_cast(op)) { VectorType dstVec; for (Operation *users : readOp->getUsers()) { auto extract = dyn_cast(users); if (!extract) return llvm::None; auto vecType = extract.getResult().getType().cast(); if (dstVec && dstVec != vecType) return llvm::None; dstVec = vecType; } return SmallVector(dstVec.getShape().begin(), dstVec.getShape().end()); } if (auto writeOp = dyn_cast(op)) { auto insert = writeOp.vector().getDefiningOp(); if (!insert) return llvm::None; ArrayRef shape = insert.getSourceVectorType().getShape(); return SmallVector(shape.begin(), shape.end()); } return llvm::None; } static LogicalResult filter(Operation *op) { return success(isa(op)); } }; struct TestVectorContractionConversion : public PassWrapper { StringRef getArgument() const final { return "test-vector-contraction-conversion"; } StringRef getDescription() const final { return "Test conversion patterns that lower contract ops in the vector " "dialect"; } TestVectorContractionConversion() = default; TestVectorContractionConversion(const TestVectorContractionConversion &pass) { } Option lowerToFlatMatrix{ *this, "vector-lower-matrix-intrinsics", llvm::cl::desc("Lower vector.contract to llvm.intr.matrix.multiply"), llvm::cl::init(false)}; Option lowerToFlatTranspose{ *this, "vector-flat-transpose", llvm::cl::desc("Lower 2-D vector.transpose to vector.flat_transpose"), llvm::cl::init(false)}; Option lowerToOuterProduct{ *this, "vector-outerproduct", llvm::cl::desc("Lower vector.contract to vector.outerproduct"), llvm::cl::init(false)}; Option lowerToFilterOuterProduct{ *this, "vector-filter-outerproduct", llvm::cl::desc("Lower vector.contract to vector.outerproduct but not for " "vectors of size 4."), llvm::cl::init(false)}; void runOnFunction() override { RewritePatternSet patterns(&getContext()); // Test on one pattern in isolation. if (lowerToOuterProduct) { VectorContractLowering lowering = VectorContractLowering::OuterProduct; VectorTransformsOptions options{lowering}; patterns.add(options, &getContext()); (void)applyPatternsAndFoldGreedily(getFunction(), std::move(patterns)); return; } // Test on one pattern in isolation. if (lowerToFilterOuterProduct) { VectorContractLowering lowering = VectorContractLowering::OuterProduct; VectorTransformsOptions options{lowering}; patterns.add( options, &getContext(), [](vector::ContractionOp op) { // Only lowers vector.contract where the lhs as a type vector // where M is not 4. if (op.getRhsType().getShape()[0] == 4) return failure(); return success(); }); (void)applyPatternsAndFoldGreedily(getFunction(), std::move(patterns)); return; } // Test on all contract lowering patterns. VectorContractLowering contractLowering = VectorContractLowering::Dot; if (lowerToFlatMatrix) contractLowering = VectorContractLowering::Matmul; VectorTransposeLowering transposeLowering = VectorTransposeLowering::EltWise; if (lowerToFlatTranspose) transposeLowering = VectorTransposeLowering::Flat; VectorTransformsOptions options{contractLowering, transposeLowering}; populateVectorBroadcastLoweringPatterns(patterns); populateVectorContractLoweringPatterns(patterns, options); populateVectorMaskOpLoweringPatterns(patterns); populateVectorShapeCastLoweringPatterns(patterns); populateVectorTransposeLoweringPatterns(patterns, options); (void)applyPatternsAndFoldGreedily(getFunction(), std::move(patterns)); } }; struct TestVectorUnrollingPatterns : public PassWrapper { StringRef getArgument() const final { return "test-vector-unrolling-patterns"; } StringRef getDescription() const final { return "Test conversion patterns to unroll contract ops in the vector " "dialect"; } TestVectorUnrollingPatterns() = default; TestVectorUnrollingPatterns(const TestVectorUnrollingPatterns &pass) {} void runOnFunction() override { MLIRContext *ctx = &getContext(); RewritePatternSet patterns(ctx); populateVectorUnrollPatterns( patterns, UnrollVectorOptions() .setNativeShape(ArrayRef{2, 2}) .setFilterConstraint([](Operation *op) { return success(isa(op)); })); if (unrollBasedOnType) { UnrollVectorOptions::NativeShapeFnType nativeShapeFn = [](Operation *op) -> Optional> { vector::ContractionOp contractOp = cast(op); SmallVector nativeShape = {4, 4, 2}; if (auto floatType = contractOp.getLhsType() .getElementType() .dyn_cast()) { if (floatType.getWidth() == 16) { nativeShape[2] = 4; } } return nativeShape; }; populateVectorUnrollPatterns(patterns, UnrollVectorOptions() .setNativeShapeFn(nativeShapeFn) .setFilterConstraint([](Operation *op) { return success(isa(op)); })); } else { populateVectorUnrollPatterns( patterns, UnrollVectorOptions() .setNativeShape(ArrayRef{2, 2, 2}) .setFilterConstraint([](Operation *op) { return success(isa(op)); })); } populateVectorToVectorCanonicalizationPatterns(patterns); (void)applyPatternsAndFoldGreedily(getFunction(), std::move(patterns)); } Option unrollBasedOnType{ *this, "unroll-based-on-type", llvm::cl::desc("Set the unroll factor based on type of the operation"), llvm::cl::init(false)}; }; struct TestVectorDistributePatterns : public PassWrapper { StringRef getArgument() const final { return "test-vector-distribute-patterns"; } StringRef getDescription() const final { return "Test conversion patterns to distribute vector ops in the vector " "dialect"; } TestVectorDistributePatterns() = default; TestVectorDistributePatterns(const TestVectorDistributePatterns &pass) {} void getDependentDialects(DialectRegistry ®istry) const override { registry.insert(); registry.insert(); } ListOption multiplicity{ *this, "distribution-multiplicity", llvm::cl::MiscFlags::CommaSeparated, llvm::cl::desc("Set the multiplicity used for distributing vector")}; void runOnFunction() override { MLIRContext *ctx = &getContext(); RewritePatternSet patterns(ctx); FuncOp func = getFunction(); func.walk([&](AddFOp op) { OpBuilder builder(op); if (auto vecType = op.getType().dyn_cast()) { SmallVector mul; SmallVector perm; SmallVector ids; unsigned count = 0; // Remove the multiplicity of 1 and calculate the affine map based on // the multiplicity. SmallVector m(multiplicity.begin(), multiplicity.end()); for (unsigned i = 0, e = vecType.getRank(); i < e; i++) { if (i < m.size() && m[i] != 1 && vecType.getDimSize(i) % m[i] == 0) { mul.push_back(m[i]); ids.push_back(func.getArgument(count++)); perm.push_back(getAffineDimExpr(i, ctx)); } } auto map = AffineMap::get(op.getType().cast().getRank(), 0, perm, ctx); Optional ops = distributPointwiseVectorOp( builder, op.getOperation(), ids, mul, map); if (ops.hasValue()) { SmallPtrSet extractOp({ops->extract, ops->insert}); op.getResult().replaceAllUsesExcept(ops->insert.getResult(), extractOp); } } }); populatePropagateVectorDistributionPatterns(patterns); (void)applyPatternsAndFoldGreedily(getFunction(), std::move(patterns)); } }; struct TestVectorToLoopPatterns : public PassWrapper { StringRef getArgument() const final { return "test-vector-to-forloop"; } StringRef getDescription() const final { return "Test conversion patterns to break up a vector op into a for loop"; } TestVectorToLoopPatterns() = default; TestVectorToLoopPatterns(const TestVectorToLoopPatterns &pass) {} void getDependentDialects(DialectRegistry ®istry) const override { registry.insert(); registry.insert(); } Option multiplicity{ *this, "distribution-multiplicity", llvm::cl::desc("Set the multiplicity used for distributing vector"), llvm::cl::init(32)}; void runOnFunction() override { MLIRContext *ctx = &getContext(); RewritePatternSet patterns(ctx); FuncOp func = getFunction(); func.walk([&](AddFOp op) { // Check that the operation type can be broken down into a loop. VectorType type = op.getType().dyn_cast(); if (!type || type.getRank() != 1 || type.getNumElements() % multiplicity != 0) return mlir::WalkResult::advance(); auto filterAlloc = [](Operation *op) { if (isa(op)) return false; return true; }; auto dependentOps = getSlice(op, filterAlloc); // Create a loop and move instructions from the Op slice into the loop. OpBuilder builder(op); auto zero = builder.create( op.getLoc(), builder.getIndexType(), builder.getIntegerAttr(builder.getIndexType(), 0)); auto one = builder.create( op.getLoc(), builder.getIndexType(), builder.getIntegerAttr(builder.getIndexType(), 1)); auto numIter = builder.create( op.getLoc(), builder.getIndexType(), builder.getIntegerAttr(builder.getIndexType(), multiplicity)); auto forOp = builder.create(op.getLoc(), zero, numIter, one); for (Operation *it : dependentOps) { it->moveBefore(forOp.getBody()->getTerminator()); } auto map = AffineMap::getMultiDimIdentityMap(1, ctx); // break up the original op and let the patterns propagate. Optional ops = distributPointwiseVectorOp( builder, op.getOperation(), {forOp.getInductionVar()}, {multiplicity}, map); if (ops.hasValue()) { SmallPtrSet extractOp({ops->extract, ops->insert}); op.getResult().replaceAllUsesExcept(ops->insert.getResult(), extractOp); } return mlir::WalkResult::interrupt(); }); populatePropagateVectorDistributionPatterns(patterns); (void)applyPatternsAndFoldGreedily(getFunction(), std::move(patterns)); } }; struct TestVectorTransferUnrollingPatterns : public PassWrapper { void getDependentDialects(DialectRegistry ®istry) const override { registry.insert(); } StringRef getArgument() const final { return "test-vector-transfer-unrolling-patterns"; } StringRef getDescription() const final { return "Test conversion patterns to unroll transfer ops in the vector " "dialect"; } void runOnFunction() override { MLIRContext *ctx = &getContext(); RewritePatternSet patterns(ctx); populateVectorUnrollPatterns( patterns, UnrollVectorOptions() .setNativeShape(ArrayRef{2, 2}) .setFilterConstraint([](Operation *op) { return success( isa(op)); })); populateVectorToVectorCanonicalizationPatterns(patterns); (void)applyPatternsAndFoldGreedily(getFunction(), std::move(patterns)); } }; struct TestVectorTransferFullPartialSplitPatterns : public PassWrapper { StringRef getArgument() const final { return "test-vector-transfer-full-partial-split"; } StringRef getDescription() const final { return "Test conversion patterns to split " "transfer ops via scf.if + linalg ops"; } TestVectorTransferFullPartialSplitPatterns() = default; TestVectorTransferFullPartialSplitPatterns( const TestVectorTransferFullPartialSplitPatterns &pass) {} void getDependentDialects(DialectRegistry ®istry) const override { registry.insert(); } Option useLinalgOps{ *this, "use-linalg-copy", llvm::cl::desc("Split using a unmasked vector.transfer + linalg.fill + " "linalg.copy operations."), llvm::cl::init(false)}; void runOnFunction() override { MLIRContext *ctx = &getContext(); RewritePatternSet patterns(ctx); VectorTransformsOptions options; if (useLinalgOps) options.setVectorTransferSplit(VectorTransferSplit::LinalgCopy); else options.setVectorTransferSplit(VectorTransferSplit::VectorTransfer); patterns.add(ctx, options); (void)applyPatternsAndFoldGreedily(getFunction(), std::move(patterns)); } }; struct TestVectorTransferOpt : public PassWrapper { StringRef getArgument() const final { return "test-vector-transferop-opt"; } StringRef getDescription() const final { return "Test optimization transformations for transfer ops"; } void runOnFunction() override { transferOpflowOpt(getFunction()); } }; struct TestVectorTransferLoweringPatterns : public PassWrapper { void getDependentDialects(DialectRegistry ®istry) const override { registry.insert(); } StringRef getArgument() const final { return "test-vector-transfer-lowering-patterns"; } StringRef getDescription() const final { return "Test conversion patterns to lower transfer ops to other vector ops"; } void runOnFunction() override { RewritePatternSet patterns(&getContext()); populateVectorTransferLoweringPatterns(patterns); populateVectorTransferPermutationMapLoweringPatterns(patterns); (void)applyPatternsAndFoldGreedily(getFunction(), std::move(patterns)); } }; struct TestVectorMultiReductionLoweringPatterns : public PassWrapper { TestVectorMultiReductionLoweringPatterns() = default; TestVectorMultiReductionLoweringPatterns( const TestVectorMultiReductionLoweringPatterns &pass) {} void getDependentDialects(DialectRegistry ®istry) const override { registry.insert(); } StringRef getArgument() const final { return "test-vector-multi-reduction-lowering-patterns"; } StringRef getDescription() const final { return "Test conversion patterns to lower vector.multi_reduction to other " "vector ops"; } Option useOuterReductions{ *this, "use-outer-reductions", llvm::cl::desc("Move reductions to outer most dimensions"), llvm::cl::init(false)}; void runOnFunction() override { RewritePatternSet patterns(&getContext()); populateVectorMultiReductionLoweringPatterns(patterns, !useOuterReductions); (void)applyPatternsAndFoldGreedily(getFunction(), std::move(patterns)); } }; } // end anonymous namespace namespace mlir { namespace test { void registerTestVectorConversions() { PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); } } // namespace test } // namespace mlir