//===- TestVectorTransforms.cpp - Test Vector transforms and lowerings ----===// // // 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/Func/IR/FuncOps.h" #include "mlir/Dialect/LLVMIR/LLVMDialect.h" #include "mlir/Dialect/Linalg/IR/Linalg.h" #include "mlir/Dialect/Linalg/Passes.h" #include "mlir/Dialect/Linalg/Transforms/Transforms.h" #include "mlir/Dialect/MemRef/IR/MemRef.h" #include "mlir/Dialect/SCF/SCF.h" #include "mlir/Dialect/Vector/Transforms/VectorTransforms.h" #include "mlir/Pass/Pass.h" #include "mlir/Pass/PassManager.h" #include "mlir/Transforms/GreedyPatternRewriteDriver.h" using namespace mlir; using namespace mlir::linalg; using namespace mlir::vector; namespace { struct TestVectorToVectorLowering : public PassWrapper> { TestVectorToVectorLowering() = default; TestVectorToVectorLowering(const TestVectorToVectorLowering &pass) : PassWrapper(pass) {} StringRef getArgument() const final { return "test-vector-to-vector-lowering"; } StringRef getDescription() const final { return "Test lowering 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 runOnOperation() override { auto *ctx = &getContext(); RewritePatternSet patterns(ctx); if (unroll) { populateVectorUnrollPatterns( patterns, UnrollVectorOptions().setNativeShapeFn(getShape).setFilterConstraint( filter)); } populateVectorToVectorCanonicalizationPatterns(patterns); populateBubbleVectorBitCastOpPatterns(patterns); populateCastAwayVectorLeadingOneDimPatterns(patterns); (void)applyPatternsAndFoldGreedily(getOperation(), 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 TestVectorContractionLowering : public PassWrapper> { StringRef getArgument() const final { return "test-vector-contraction-lowering"; } StringRef getDescription() const final { return "Test lowering patterns that lower contract ops in the vector " "dialect"; } TestVectorContractionLowering() = default; TestVectorContractionLowering(const TestVectorContractionLowering &pass) : PassWrapper(pass) {} Option lowerToFlatMatrix{ *this, "vector-lower-matrix-intrinsics", llvm::cl::desc("Lower vector.contract to llvm.intr.matrix.multiply"), 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 runOnOperation() 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(getOperation(), 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(getOperation(), std::move(patterns)); return; } // Test on all contract lowering patterns. VectorContractLowering contractLowering = VectorContractLowering::Dot; if (lowerToFlatMatrix) contractLowering = VectorContractLowering::Matmul; VectorMultiReductionLowering vectorMultiReductionLowering = VectorMultiReductionLowering::InnerParallel; VectorTransformsOptions options{contractLowering, vectorMultiReductionLowering, VectorTransposeLowering()}; populateVectorBroadcastLoweringPatterns(patterns); populateVectorContractLoweringPatterns(patterns, options); populateVectorMaskOpLoweringPatterns(patterns); populateVectorShapeCastLoweringPatterns(patterns); (void)applyPatternsAndFoldGreedily(getOperation(), std::move(patterns)); } }; struct TestVectorTransposeLowering : public PassWrapper> { StringRef getArgument() const final { return "test-vector-transpose-lowering"; } StringRef getDescription() const final { return "Test lowering patterns that lower contract ops in the vector " "dialect"; } TestVectorTransposeLowering() = default; TestVectorTransposeLowering(const TestVectorTransposeLowering &pass) : PassWrapper(pass) {} Option lowerToEltwise{ *this, "eltwise", llvm::cl::desc("Lower 2-D vector.transpose to eltwise insert/extract"), llvm::cl::init(false)}; Option lowerToFlatTranspose{ *this, "flat", llvm::cl::desc("Lower 2-D vector.transpose to vector.flat_transpose"), llvm::cl::init(false)}; Option lowerToShuffleTranspose{ *this, "shuffle", llvm::cl::desc("Lower 2-D vector.transpose to shape_cast + shuffle"), llvm::cl::init(false)}; Option lowerToAvx2{ *this, "avx2", llvm::cl::desc("Lower vector.transpose to avx2-specific patterns"), llvm::cl::init(false)}; void getDependentDialects(DialectRegistry ®istry) const override { registry.insert(); } void runOnOperation() override { RewritePatternSet patterns(&getContext()); // Test on one pattern in isolation. // Explicitly disable shape_cast lowering. LinalgVectorLoweringOptions options = LinalgVectorLoweringOptions() .enableVectorTransposeLowering() .enableShapeCastLowering(false); if (lowerToEltwise) { options = options.setVectorTransformsOptions( VectorTransformsOptions().setVectorTransposeLowering( VectorTransposeLowering::EltWise)); } if (lowerToFlatTranspose) { options = options.setVectorTransformsOptions( VectorTransformsOptions().setVectorTransposeLowering( VectorTransposeLowering::Flat)); } if (lowerToShuffleTranspose) { options = options.setVectorTransformsOptions( VectorTransformsOptions().setVectorTransposeLowering( VectorTransposeLowering::Shuffle)); } if (lowerToAvx2) { options = options.enableAVX2Lowering().setAVX2LoweringOptions( x86vector::avx2::LoweringOptions().setTransposeOptions( x86vector::avx2::TransposeLoweringOptions() .lower4x8xf32() .lower8x8xf32())); } OpPassManager dynamicPM("builtin.func"); dynamicPM.addPass(createLinalgStrategyLowerVectorsPass(options)); if (failed(runPipeline(dynamicPM, getOperation()))) return signalPassFailure(); } }; struct TestVectorUnrollingPatterns : public PassWrapper> { StringRef getArgument() const final { return "test-vector-unrolling-patterns"; } StringRef getDescription() const final { return "Test lowering patterns to unroll contract ops in the vector " "dialect"; } TestVectorUnrollingPatterns() = default; TestVectorUnrollingPatterns(const TestVectorUnrollingPatterns &pass) : PassWrapper(pass) {} void runOnOperation() override { MLIRContext *ctx = &getContext(); RewritePatternSet patterns(ctx); populateVectorUnrollPatterns( patterns, UnrollVectorOptions() .setNativeShape(ArrayRef{2, 2}) .setFilterConstraint([](Operation *op) { return success(isa(op)); })); populateVectorUnrollPatterns( patterns, UnrollVectorOptions() .setNativeShape(ArrayRef{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(getOperation(), 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 lowering patterns to distribute vector ops in the vector " "dialect"; } TestVectorDistributePatterns() = default; TestVectorDistributePatterns(const TestVectorDistributePatterns &pass) : PassWrapper(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 runOnOperation() override { MLIRContext *ctx = &getContext(); RewritePatternSet patterns(ctx); FuncOp func = getOperation(); func.walk([&](arith::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(getOperation(), std::move(patterns)); } }; struct TestVectorToLoopPatterns : public PassWrapper> { StringRef getArgument() const final { return "test-vector-to-forloop"; } StringRef getDescription() const final { return "Test lowering patterns to break up a vector op into a for loop"; } TestVectorToLoopPatterns() = default; TestVectorToLoopPatterns(const TestVectorToLoopPatterns &pass) : PassWrapper(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 runOnOperation() override { MLIRContext *ctx = &getContext(); RewritePatternSet patterns(ctx); FuncOp func = getOperation(); func.walk([&](arith::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) { return !isa(op); }; 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(), 0); auto one = builder.create(op.getLoc(), 1); auto numIter = builder.create(op.getLoc(), 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(getOperation(), 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 lowering patterns to unroll transfer ops in the vector " "dialect"; } void runOnOperation() 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(getOperation(), std::move(patterns)); } }; struct TestVectorTransferFullPartialSplitPatterns : public PassWrapper> { StringRef getArgument() const final { return "test-vector-transfer-full-partial-split"; } StringRef getDescription() const final { return "Test lowering patterns to split " "transfer ops via scf.if + linalg ops"; } TestVectorTransferFullPartialSplitPatterns() = default; TestVectorTransferFullPartialSplitPatterns( const TestVectorTransferFullPartialSplitPatterns &pass) : PassWrapper(pass) {} void getDependentDialects(DialectRegistry ®istry) const override { registry.insert(); } Option useLinalgOps{ *this, "use-memref-copy", llvm::cl::desc("Split using a unmasked vector.transfer + linalg.fill + " "memref.copy operations."), llvm::cl::init(false)}; void runOnOperation() 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(getOperation(), 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 runOnOperation() override { transferOpflowOpt(getOperation()); } }; 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 lowering patterns to lower transfer ops to other vector ops"; } void runOnOperation() override { RewritePatternSet patterns(&getContext()); populateVectorTransferLoweringPatterns(patterns); populateVectorTransferPermutationMapLoweringPatterns(patterns); (void)applyPatternsAndFoldGreedily(getOperation(), std::move(patterns)); } }; struct TestVectorMultiReductionLoweringPatterns : public PassWrapper> { TestVectorMultiReductionLoweringPatterns() = default; TestVectorMultiReductionLoweringPatterns( const TestVectorMultiReductionLoweringPatterns &pass) : PassWrapper(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 lowering 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 runOnOperation() override { RewritePatternSet patterns(&getContext()); populateVectorMultiReductionLoweringPatterns( patterns, useOuterReductions ? vector::VectorMultiReductionLowering::InnerParallel : vector::VectorMultiReductionLowering::InnerReduction); (void)applyPatternsAndFoldGreedily(getOperation(), std::move(patterns)); } }; struct TestVectorTransferCollapseInnerMostContiguousDims : public PassWrapper> { TestVectorTransferCollapseInnerMostContiguousDims() = default; TestVectorTransferCollapseInnerMostContiguousDims( const TestVectorTransferCollapseInnerMostContiguousDims &pass) = default; void getDependentDialects(DialectRegistry ®istry) const override { registry.insert(); } StringRef getArgument() const final { return "test-vector-transfer-collapse-inner-most-dims"; } StringRef getDescription() const final { return "Test lowering patterns that reducedes the rank of the vector " "transfer memory and vector operands."; } void runOnOperation() override { RewritePatternSet patterns(&getContext()); populateVectorTransferCollapseInnerMostContiguousDimsPatterns(patterns); (void)applyPatternsAndFoldGreedily(getOperation(), std::move(patterns)); } }; struct TestVectorReduceToContractPatternsPatterns : public PassWrapper> { StringRef getArgument() const final { return "test-vector-reduction-to-contract-patterns"; } StringRef getDescription() const final { return "Test patterns to convert multireduce op to contract and combine " "broadcast/transpose to contract"; } void runOnOperation() override { RewritePatternSet patterns(&getContext()); populateVectorReductionToContractPatterns(patterns); (void)applyPatternsAndFoldGreedily(getOperation(), std::move(patterns)); } }; struct TestVectorTransferDropUnitDimsPatterns : public PassWrapper> { StringRef getArgument() const final { return "test-vector-transfer-drop-unit-dims-patterns"; } void getDependentDialects(DialectRegistry ®istry) const override { registry.insert(); } void runOnOperation() override { RewritePatternSet patterns(&getContext()); populateVectorTransferDropUnitDimsPatterns(patterns); (void)applyPatternsAndFoldGreedily(getOperation(), std::move(patterns)); } }; struct TestFlattenVectorTransferPatterns : public PassWrapper> { StringRef getArgument() const final { return "test-vector-transfer-flatten-patterns"; } StringRef getDescription() const final { return "Test patterns to rewrite contiguous row-major N-dimensional " "vector.transfer_{read,write} ops into 1D transfers"; } void getDependentDialects(DialectRegistry ®istry) const override { registry.insert(); } void runOnOperation() override { RewritePatternSet patterns(&getContext()); populateFlattenVectorTransferPatterns(patterns); (void)applyPatternsAndFoldGreedily(getOperation(), std::move(patterns)); } }; struct TestVectorScanLowering : public PassWrapper> { StringRef getArgument() const final { return "test-vector-scan-lowering"; } StringRef getDescription() const final { return "Test lowering patterns that lower the scan op in the vector " "dialect"; } void runOnOperation() override { RewritePatternSet patterns(&getContext()); populateVectorScanLoweringPatterns(patterns); (void)applyPatternsAndFoldGreedily(getOperation(), std::move(patterns)); } }; } // namespace namespace mlir { namespace test { void registerTestVectorLowerings() { PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); PassRegistration(); } } // namespace test } // namespace mlir