blob: ae7d733124cd61eac23cddc71d5afa5988feb394 [file] [log] [blame]
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001//===- Schedule.cpp - Calculate an optimized schedule ---------------------===//
2//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9//
Tobias Grosser2219d152016-08-03 05:28:09 +000010// This pass generates an entirely new schedule tree from the data dependences
Tobias Grosser234a4822015-08-15 09:34:33 +000011// and iteration domains. The new schedule tree is computed in two steps:
Tobias Grosser30aa24c2011-05-14 19:02:06 +000012//
Tobias Grosser234a4822015-08-15 09:34:33 +000013// 1) The isl scheduling optimizer is run
14//
15// The isl scheduling optimizer creates a new schedule tree that maximizes
16// parallelism and tileability and minimizes data-dependence distances. The
17// algorithm used is a modified version of the ``Pluto'' algorithm:
18//
19// U. Bondhugula, A. Hartono, J. Ramanujam, and P. Sadayappan.
20// A Practical Automatic Polyhedral Parallelizer and Locality Optimizer.
21// In Proceedings of the 2008 ACM SIGPLAN Conference On Programming Language
22// Design and Implementation, PLDI ’08, pages 101–113. ACM, 2008.
23//
24// 2) A set of post-scheduling transformations is applied on the schedule tree.
25//
26// These optimizations include:
27//
28// - Tiling of the innermost tilable bands
29// - Prevectorization - The coice of a possible outer loop that is strip-mined
30// to the innermost level to enable inner-loop
31// vectorization.
32// - Some optimizations for spatial locality are also planned.
33//
34// For a detailed description of the schedule tree itself please see section 6
35// of:
36//
37// Polyhedral AST generation is more than scanning polyhedra
38// Tobias Grosser, Sven Verdoolaege, Albert Cohen
39// ACM Transations on Programming Languages and Systems (TOPLAS),
40// 37(4), July 2015
41// http://www.grosser.es/#pub-polyhedral-AST-generation
42//
43// This publication also contains a detailed discussion of the different options
44// for polyhedral loop unrolling, full/partial tile separation and other uses
45// of the schedule tree.
46//
Tobias Grosser30aa24c2011-05-14 19:02:06 +000047//===----------------------------------------------------------------------===//
48
Tobias Grosser967239c2011-10-23 20:59:44 +000049#include "polly/ScheduleOptimizer.h"
Tobias Grosserba0d0922015-05-09 09:13:42 +000050#include "polly/CodeGen/CodeGeneration.h"
51#include "polly/DependenceInfo.h"
52#include "polly/LinkAllPasses.h"
53#include "polly/Options.h"
54#include "polly/ScopInfo.h"
55#include "polly/Support/GICHelper.h"
Roman Gareev42402c92016-06-22 09:52:37 +000056#include "llvm/Analysis/TargetTransformInfo.h"
Tobias Grosserba0d0922015-05-09 09:13:42 +000057#include "llvm/Support/Debug.h"
Tobias Grosser2493e922011-12-07 07:42:57 +000058#include "isl/aff.h"
Tobias Grosserde68cc92011-06-30 20:01:02 +000059#include "isl/band.h"
Tobias Grosser8ad6bc32012-01-31 13:26:29 +000060#include "isl/constraint.h"
61#include "isl/map.h"
Tobias Grosser42152ff2012-01-30 19:38:47 +000062#include "isl/options.h"
Tobias Grosser97d87452015-05-30 06:46:59 +000063#include "isl/printer.h"
Tobias Grosser8ad6bc32012-01-31 13:26:29 +000064#include "isl/schedule.h"
Tobias Grosserbbb4cec2015-03-22 12:06:39 +000065#include "isl/schedule_node.h"
Tobias Grosser8ad6bc32012-01-31 13:26:29 +000066#include "isl/space.h"
Tobias Grossercd524dc2015-05-09 09:36:38 +000067#include "isl/union_map.h"
68#include "isl/union_set.h"
Tobias Grosser30aa24c2011-05-14 19:02:06 +000069
70using namespace llvm;
71using namespace polly;
72
Chandler Carruth95fef942014-04-22 03:30:19 +000073#define DEBUG_TYPE "polly-opt-isl"
74
Tobias Grossera26db472012-01-30 19:38:43 +000075static cl::opt<std::string>
Tobias Grosser483a90d2014-07-09 10:50:10 +000076 OptimizeDeps("polly-opt-optimize-only",
77 cl::desc("Only a certain kind of dependences (all/raw)"),
78 cl::Hidden, cl::init("all"), cl::ZeroOrMore,
79 cl::cat(PollyCategory));
Tobias Grosser1deda292012-02-14 14:02:48 +000080
81static cl::opt<std::string>
Tobias Grosser483a90d2014-07-09 10:50:10 +000082 SimplifyDeps("polly-opt-simplify-deps",
83 cl::desc("Dependences should be simplified (yes/no)"),
84 cl::Hidden, cl::init("yes"), cl::ZeroOrMore,
85 cl::cat(PollyCategory));
Tobias Grossera26db472012-01-30 19:38:43 +000086
Tobias Grosser483a90d2014-07-09 10:50:10 +000087static cl::opt<int> MaxConstantTerm(
88 "polly-opt-max-constant-term",
89 cl::desc("The maximal constant term allowed (-1 is unlimited)"), cl::Hidden,
90 cl::init(20), cl::ZeroOrMore, cl::cat(PollyCategory));
Tobias Grosser992e60c2012-02-20 08:41:15 +000091
Tobias Grosser483a90d2014-07-09 10:50:10 +000092static cl::opt<int> MaxCoefficient(
93 "polly-opt-max-coefficient",
94 cl::desc("The maximal coefficient allowed (-1 is unlimited)"), cl::Hidden,
95 cl::init(20), cl::ZeroOrMore, cl::cat(PollyCategory));
96
97static cl::opt<std::string> FusionStrategy(
98 "polly-opt-fusion", cl::desc("The fusion strategy to choose (min/max)"),
99 cl::Hidden, cl::init("min"), cl::ZeroOrMore, cl::cat(PollyCategory));
Tobias Grosser92f54802012-02-20 08:41:47 +0000100
Tobias Grossere602a072013-05-07 07:30:56 +0000101static cl::opt<std::string>
Tobias Grosser483a90d2014-07-09 10:50:10 +0000102 MaximizeBandDepth("polly-opt-maximize-bands",
103 cl::desc("Maximize the band depth (yes/no)"), cl::Hidden,
104 cl::init("yes"), cl::ZeroOrMore, cl::cat(PollyCategory));
Tobias Grosserb3ad85b2012-01-30 19:38:50 +0000105
Michael Kruse315aa322016-05-02 11:35:27 +0000106static cl::opt<std::string> OuterCoincidence(
107 "polly-opt-outer-coincidence",
108 cl::desc("Try to construct schedules where the outer member of each band "
109 "satisfies the coincidence constraints (yes/no)"),
110 cl::Hidden, cl::init("no"), cl::ZeroOrMore, cl::cat(PollyCategory));
111
Tobias Grosser07c1c2f2015-08-19 08:46:11 +0000112static cl::opt<int> PrevectorWidth(
113 "polly-prevect-width",
114 cl::desc(
115 "The number of loop iterations to strip-mine for pre-vectorization"),
116 cl::Hidden, cl::init(4), cl::ZeroOrMore, cl::cat(PollyCategory));
117
Tobias Grosser04832712015-08-20 13:45:02 +0000118static cl::opt<bool> FirstLevelTiling("polly-tiling",
119 cl::desc("Enable loop tiling"),
120 cl::init(true), cl::ZeroOrMore,
121 cl::cat(PollyCategory));
122
Roman Gareev42402c92016-06-22 09:52:37 +0000123static cl::opt<int> LatencyVectorFma(
124 "polly-target-latency-vector-fma",
125 cl::desc("The minimal number of cycles between issuing two "
126 "dependent consecutive vector fused multiply-add "
127 "instructions."),
128 cl::Hidden, cl::init(8), cl::ZeroOrMore, cl::cat(PollyCategory));
129
130static cl::opt<int> ThrougputVectorFma(
131 "polly-target-througput-vector-fma",
132 cl::desc("A throughput of the processor floating-point arithmetic units "
133 "expressed in the number of vector fused multiply-add "
134 "instructions per clock cycle."),
135 cl::Hidden, cl::init(1), cl::ZeroOrMore, cl::cat(PollyCategory));
136
Roman Gareev3a18a932016-07-25 09:42:53 +0000137static cl::list<int>
138 CacheLevelAssociativity("polly-target-cache-level-associativity",
139 cl::desc("The associativity of each cache level."),
140 cl::Hidden, cl::ZeroOrMore, cl::CommaSeparated,
141 cl::cat(PollyCategory));
142
143static cl::list<int> CacheLevelSizes(
144 "polly-target-cache-level-sizes",
145 cl::desc("The size of each cache level specified in bytes."), cl::Hidden,
146 cl::ZeroOrMore, cl::CommaSeparated, cl::cat(PollyCategory));
147
Tobias Grosser04832712015-08-20 13:45:02 +0000148static cl::opt<int> FirstLevelDefaultTileSize(
Tobias Grosser483a90d2014-07-09 10:50:10 +0000149 "polly-default-tile-size",
150 cl::desc("The default tile size (if not enough were provided by"
151 " --polly-tile-sizes)"),
152 cl::Hidden, cl::init(32), cl::ZeroOrMore, cl::cat(PollyCategory));
Johannes Doerfertc3958b22014-05-28 17:21:02 +0000153
Tobias Grosser04832712015-08-20 13:45:02 +0000154static cl::list<int> FirstLevelTileSizes(
155 "polly-tile-sizes", cl::desc("A tile size for each loop dimension, filled "
156 "with --polly-default-tile-size"),
157 cl::Hidden, cl::ZeroOrMore, cl::CommaSeparated, cl::cat(PollyCategory));
158
159static cl::opt<bool>
160 SecondLevelTiling("polly-2nd-level-tiling",
161 cl::desc("Enable a 2nd level loop of loop tiling"),
162 cl::init(false), cl::ZeroOrMore, cl::cat(PollyCategory));
163
164static cl::opt<int> SecondLevelDefaultTileSize(
165 "polly-2nd-level-default-tile-size",
166 cl::desc("The default 2nd-level tile size (if not enough were provided by"
167 " --polly-2nd-level-tile-sizes)"),
168 cl::Hidden, cl::init(16), cl::ZeroOrMore, cl::cat(PollyCategory));
169
170static cl::list<int>
171 SecondLevelTileSizes("polly-2nd-level-tile-sizes",
172 cl::desc("A tile size for each loop dimension, filled "
173 "with --polly-default-tile-size"),
174 cl::Hidden, cl::ZeroOrMore, cl::CommaSeparated,
175 cl::cat(PollyCategory));
176
Tobias Grosser42e24892015-08-20 13:45:05 +0000177static cl::opt<bool> RegisterTiling("polly-register-tiling",
178 cl::desc("Enable register tiling"),
179 cl::init(false), cl::ZeroOrMore,
180 cl::cat(PollyCategory));
181
182static cl::opt<int> RegisterDefaultTileSize(
183 "polly-register-tiling-default-tile-size",
184 cl::desc("The default register tile size (if not enough were provided by"
185 " --polly-register-tile-sizes)"),
186 cl::Hidden, cl::init(2), cl::ZeroOrMore, cl::cat(PollyCategory));
187
188static cl::list<int>
189 RegisterTileSizes("polly-register-tile-sizes",
190 cl::desc("A tile size for each loop dimension, filled "
191 "with --polly-register-tile-size"),
192 cl::Hidden, cl::ZeroOrMore, cl::CommaSeparated,
193 cl::cat(PollyCategory));
194
Roman Gareev9c3eb592016-05-28 16:17:58 +0000195static cl::opt<bool>
196 PMBasedOpts("polly-pattern-matching-based-opts",
197 cl::desc("Perform optimizations based on pattern matching"),
198 cl::init(false), cl::ZeroOrMore, cl::cat(PollyCategory));
199
Roman Gareev5f99f862016-08-21 11:20:39 +0000200static cl::opt<bool> OptimizedScops(
201 "polly-optimized-scops",
202 cl::desc("Polly - Dump polyhedral description of Scops optimized with "
203 "the isl scheduling optimizer and the set of post-scheduling "
204 "transformations is applied on the schedule tree"),
205 cl::init(false), cl::ZeroOrMore, cl::cat(PollyCategory));
206
Tobias Grosserc80d6972016-09-02 06:33:33 +0000207/// Create an isl_union_set, which describes the isolate option based on
208/// IsoalteDomain.
Tobias Grosserca7f5bb2015-10-20 09:12:21 +0000209///
210/// @param IsolateDomain An isl_set whose last dimension is the only one that
211/// should belong to the current band node.
212static __isl_give isl_union_set *
213getIsolateOptions(__isl_take isl_set *IsolateDomain) {
214 auto Dims = isl_set_dim(IsolateDomain, isl_dim_set);
215 auto *IsolateRelation = isl_map_from_domain(IsolateDomain);
216 IsolateRelation = isl_map_move_dims(IsolateRelation, isl_dim_out, 0,
217 isl_dim_in, Dims - 1, 1);
218 auto *IsolateOption = isl_map_wrap(IsolateRelation);
Tobias Grosser8dd653d2016-06-22 16:22:00 +0000219 auto *Id = isl_id_alloc(isl_set_get_ctx(IsolateOption), "isolate", nullptr);
Tobias Grosserca7f5bb2015-10-20 09:12:21 +0000220 return isl_union_set_from_set(isl_set_set_tuple_id(IsolateOption, Id));
221}
222
Tobias Grosserc80d6972016-09-02 06:33:33 +0000223/// Create an isl_union_set, which describes the atomic option for the dimension
224/// of the current node.
Tobias Grosserca7f5bb2015-10-20 09:12:21 +0000225///
226/// It may help to reduce the size of generated code.
227///
228/// @param Ctx An isl_ctx, which is used to create the isl_union_set.
229static __isl_give isl_union_set *getAtomicOptions(__isl_take isl_ctx *Ctx) {
230 auto *Space = isl_space_set_alloc(Ctx, 0, 1);
231 auto *AtomicOption = isl_set_universe(Space);
Tobias Grosser8dd653d2016-06-22 16:22:00 +0000232 auto *Id = isl_id_alloc(Ctx, "atomic", nullptr);
Tobias Grosserca7f5bb2015-10-20 09:12:21 +0000233 return isl_union_set_from_set(isl_set_set_tuple_id(AtomicOption, Id));
234}
235
Tobias Grosserc80d6972016-09-02 06:33:33 +0000236/// Make the last dimension of Set to take values from 0 to VectorWidth - 1.
Tobias Grosserca7f5bb2015-10-20 09:12:21 +0000237///
238/// @param Set A set, which should be modified.
239/// @param VectorWidth A parameter, which determines the constraint.
240static __isl_give isl_set *addExtentConstraints(__isl_take isl_set *Set,
241 int VectorWidth) {
242 auto Dims = isl_set_dim(Set, isl_dim_set);
243 auto Space = isl_set_get_space(Set);
244 auto *LocalSpace = isl_local_space_from_space(Space);
245 auto *ExtConstr =
246 isl_constraint_alloc_inequality(isl_local_space_copy(LocalSpace));
247 ExtConstr = isl_constraint_set_constant_si(ExtConstr, 0);
248 ExtConstr =
249 isl_constraint_set_coefficient_si(ExtConstr, isl_dim_set, Dims - 1, 1);
250 Set = isl_set_add_constraint(Set, ExtConstr);
251 ExtConstr = isl_constraint_alloc_inequality(LocalSpace);
252 ExtConstr = isl_constraint_set_constant_si(ExtConstr, VectorWidth - 1);
253 ExtConstr =
254 isl_constraint_set_coefficient_si(ExtConstr, isl_dim_set, Dims - 1, -1);
255 return isl_set_add_constraint(Set, ExtConstr);
256}
257
Tobias Grosserc80d6972016-09-02 06:33:33 +0000258/// Build the desired set of partial tile prefixes.
Tobias Grosserca7f5bb2015-10-20 09:12:21 +0000259///
260/// We build a set of partial tile prefixes, which are prefixes of the vector
261/// loop that have exactly VectorWidth iterations.
262///
263/// 1. Get all prefixes of the vector loop.
264/// 2. Extend it to a set, which has exactly VectorWidth iterations for
265/// any prefix from the set that was built on the previous step.
266/// 3. Subtract loop domain from it, project out the vector loop dimension and
Roman Gareev76614d32016-05-31 11:22:21 +0000267/// get a set of prefixes, which don't have exactly VectorWidth iterations.
Tobias Grosserca7f5bb2015-10-20 09:12:21 +0000268/// 4. Subtract it from all prefixes of the vector loop and get the desired
269/// set.
270///
271/// @param ScheduleRange A range of a map, which describes a prefix schedule
272/// relation.
273static __isl_give isl_set *
274getPartialTilePrefixes(__isl_take isl_set *ScheduleRange, int VectorWidth) {
275 auto Dims = isl_set_dim(ScheduleRange, isl_dim_set);
276 auto *LoopPrefixes = isl_set_project_out(isl_set_copy(ScheduleRange),
277 isl_dim_set, Dims - 1, 1);
278 auto *ExtentPrefixes =
279 isl_set_add_dims(isl_set_copy(LoopPrefixes), isl_dim_set, 1);
280 ExtentPrefixes = addExtentConstraints(ExtentPrefixes, VectorWidth);
281 auto *BadPrefixes = isl_set_subtract(ExtentPrefixes, ScheduleRange);
282 BadPrefixes = isl_set_project_out(BadPrefixes, isl_dim_set, Dims - 1, 1);
283 return isl_set_subtract(LoopPrefixes, BadPrefixes);
284}
285
286__isl_give isl_schedule_node *ScheduleTreeOptimizer::isolateFullPartialTiles(
287 __isl_take isl_schedule_node *Node, int VectorWidth) {
288 assert(isl_schedule_node_get_type(Node) == isl_schedule_node_band);
289 Node = isl_schedule_node_child(Node, 0);
290 Node = isl_schedule_node_child(Node, 0);
291 auto *SchedRelUMap = isl_schedule_node_get_prefix_schedule_relation(Node);
292 auto *ScheduleRelation = isl_map_from_union_map(SchedRelUMap);
293 auto *ScheduleRange = isl_map_range(ScheduleRelation);
294 auto *IsolateDomain = getPartialTilePrefixes(ScheduleRange, VectorWidth);
295 auto *AtomicOption = getAtomicOptions(isl_set_get_ctx(IsolateDomain));
296 auto *IsolateOption = getIsolateOptions(IsolateDomain);
297 Node = isl_schedule_node_parent(Node);
298 Node = isl_schedule_node_parent(Node);
299 auto *Options = isl_union_set_union(IsolateOption, AtomicOption);
300 Node = isl_schedule_node_band_set_ast_build_options(Node, Options);
301 return Node;
302}
303
Tobias Grosserb241d922015-07-28 18:03:36 +0000304__isl_give isl_schedule_node *
Tobias Grosserfa57e9b2015-08-24 06:01:47 +0000305ScheduleTreeOptimizer::prevectSchedBand(__isl_take isl_schedule_node *Node,
306 unsigned DimToVectorize,
307 int VectorWidth) {
Tobias Grosserb241d922015-07-28 18:03:36 +0000308 assert(isl_schedule_node_get_type(Node) == isl_schedule_node_band);
Tobias Grosserc6699b72011-06-30 20:29:13 +0000309
Tobias Grosserb241d922015-07-28 18:03:36 +0000310 auto Space = isl_schedule_node_band_get_space(Node);
311 auto ScheduleDimensions = isl_space_dim(Space, isl_dim_set);
312 isl_space_free(Space);
313 assert(DimToVectorize < ScheduleDimensions);
Tobias Grosserf5338802011-10-06 00:03:35 +0000314
Tobias Grosserb241d922015-07-28 18:03:36 +0000315 if (DimToVectorize > 0) {
316 Node = isl_schedule_node_band_split(Node, DimToVectorize);
317 Node = isl_schedule_node_child(Node, 0);
318 }
319 if (DimToVectorize < ScheduleDimensions - 1)
320 Node = isl_schedule_node_band_split(Node, 1);
321 Space = isl_schedule_node_band_get_space(Node);
322 auto Sizes = isl_multi_val_zero(Space);
323 auto Ctx = isl_schedule_node_get_ctx(Node);
324 Sizes =
325 isl_multi_val_set_val(Sizes, 0, isl_val_int_from_si(Ctx, VectorWidth));
326 Node = isl_schedule_node_band_tile(Node, Sizes);
Tobias Grosserca7f5bb2015-10-20 09:12:21 +0000327 Node = isolateFullPartialTiles(Node, VectorWidth);
Tobias Grosserb241d922015-07-28 18:03:36 +0000328 Node = isl_schedule_node_child(Node, 0);
Tobias Grosser42e24892015-08-20 13:45:05 +0000329 // Make sure the "trivially vectorizable loop" is not unrolled. Otherwise,
330 // we will have troubles to match it in the backend.
331 Node = isl_schedule_node_band_set_ast_build_options(
Tobias Grosserfc490a92015-08-20 19:08:16 +0000332 Node, isl_union_set_read_from_str(Ctx, "{ unroll[x]: 1 = 0 }"));
333 Node = isl_schedule_node_band_sink(Node);
Tobias Grosserb241d922015-07-28 18:03:36 +0000334 Node = isl_schedule_node_child(Node, 0);
Roman Gareev11001e12016-02-23 09:00:13 +0000335 if (isl_schedule_node_get_type(Node) == isl_schedule_node_leaf)
336 Node = isl_schedule_node_parent(Node);
337 isl_id *LoopMarker = isl_id_alloc(Ctx, "SIMD", nullptr);
338 Node = isl_schedule_node_insert_mark(Node, LoopMarker);
Tobias Grosserb241d922015-07-28 18:03:36 +0000339 return Node;
Tobias Grosserc6699b72011-06-30 20:29:13 +0000340}
341
Tobias Grosserd891b542015-08-20 12:16:23 +0000342__isl_give isl_schedule_node *
Tobias Grosserfa57e9b2015-08-24 06:01:47 +0000343ScheduleTreeOptimizer::tileNode(__isl_take isl_schedule_node *Node,
344 const char *Identifier, ArrayRef<int> TileSizes,
345 int DefaultTileSize) {
Tobias Grosser9bdea572015-08-20 12:22:37 +0000346 auto Ctx = isl_schedule_node_get_ctx(Node);
347 auto Space = isl_schedule_node_band_get_space(Node);
348 auto Dims = isl_space_dim(Space, isl_dim_set);
349 auto Sizes = isl_multi_val_zero(Space);
Tobias Grosser1ac884d2015-08-23 09:11:00 +0000350 std::string IdentifierString(Identifier);
Tobias Grosser9bdea572015-08-20 12:22:37 +0000351 for (unsigned i = 0; i < Dims; i++) {
352 auto tileSize = i < TileSizes.size() ? TileSizes[i] : DefaultTileSize;
353 Sizes = isl_multi_val_set_val(Sizes, i, isl_val_int_from_si(Ctx, tileSize));
354 }
Tobias Grosser1ac884d2015-08-23 09:11:00 +0000355 auto TileLoopMarkerStr = IdentifierString + " - Tiles";
356 isl_id *TileLoopMarker =
357 isl_id_alloc(Ctx, TileLoopMarkerStr.c_str(), nullptr);
358 Node = isl_schedule_node_insert_mark(Node, TileLoopMarker);
359 Node = isl_schedule_node_child(Node, 0);
Tobias Grosser9bdea572015-08-20 12:22:37 +0000360 Node = isl_schedule_node_band_tile(Node, Sizes);
Tobias Grosser1ac884d2015-08-23 09:11:00 +0000361 Node = isl_schedule_node_child(Node, 0);
362 auto PointLoopMarkerStr = IdentifierString + " - Points";
363 isl_id *PointLoopMarker =
364 isl_id_alloc(Ctx, PointLoopMarkerStr.c_str(), nullptr);
365 Node = isl_schedule_node_insert_mark(Node, PointLoopMarker);
366 Node = isl_schedule_node_child(Node, 0);
367 return Node;
Tobias Grosser9bdea572015-08-20 12:22:37 +0000368}
369
Roman Gareevb17b9a82016-06-12 17:20:05 +0000370__isl_give isl_schedule_node *
371ScheduleTreeOptimizer::applyRegisterTiling(__isl_take isl_schedule_node *Node,
372 llvm::ArrayRef<int> TileSizes,
373 int DefaultTileSize) {
374 auto *Ctx = isl_schedule_node_get_ctx(Node);
375 Node = tileNode(Node, "Register tiling", TileSizes, DefaultTileSize);
376 Node = isl_schedule_node_band_set_ast_build_options(
377 Node, isl_union_set_read_from_str(Ctx, "{unroll[x]}"));
378 return Node;
379}
380
Tobias Grosserfa57e9b2015-08-24 06:01:47 +0000381bool ScheduleTreeOptimizer::isTileableBandNode(
Tobias Grosser862b9b52015-08-20 12:32:45 +0000382 __isl_keep isl_schedule_node *Node) {
Tobias Grosserbbb4cec2015-03-22 12:06:39 +0000383 if (isl_schedule_node_get_type(Node) != isl_schedule_node_band)
Tobias Grosser862b9b52015-08-20 12:32:45 +0000384 return false;
Tobias Grosserde68cc92011-06-30 20:01:02 +0000385
Tobias Grosserbbb4cec2015-03-22 12:06:39 +0000386 if (isl_schedule_node_n_children(Node) != 1)
Tobias Grosser862b9b52015-08-20 12:32:45 +0000387 return false;
Tobias Grosserde68cc92011-06-30 20:01:02 +0000388
Tobias Grosserbbb4cec2015-03-22 12:06:39 +0000389 if (!isl_schedule_node_band_get_permutable(Node))
Tobias Grosser862b9b52015-08-20 12:32:45 +0000390 return false;
Tobias Grosser44f19ac2011-07-05 22:15:53 +0000391
Tobias Grosserbbb4cec2015-03-22 12:06:39 +0000392 auto Space = isl_schedule_node_band_get_space(Node);
393 auto Dims = isl_space_dim(Space, isl_dim_set);
Tobias Grosser9bdea572015-08-20 12:22:37 +0000394 isl_space_free(Space);
Tobias Grosserde68cc92011-06-30 20:01:02 +0000395
Tobias Grosser9bdea572015-08-20 12:22:37 +0000396 if (Dims <= 1)
Tobias Grosser862b9b52015-08-20 12:32:45 +0000397 return false;
Tobias Grosserde68cc92011-06-30 20:01:02 +0000398
Tobias Grosserbbb4cec2015-03-22 12:06:39 +0000399 auto Child = isl_schedule_node_get_child(Node, 0);
400 auto Type = isl_schedule_node_get_type(Child);
401 isl_schedule_node_free(Child);
402
Tobias Grosser9bdea572015-08-20 12:22:37 +0000403 if (Type != isl_schedule_node_leaf)
Tobias Grosser862b9b52015-08-20 12:32:45 +0000404 return false;
405
406 return true;
407}
408
409__isl_give isl_schedule_node *
Roman Gareev9c3eb592016-05-28 16:17:58 +0000410ScheduleTreeOptimizer::standardBandOpts(__isl_take isl_schedule_node *Node,
411 void *User) {
Tobias Grosser04832712015-08-20 13:45:02 +0000412 if (FirstLevelTiling)
Tobias Grosser1ac884d2015-08-23 09:11:00 +0000413 Node = tileNode(Node, "1st level tiling", FirstLevelTileSizes,
414 FirstLevelDefaultTileSize);
Tobias Grosser04832712015-08-20 13:45:02 +0000415
416 if (SecondLevelTiling)
Tobias Grosser1ac884d2015-08-23 09:11:00 +0000417 Node = tileNode(Node, "2nd level tiling", SecondLevelTileSizes,
418 SecondLevelDefaultTileSize);
Tobias Grosserbbb4cec2015-03-22 12:06:39 +0000419
Roman Gareevb17b9a82016-06-12 17:20:05 +0000420 if (RegisterTiling)
421 Node =
422 applyRegisterTiling(Node, RegisterTileSizes, RegisterDefaultTileSize);
Tobias Grosser42e24892015-08-20 13:45:05 +0000423
Tobias Grosserbbb4cec2015-03-22 12:06:39 +0000424 if (PollyVectorizerChoice == VECTORIZER_NONE)
Tobias Grosserf10f4632015-08-19 08:03:37 +0000425 return Node;
Tobias Grosserbbb4cec2015-03-22 12:06:39 +0000426
Tobias Grosser862b9b52015-08-20 12:32:45 +0000427 auto Space = isl_schedule_node_band_get_space(Node);
428 auto Dims = isl_space_dim(Space, isl_dim_set);
429 isl_space_free(Space);
430
Tobias Grosserb241d922015-07-28 18:03:36 +0000431 for (int i = Dims - 1; i >= 0; i--)
Tobias Grosserf10f4632015-08-19 08:03:37 +0000432 if (isl_schedule_node_band_member_get_coincident(Node, i)) {
Tobias Grosserfa57e9b2015-08-24 06:01:47 +0000433 Node = prevectSchedBand(Node, i, PrevectorWidth);
Tobias Grosserbbb4cec2015-03-22 12:06:39 +0000434 break;
435 }
Tobias Grosserbbb4cec2015-03-22 12:06:39 +0000436
Tobias Grosserf10f4632015-08-19 08:03:37 +0000437 return Node;
Tobias Grosserde68cc92011-06-30 20:01:02 +0000438}
439
Tobias Grosserc80d6972016-09-02 06:33:33 +0000440/// Check whether output dimensions of the map rely on the specified input
441/// dimension.
Roman Gareev9c3eb592016-05-28 16:17:58 +0000442///
443/// @param IslMap The isl map to be considered.
444/// @param DimNum The number of an input dimension to be checked.
445static bool isInputDimUsed(__isl_take isl_map *IslMap, unsigned DimNum) {
446 auto *CheckedAccessRelation =
447 isl_map_project_out(isl_map_copy(IslMap), isl_dim_in, DimNum, 1);
448 CheckedAccessRelation =
449 isl_map_insert_dims(CheckedAccessRelation, isl_dim_in, DimNum, 1);
450 auto *InputDimsId = isl_map_get_tuple_id(IslMap, isl_dim_in);
451 CheckedAccessRelation =
452 isl_map_set_tuple_id(CheckedAccessRelation, isl_dim_in, InputDimsId);
453 InputDimsId = isl_map_get_tuple_id(IslMap, isl_dim_out);
454 CheckedAccessRelation =
455 isl_map_set_tuple_id(CheckedAccessRelation, isl_dim_out, InputDimsId);
456 auto res = !isl_map_is_equal(CheckedAccessRelation, IslMap);
457 isl_map_free(CheckedAccessRelation);
458 isl_map_free(IslMap);
459 return res;
460}
461
Tobias Grosserc80d6972016-09-02 06:33:33 +0000462/// Check if the SCoP statement could probably be optimized with analytical
463/// modeling.
Roman Gareev9c3eb592016-05-28 16:17:58 +0000464///
465/// containsMatrMult tries to determine whether the following conditions
466/// are true:
467/// 1. all memory accesses of the statement will have stride 0 or 1,
468/// if we interchange loops (switch the variable used in the inner
469/// loop to the outer loop).
470/// 2. all memory accesses of the statement except from the last one, are
471/// read memory access and the last one is write memory access.
Roman Gareev76614d32016-05-31 11:22:21 +0000472/// 3. all subscripts of the last memory access of the statement don't contain
Roman Gareev9c3eb592016-05-28 16:17:58 +0000473/// the variable used in the inner loop.
474///
475/// @param PartialSchedule The PartialSchedule that contains a SCoP statement
476/// to check.
477static bool containsMatrMult(__isl_keep isl_map *PartialSchedule) {
478 auto InputDimsId = isl_map_get_tuple_id(PartialSchedule, isl_dim_in);
479 auto *ScpStmt = static_cast<ScopStmt *>(isl_id_get_user(InputDimsId));
480 isl_id_free(InputDimsId);
481 if (ScpStmt->size() <= 1)
482 return false;
483 auto MemA = ScpStmt->begin();
484 for (unsigned i = 0; i < ScpStmt->size() - 2 && MemA != ScpStmt->end();
485 i++, MemA++)
Roman Gareev76614d32016-05-31 11:22:21 +0000486 if (!(*MemA)->isRead() ||
487 ((*MemA)->isArrayKind() &&
488 !((*MemA)->isStrideOne(isl_map_copy(PartialSchedule)) ||
Roman Gareev9c3eb592016-05-28 16:17:58 +0000489 (*MemA)->isStrideZero(isl_map_copy(PartialSchedule)))))
490 return false;
491 MemA++;
Roman Gareev76614d32016-05-31 11:22:21 +0000492 if (!(*MemA)->isWrite() || !(*MemA)->isArrayKind() ||
493 !((*MemA)->isStrideOne(isl_map_copy(PartialSchedule)) ||
Roman Gareev9c3eb592016-05-28 16:17:58 +0000494 (*MemA)->isStrideZero(isl_map_copy(PartialSchedule))))
495 return false;
496 auto DimNum = isl_map_dim(PartialSchedule, isl_dim_in);
497 return !isInputDimUsed((*MemA)->getAccessRelation(), DimNum - 1);
498}
499
Tobias Grosserc80d6972016-09-02 06:33:33 +0000500/// Circular shift of output dimensions of the integer map.
Roman Gareev9c3eb592016-05-28 16:17:58 +0000501///
502/// @param IslMap The isl map to be modified.
503static __isl_give isl_map *circularShiftOutputDims(__isl_take isl_map *IslMap) {
Roman Gareev9c3eb592016-05-28 16:17:58 +0000504 auto DimNum = isl_map_dim(IslMap, isl_dim_out);
Roman Gareev4b8c7ae2016-06-03 18:46:29 +0000505 if (DimNum == 0)
506 return IslMap;
507 auto InputDimsId = isl_map_get_tuple_id(IslMap, isl_dim_in);
Roman Gareev9c3eb592016-05-28 16:17:58 +0000508 IslMap = isl_map_move_dims(IslMap, isl_dim_in, 0, isl_dim_out, DimNum - 1, 1);
509 IslMap = isl_map_move_dims(IslMap, isl_dim_out, 0, isl_dim_in, 0, 1);
510 return isl_map_set_tuple_id(IslMap, isl_dim_in, InputDimsId);
511}
512
Tobias Grosserc80d6972016-09-02 06:33:33 +0000513/// Permute two dimensions of the band node.
Roman Gareev3a18a932016-07-25 09:42:53 +0000514///
515/// Permute FirstDim and SecondDim dimensions of the Node.
516///
517/// @param Node The band node to be modified.
518/// @param FirstDim The first dimension to be permuted.
519/// @param SecondDim The second dimension to be permuted.
520static __isl_give isl_schedule_node *
521permuteBandNodeDimensions(__isl_take isl_schedule_node *Node, unsigned FirstDim,
522 unsigned SecondDim) {
523 assert(isl_schedule_node_get_type(Node) == isl_schedule_node_band &&
524 isl_schedule_node_band_n_member(Node) > std::max(FirstDim, SecondDim));
525 auto PartialSchedule = isl_schedule_node_band_get_partial_schedule(Node);
526 auto PartialScheduleFirstDim =
527 isl_multi_union_pw_aff_get_union_pw_aff(PartialSchedule, FirstDim);
528 auto PartialScheduleSecondDim =
529 isl_multi_union_pw_aff_get_union_pw_aff(PartialSchedule, SecondDim);
530 PartialSchedule = isl_multi_union_pw_aff_set_union_pw_aff(
531 PartialSchedule, SecondDim, PartialScheduleFirstDim);
532 PartialSchedule = isl_multi_union_pw_aff_set_union_pw_aff(
533 PartialSchedule, FirstDim, PartialScheduleSecondDim);
534 Node = isl_schedule_node_delete(Node);
535 Node = isl_schedule_node_insert_partial_schedule(Node, PartialSchedule);
536 return Node;
537}
538
Roman Gareev2cb4d132016-07-25 07:27:59 +0000539__isl_give isl_schedule_node *ScheduleTreeOptimizer::createMicroKernel(
540 __isl_take isl_schedule_node *Node, MicroKernelParamsTy MicroKernelParams) {
Roman Gareev8babe1a2016-12-15 11:47:38 +0000541 applyRegisterTiling(Node, {MicroKernelParams.Mr, MicroKernelParams.Nr}, 1);
542 Node = isl_schedule_node_parent(isl_schedule_node_parent(Node));
543 Node = permuteBandNodeDimensions(Node, 0, 1);
544 return isl_schedule_node_child(isl_schedule_node_child(Node, 0), 0);
Roman Gareev2cb4d132016-07-25 07:27:59 +0000545}
546
Roman Gareev3a18a932016-07-25 09:42:53 +0000547__isl_give isl_schedule_node *ScheduleTreeOptimizer::createMacroKernel(
548 __isl_take isl_schedule_node *Node, MacroKernelParamsTy MacroKernelParams) {
549 assert(isl_schedule_node_get_type(Node) == isl_schedule_node_band);
550 if (MacroKernelParams.Mc == 1 && MacroKernelParams.Nc == 1 &&
551 MacroKernelParams.Kc == 1)
552 return Node;
553 Node = tileNode(
554 Node, "1st level tiling",
555 {MacroKernelParams.Mc, MacroKernelParams.Nc, MacroKernelParams.Kc}, 1);
556 Node = isl_schedule_node_parent(isl_schedule_node_parent(Node));
557 Node = permuteBandNodeDimensions(Node, 1, 2);
Roman Gareev8babe1a2016-12-15 11:47:38 +0000558 Node = permuteBandNodeDimensions(Node, 0, 2);
Roman Gareev3a18a932016-07-25 09:42:53 +0000559 return isl_schedule_node_child(isl_schedule_node_child(Node, 0), 0);
560}
561
Roman Gareev2cb4d132016-07-25 07:27:59 +0000562/// Get parameters of the BLIS micro kernel.
563///
564/// We choose the Mr and Nr parameters of the micro kernel to be large enough
565/// such that no stalls caused by the combination of latencies and dependencies
566/// are introduced during the updates of the resulting matrix of the matrix
567/// multiplication. However, they should also be as small as possible to
568/// release more registers for entries of multiplied matrices.
569///
570/// @param TTI Target Transform Info.
571/// @return The structure of type MicroKernelParamsTy.
572/// @see MicroKernelParamsTy
573static struct MicroKernelParamsTy
574getMicroKernelParams(const llvm::TargetTransformInfo *TTI) {
Roman Gareev42402c92016-06-22 09:52:37 +0000575 assert(TTI && "The target transform info should be provided.");
Roman Gareev2cb4d132016-07-25 07:27:59 +0000576
Roman Gareev42402c92016-06-22 09:52:37 +0000577 // Nvec - Number of double-precision floating-point numbers that can be hold
578 // by a vector register. Use 2 by default.
579 auto Nvec = TTI->getRegisterBitWidth(true) / 64;
580 if (Nvec == 0)
581 Nvec = 2;
582 int Nr =
583 ceil(sqrt(Nvec * LatencyVectorFma * ThrougputVectorFma) / Nvec) * Nvec;
584 int Mr = ceil(Nvec * LatencyVectorFma * ThrougputVectorFma / Nr);
Roman Gareev2cb4d132016-07-25 07:27:59 +0000585 return {Mr, Nr};
586}
587
Roman Gareev3a18a932016-07-25 09:42:53 +0000588/// Get parameters of the BLIS macro kernel.
589///
590/// During the computation of matrix multiplication, blocks of partitioned
591/// matrices are mapped to different layers of the memory hierarchy.
592/// To optimize data reuse, blocks should be ideally kept in cache between
593/// iterations. Since parameters of the macro kernel determine sizes of these
594/// blocks, there are upper and lower bounds on these parameters.
595///
596/// @param MicroKernelParams Parameters of the micro-kernel
597/// to be taken into account.
598/// @return The structure of type MacroKernelParamsTy.
599/// @see MacroKernelParamsTy
600/// @see MicroKernelParamsTy
601static struct MacroKernelParamsTy
602getMacroKernelParams(const MicroKernelParamsTy &MicroKernelParams) {
603 // According to www.cs.utexas.edu/users/flame/pubs/TOMS-BLIS-Analytical.pdf,
604 // it requires information about the first two levels of a cache to determine
605 // all the parameters of a macro-kernel. It also checks that an associativity
606 // degree of a cache level is greater than two. Otherwise, another algorithm
607 // for determination of the parameters should be used.
608 if (!(MicroKernelParams.Mr > 0 && MicroKernelParams.Nr > 0 &&
609 CacheLevelSizes.size() >= 2 && CacheLevelAssociativity.size() >= 2 &&
610 CacheLevelSizes[0] > 0 && CacheLevelSizes[1] > 0 &&
611 CacheLevelAssociativity[0] > 2 && CacheLevelAssociativity[1] > 2))
612 return {1, 1, 1};
Roman Gareev15db81e2016-12-15 12:00:57 +0000613 int Car = floor(
Roman Gareev3a18a932016-07-25 09:42:53 +0000614 (CacheLevelAssociativity[0] - 1) /
Roman Gareev8babe1a2016-12-15 11:47:38 +0000615 (1 + static_cast<double>(MicroKernelParams.Nr) / MicroKernelParams.Mr));
Roman Gareev15db81e2016-12-15 12:00:57 +0000616 int Kc = (Car * CacheLevelSizes[0]) /
Roman Gareev8babe1a2016-12-15 11:47:38 +0000617 (MicroKernelParams.Mr * CacheLevelAssociativity[0] * 8);
618 double Cac = static_cast<double>(Kc * 8 * CacheLevelAssociativity[1]) /
Roman Gareev3a18a932016-07-25 09:42:53 +0000619 CacheLevelSizes[1];
Roman Gareev8babe1a2016-12-15 11:47:38 +0000620 int Mc = floor((CacheLevelAssociativity[1] - 2) / Cac);
Roman Gareev15db81e2016-12-15 12:00:57 +0000621 int Nc = floor(1 / Cac);
Roman Gareev3a18a932016-07-25 09:42:53 +0000622 return {Mc, Nc, Kc};
623}
624
Tobias Grosserc80d6972016-09-02 06:33:33 +0000625/// Identify a memory access through the shape of its memory access relation.
Roman Gareev1c892e92016-08-15 12:22:54 +0000626///
627/// Identify the unique memory access in @p Stmt, that has an access relation
628/// equal to @p ExpectedAccessRelation.
629///
630/// @param Stmt The SCoP statement that contains the memory accesses under
631/// consideration.
632/// @param ExpectedAccessRelation The access relation that identifies
633/// the memory access.
634/// @return The memory access of @p Stmt whose memory access relation is equal
635/// to @p ExpectedAccessRelation. nullptr in case there is no or more
636/// than one such access.
637MemoryAccess *
638identifyAccessByAccessRelation(ScopStmt *Stmt,
639 __isl_take isl_map *ExpectedAccessRelation) {
640 if (isl_map_has_tuple_id(ExpectedAccessRelation, isl_dim_out))
641 ExpectedAccessRelation =
642 isl_map_reset_tuple_id(ExpectedAccessRelation, isl_dim_out);
643 MemoryAccess *IdentifiedAccess = nullptr;
644 for (auto *Access : *Stmt) {
645 auto *AccessRelation = Access->getAccessRelation();
646 AccessRelation = isl_map_reset_tuple_id(AccessRelation, isl_dim_out);
647 if (isl_map_is_equal(ExpectedAccessRelation, AccessRelation)) {
648 if (IdentifiedAccess) {
649 isl_map_free(AccessRelation);
650 isl_map_free(ExpectedAccessRelation);
651 return nullptr;
652 }
653 IdentifiedAccess = Access;
654 }
655 isl_map_free(AccessRelation);
656 }
657 isl_map_free(ExpectedAccessRelation);
658 return IdentifiedAccess;
659}
660
Roman Gareevb3224ad2016-09-14 06:26:09 +0000661/// Add constrains to @Dim dimension of @p ExtMap.
662///
663/// If @ExtMap has the following form [O0, O1, O2]->[I1, I2, I3],
664/// the following constraint will be added
665/// Bound * OM <= IM <= Bound * (OM + 1) - 1,
666/// where M is @p Dim and Bound is @p Bound.
667///
668/// @param ExtMap The isl map to be modified.
669/// @param Dim The output dimension to be modfied.
670/// @param Bound The value that is used to specify the constraint.
671/// @return The modified isl map
672__isl_give isl_map *
673addExtensionMapMatMulDimConstraint(__isl_take isl_map *ExtMap, unsigned Dim,
674 unsigned Bound) {
675 assert(Bound != 0);
676 auto *ExtMapSpace = isl_map_get_space(ExtMap);
677 auto *ConstrSpace = isl_local_space_from_space(ExtMapSpace);
678 auto *Constr =
679 isl_constraint_alloc_inequality(isl_local_space_copy(ConstrSpace));
680 Constr = isl_constraint_set_coefficient_si(Constr, isl_dim_out, Dim, 1);
681 Constr =
682 isl_constraint_set_coefficient_si(Constr, isl_dim_in, Dim, Bound * (-1));
683 ExtMap = isl_map_add_constraint(ExtMap, Constr);
684 Constr = isl_constraint_alloc_inequality(ConstrSpace);
685 Constr = isl_constraint_set_coefficient_si(Constr, isl_dim_out, Dim, -1);
686 Constr = isl_constraint_set_coefficient_si(Constr, isl_dim_in, Dim, Bound);
687 Constr = isl_constraint_set_constant_si(Constr, Bound - 1);
688 return isl_map_add_constraint(ExtMap, Constr);
689}
690
691/// Create an access relation that is specific for matrix multiplication
692/// pattern.
693///
694/// Create an access relation of the following form:
695/// { [O0, O1, O2]->[I1, I2, I3] :
696/// FirstOutputDimBound * O0 <= I1 <= FirstOutputDimBound * (O0 + 1) - 1
697/// and SecondOutputDimBound * O1 <= I2 <= SecondOutputDimBound * (O1 + 1) - 1
698/// and ThirdOutputDimBound * O2 <= I3 <= ThirdOutputDimBound * (O2 + 1) - 1}
699/// where FirstOutputDimBound is @p FirstOutputDimBound,
700/// SecondOutputDimBound is @p SecondOutputDimBound,
701/// ThirdOutputDimBound is @p ThirdOutputDimBound
702///
703/// @param Ctx The isl context.
704/// @param FirstOutputDimBound,
705/// SecondOutputDimBound,
706/// ThirdOutputDimBound The parameters of the access relation.
707/// @return The specified access relation.
708__isl_give isl_map *getMatMulExt(isl_ctx *Ctx, unsigned FirstOutputDimBound,
709 unsigned SecondOutputDimBound,
710 unsigned ThirdOutputDimBound) {
711 auto *NewRelSpace = isl_space_alloc(Ctx, 0, 3, 3);
712 auto *extensionMap = isl_map_universe(NewRelSpace);
713 if (!FirstOutputDimBound)
714 extensionMap = isl_map_fix_si(extensionMap, isl_dim_out, 0, 0);
715 else
716 extensionMap = addExtensionMapMatMulDimConstraint(extensionMap, 0,
717 FirstOutputDimBound);
718 if (!SecondOutputDimBound)
719 extensionMap = isl_map_fix_si(extensionMap, isl_dim_out, 1, 0);
720 else
721 extensionMap = addExtensionMapMatMulDimConstraint(extensionMap, 1,
722 SecondOutputDimBound);
723 if (!ThirdOutputDimBound)
724 extensionMap = isl_map_fix_si(extensionMap, isl_dim_out, 2, 0);
725 else
726 extensionMap = addExtensionMapMatMulDimConstraint(extensionMap, 2,
727 ThirdOutputDimBound);
728 return extensionMap;
729}
730
Tobias Grosserc80d6972016-09-02 06:33:33 +0000731/// Create an access relation that is specific to the matrix
Roman Gareev1c892e92016-08-15 12:22:54 +0000732/// multiplication pattern.
733///
734/// Create an access relation of the following form:
735/// Stmt[O0, O1, O2]->[OI, OJ],
736/// where I is @p I, J is @J
737///
738/// @param Stmt The SCoP statement for which to generate the access relation.
739/// @param I The index of the input dimension that is mapped to the first output
740/// dimension.
741/// @param J The index of the input dimension that is mapped to the second
742/// output dimension.
743/// @return The specified access relation.
744__isl_give isl_map *
745getMatMulPatternOriginalAccessRelation(ScopStmt *Stmt, unsigned I, unsigned J) {
746 auto *AccessRelSpace = isl_space_alloc(Stmt->getIslCtx(), 0, 3, 2);
747 auto *AccessRel = isl_map_universe(AccessRelSpace);
748 AccessRel = isl_map_equate(AccessRel, isl_dim_in, I, isl_dim_out, 0);
749 AccessRel = isl_map_equate(AccessRel, isl_dim_in, J, isl_dim_out, 1);
750 AccessRel = isl_map_set_tuple_id(AccessRel, isl_dim_in, Stmt->getDomainId());
751 return AccessRel;
752}
753
Tobias Grosserc80d6972016-09-02 06:33:33 +0000754/// Identify the memory access that corresponds to the access to the second
755/// operand of the matrix multiplication.
Roman Gareev1c892e92016-08-15 12:22:54 +0000756///
757/// Identify the memory access that corresponds to the access
758/// to the matrix B of the matrix multiplication C = A x B.
759///
760/// @param Stmt The SCoP statement that contains the memory accesses
761/// under consideration.
762/// @return The memory access of @p Stmt that corresponds to the access
763/// to the second operand of the matrix multiplication.
764MemoryAccess *identifyAccessA(ScopStmt *Stmt) {
765 auto *OriginalRel = getMatMulPatternOriginalAccessRelation(Stmt, 0, 2);
766 return identifyAccessByAccessRelation(Stmt, OriginalRel);
767}
768
Tobias Grosserc80d6972016-09-02 06:33:33 +0000769/// Identify the memory access that corresponds to the access to the first
770/// operand of the matrix multiplication.
Roman Gareev1c892e92016-08-15 12:22:54 +0000771///
772/// Identify the memory access that corresponds to the access
773/// to the matrix A of the matrix multiplication C = A x B.
774///
775/// @param Stmt The SCoP statement that contains the memory accesses
776/// under consideration.
777/// @return The memory access of @p Stmt that corresponds to the access
778/// to the first operand of the matrix multiplication.
779MemoryAccess *identifyAccessB(ScopStmt *Stmt) {
780 auto *OriginalRel = getMatMulPatternOriginalAccessRelation(Stmt, 2, 1);
781 return identifyAccessByAccessRelation(Stmt, OriginalRel);
782}
783
Tobias Grosserc80d6972016-09-02 06:33:33 +0000784/// Create an access relation that is specific to
Roman Gareev1c892e92016-08-15 12:22:54 +0000785/// the matrix multiplication pattern.
786///
787/// Create an access relation of the following form:
Roman Gareev92c44602016-12-21 11:18:42 +0000788/// [O0, O1, O2, O3, O4, O5, O6, O7, O8] -> [OI, O5, OJ]
789/// where I is @p FirstDim, J is @p SecondDim.
Roman Gareev1c892e92016-08-15 12:22:54 +0000790///
791/// It can be used, for example, to create relations that helps to consequently
792/// access elements of operands of a matrix multiplication after creation of
793/// the BLIS micro and macro kernels.
794///
795/// @see ScheduleTreeOptimizer::createMicroKernel
796/// @see ScheduleTreeOptimizer::createMacroKernel
797///
798/// Subsequently, the described access relation is applied to the range of
799/// @p MapOldIndVar, that is used to map original induction variables to
800/// the ones, which are produced by schedule transformations. It helps to
801/// define relations using a new space and, at the same time, keep them
802/// in the original one.
803///
804/// @param MapOldIndVar The relation, which maps original induction variables
805/// to the ones, which are produced by schedule
806/// transformations.
Roman Gareev1c892e92016-08-15 12:22:54 +0000807/// @param FirstDim, SecondDim The input dimensions that are used to define
808/// the specified access relation.
809/// @return The specified access relation.
810__isl_give isl_map *getMatMulAccRel(__isl_take isl_map *MapOldIndVar,
Roman Gareev92c44602016-12-21 11:18:42 +0000811 unsigned FirstDim, unsigned SecondDim) {
Roman Gareev1c892e92016-08-15 12:22:54 +0000812 auto *Ctx = isl_map_get_ctx(MapOldIndVar);
Roman Gareev92c44602016-12-21 11:18:42 +0000813 auto *AccessRelSpace = isl_space_alloc(Ctx, 0, 9, 3);
814 auto *AccessRel = isl_map_universe(AccessRelSpace);
815 AccessRel = isl_map_equate(AccessRel, isl_dim_in, FirstDim, isl_dim_out, 0);
816 AccessRel = isl_map_equate(AccessRel, isl_dim_in, 5, isl_dim_out, 1);
817 AccessRel = isl_map_equate(AccessRel, isl_dim_in, SecondDim, isl_dim_out, 2);
Roman Gareev1c892e92016-08-15 12:22:54 +0000818 return isl_map_apply_range(MapOldIndVar, AccessRel);
819}
820
Roman Gareevb3224ad2016-09-14 06:26:09 +0000821__isl_give isl_schedule_node *
822createExtensionNode(__isl_take isl_schedule_node *Node,
823 __isl_take isl_map *ExtensionMap) {
824 auto *Extension = isl_union_map_from_map(ExtensionMap);
825 auto *NewNode = isl_schedule_node_from_extension(Extension);
826 return isl_schedule_node_graft_before(Node, NewNode);
827}
828
Tobias Grosserc80d6972016-09-02 06:33:33 +0000829/// Apply the packing transformation.
Roman Gareev1c892e92016-08-15 12:22:54 +0000830///
831/// The packing transformation can be described as a data-layout
832/// transformation that requires to introduce a new array, copy data
833/// to the array, and change memory access locations of the compute kernel
834/// to reference the array.
835///
836/// @param Node The schedule node to be optimized.
837/// @param MapOldIndVar The relation, which maps original induction variables
838/// to the ones, which are produced by schedule
839/// transformations.
840/// @param MicroParams, MacroParams Parameters of the BLIS kernel
841/// to be taken into account.
842/// @return The optimized schedule node.
Roman Gareevb3224ad2016-09-14 06:26:09 +0000843static __isl_give isl_schedule_node *optimizeDataLayoutMatrMulPattern(
844 __isl_take isl_schedule_node *Node, __isl_take isl_map *MapOldIndVar,
845 MicroKernelParamsTy MicroParams, MacroKernelParamsTy MacroParams) {
Roman Gareev2606c482016-12-15 12:35:59 +0000846 // Check whether memory accesses of the SCoP statement correspond to
847 // the matrix multiplication pattern and if this is true, obtain them.
Roman Gareev1c892e92016-08-15 12:22:54 +0000848 auto InputDimsId = isl_map_get_tuple_id(MapOldIndVar, isl_dim_in);
849 auto *Stmt = static_cast<ScopStmt *>(isl_id_get_user(InputDimsId));
850 isl_id_free(InputDimsId);
851 MemoryAccess *MemAccessA = identifyAccessA(Stmt);
852 MemoryAccess *MemAccessB = identifyAccessB(Stmt);
853 if (!MemAccessA || !MemAccessB) {
854 isl_map_free(MapOldIndVar);
Roman Gareevb3224ad2016-09-14 06:26:09 +0000855 return Node;
Roman Gareev1c892e92016-08-15 12:22:54 +0000856 }
Roman Gareev2606c482016-12-15 12:35:59 +0000857
858 // Create a copy statement that corresponds to the memory access to the
859 // matrix B, the second operand of the matrix multiplication.
Roman Gareevb3224ad2016-09-14 06:26:09 +0000860 Node = isl_schedule_node_parent(isl_schedule_node_parent(Node));
861 Node = isl_schedule_node_parent(isl_schedule_node_parent(Node));
862 Node = isl_schedule_node_parent(Node);
863 Node = isl_schedule_node_child(isl_schedule_node_band_split(Node, 2), 0);
Roman Gareev92c44602016-12-21 11:18:42 +0000864 auto *AccRel = getMatMulAccRel(isl_map_copy(MapOldIndVar), 3, 7);
865 unsigned FirstDimSize = MacroParams.Nc / MicroParams.Nr;
866 unsigned SecondDimSize = MacroParams.Kc;
867 unsigned ThirdDimSize = MicroParams.Nr;
Roman Gareev1c892e92016-08-15 12:22:54 +0000868 auto *SAI = Stmt->getParent()->createScopArrayInfo(
Roman Gareev92c44602016-12-21 11:18:42 +0000869 MemAccessB->getElementType(), "Packed_B",
870 {FirstDimSize, SecondDimSize, ThirdDimSize});
Roman Gareev1c892e92016-08-15 12:22:54 +0000871 AccRel = isl_map_set_tuple_id(AccRel, isl_dim_out, SAI->getBasePtrId());
Roman Gareev8babe1a2016-12-15 11:47:38 +0000872 auto *OldAcc = MemAccessB->getAccessRelation();
873 MemAccessB->setNewAccessRelation(AccRel);
Roman Gareevb3224ad2016-09-14 06:26:09 +0000874 auto *ExtMap =
Roman Gareev8babe1a2016-12-15 11:47:38 +0000875 getMatMulExt(Stmt->getIslCtx(), 0, MacroParams.Nc, MacroParams.Kc);
876 isl_map_move_dims(ExtMap, isl_dim_out, 0, isl_dim_in, 0, 1);
877 isl_map_move_dims(ExtMap, isl_dim_in, 2, isl_dim_out, 0, 1);
878 ExtMap = isl_map_project_out(ExtMap, isl_dim_in, 2, 1);
Roman Gareevb3224ad2016-09-14 06:26:09 +0000879 auto *Domain = Stmt->getDomain();
Roman Gareev2606c482016-12-15 12:35:59 +0000880
881 // Restrict the domains of the copy statements to only execute when also its
882 // originating statement is executed.
883 auto *DomainId = isl_set_get_tuple_id(Domain);
Roman Gareevb3224ad2016-09-14 06:26:09 +0000884 auto *NewStmt = Stmt->getParent()->addScopStmt(
Roman Gareev8babe1a2016-12-15 11:47:38 +0000885 OldAcc, MemAccessB->getAccessRelation(), isl_set_copy(Domain));
Roman Gareev2606c482016-12-15 12:35:59 +0000886 ExtMap = isl_map_set_tuple_id(ExtMap, isl_dim_out, isl_id_copy(DomainId));
887 ExtMap = isl_map_intersect_range(ExtMap, isl_set_copy(Domain));
Roman Gareevb3224ad2016-09-14 06:26:09 +0000888 ExtMap = isl_map_set_tuple_id(ExtMap, isl_dim_out, NewStmt->getDomainId());
889 Node = createExtensionNode(Node, ExtMap);
Roman Gareev2606c482016-12-15 12:35:59 +0000890
891 // Create a copy statement that corresponds to the memory access
892 // to the matrix A, the first operand of the matrix multiplication.
Roman Gareevb3224ad2016-09-14 06:26:09 +0000893 Node = isl_schedule_node_child(Node, 0);
Roman Gareev92c44602016-12-21 11:18:42 +0000894 AccRel = getMatMulAccRel(MapOldIndVar, 4, 6);
895 FirstDimSize = MacroParams.Mc / MicroParams.Mr;
896 ThirdDimSize = MicroParams.Mr;
Roman Gareev1c892e92016-08-15 12:22:54 +0000897 SAI = Stmt->getParent()->createScopArrayInfo(
Roman Gareev92c44602016-12-21 11:18:42 +0000898 MemAccessA->getElementType(), "Packed_A",
899 {FirstDimSize, SecondDimSize, ThirdDimSize});
Roman Gareev1c892e92016-08-15 12:22:54 +0000900 AccRel = isl_map_set_tuple_id(AccRel, isl_dim_out, SAI->getBasePtrId());
Roman Gareev8babe1a2016-12-15 11:47:38 +0000901 OldAcc = MemAccessA->getAccessRelation();
902 MemAccessA->setNewAccessRelation(AccRel);
903 ExtMap = getMatMulExt(Stmt->getIslCtx(), MacroParams.Mc, 0, MacroParams.Kc);
904 isl_map_move_dims(ExtMap, isl_dim_out, 0, isl_dim_in, 0, 1);
Roman Gareevb3224ad2016-09-14 06:26:09 +0000905 isl_map_move_dims(ExtMap, isl_dim_in, 2, isl_dim_out, 0, 1);
906 NewStmt = Stmt->getParent()->addScopStmt(
Roman Gareev2606c482016-12-15 12:35:59 +0000907 OldAcc, MemAccessA->getAccessRelation(), isl_set_copy(Domain));
908
909 // Restrict the domains of the copy statements to only execute when also its
910 // originating statement is executed.
911 ExtMap = isl_map_set_tuple_id(ExtMap, isl_dim_out, DomainId);
912 ExtMap = isl_map_intersect_range(ExtMap, Domain);
Roman Gareevb3224ad2016-09-14 06:26:09 +0000913 ExtMap = isl_map_set_tuple_id(ExtMap, isl_dim_out, NewStmt->getDomainId());
914 Node = createExtensionNode(Node, ExtMap);
915 Node = isl_schedule_node_child(isl_schedule_node_child(Node, 0), 0);
916 return isl_schedule_node_child(isl_schedule_node_child(Node, 0), 0);
Roman Gareev1c892e92016-08-15 12:22:54 +0000917}
918
Tobias Grosserc80d6972016-09-02 06:33:33 +0000919/// Get a relation mapping induction variables produced by schedule
920/// transformations to the original ones.
Roman Gareev1c892e92016-08-15 12:22:54 +0000921///
922/// @param Node The schedule node produced as the result of creation
923/// of the BLIS kernels.
924/// @param MicroKernelParams, MacroKernelParams Parameters of the BLIS kernel
925/// to be taken into account.
926/// @return The relation mapping original induction variables to the ones
927/// produced by schedule transformation.
928/// @see ScheduleTreeOptimizer::createMicroKernel
929/// @see ScheduleTreeOptimizer::createMacroKernel
930/// @see getMacroKernelParams
931__isl_give isl_map *
932getInductionVariablesSubstitution(__isl_take isl_schedule_node *Node,
933 MicroKernelParamsTy MicroKernelParams,
934 MacroKernelParamsTy MacroKernelParams) {
935 auto *Child = isl_schedule_node_get_child(Node, 0);
936 auto *UnMapOldIndVar = isl_schedule_node_get_prefix_schedule_union_map(Child);
937 isl_schedule_node_free(Child);
938 auto *MapOldIndVar = isl_map_from_union_map(UnMapOldIndVar);
939 if (isl_map_dim(MapOldIndVar, isl_dim_out) > 9)
940 MapOldIndVar =
941 isl_map_project_out(MapOldIndVar, isl_dim_out, 0,
942 isl_map_dim(MapOldIndVar, isl_dim_out) - 9);
943 return MapOldIndVar;
944}
945
Roman Gareev2cb4d132016-07-25 07:27:59 +0000946__isl_give isl_schedule_node *ScheduleTreeOptimizer::optimizeMatMulPattern(
947 __isl_take isl_schedule_node *Node, const llvm::TargetTransformInfo *TTI) {
948 assert(TTI && "The target transform info should be provided.");
949 auto MicroKernelParams = getMicroKernelParams(TTI);
Roman Gareev3a18a932016-07-25 09:42:53 +0000950 auto MacroKernelParams = getMacroKernelParams(MicroKernelParams);
951 Node = createMacroKernel(Node, MacroKernelParams);
Roman Gareev2cb4d132016-07-25 07:27:59 +0000952 Node = createMicroKernel(Node, MicroKernelParams);
Roman Gareev1c892e92016-08-15 12:22:54 +0000953 if (MacroKernelParams.Mc == 1 || MacroKernelParams.Nc == 1 ||
954 MacroKernelParams.Kc == 1)
955 return Node;
956 auto *MapOldIndVar = getInductionVariablesSubstitution(
957 Node, MicroKernelParams, MacroKernelParams);
958 if (!MapOldIndVar)
959 return Node;
Roman Gareevb3224ad2016-09-14 06:26:09 +0000960 return optimizeDataLayoutMatrMulPattern(Node, MapOldIndVar, MicroKernelParams,
961 MacroKernelParams);
Roman Gareev42402c92016-06-22 09:52:37 +0000962}
963
Roman Gareev9c3eb592016-05-28 16:17:58 +0000964bool ScheduleTreeOptimizer::isMatrMultPattern(
965 __isl_keep isl_schedule_node *Node) {
966 auto *PartialSchedule =
967 isl_schedule_node_band_get_partial_schedule_union_map(Node);
Roman Gareev397a34a2016-06-22 12:11:30 +0000968 if (isl_schedule_node_band_n_member(Node) != 3 ||
969 isl_union_map_n_map(PartialSchedule) != 1) {
970 isl_union_map_free(PartialSchedule);
Roman Gareev9c3eb592016-05-28 16:17:58 +0000971 return false;
972 }
Roman Gareev397a34a2016-06-22 12:11:30 +0000973 auto *NewPartialSchedule = isl_map_from_union_map(PartialSchedule);
Roman Gareev9c3eb592016-05-28 16:17:58 +0000974 NewPartialSchedule = circularShiftOutputDims(NewPartialSchedule);
975 if (containsMatrMult(NewPartialSchedule)) {
976 isl_map_free(NewPartialSchedule);
977 return true;
978 }
979 isl_map_free(NewPartialSchedule);
980 return false;
981}
982
983__isl_give isl_schedule_node *
984ScheduleTreeOptimizer::optimizeBand(__isl_take isl_schedule_node *Node,
985 void *User) {
986 if (!isTileableBandNode(Node))
987 return Node;
988
Roman Gareev42402c92016-06-22 09:52:37 +0000989 if (PMBasedOpts && User && isMatrMultPattern(Node)) {
Roman Gareev9c3eb592016-05-28 16:17:58 +0000990 DEBUG(dbgs() << "The matrix multiplication pattern was detected\n");
Roman Gareev42402c92016-06-22 09:52:37 +0000991 const llvm::TargetTransformInfo *TTI;
992 TTI = static_cast<const llvm::TargetTransformInfo *>(User);
993 Node = optimizeMatMulPattern(Node, TTI);
994 }
Roman Gareev9c3eb592016-05-28 16:17:58 +0000995
996 return standardBandOpts(Node, User);
997}
998
Tobias Grosser808cd692015-07-14 09:33:13 +0000999__isl_give isl_schedule *
Roman Gareev42402c92016-06-22 09:52:37 +00001000ScheduleTreeOptimizer::optimizeSchedule(__isl_take isl_schedule *Schedule,
1001 const llvm::TargetTransformInfo *TTI) {
Tobias Grosserbbb4cec2015-03-22 12:06:39 +00001002 isl_schedule_node *Root = isl_schedule_get_root(Schedule);
Roman Gareev42402c92016-06-22 09:52:37 +00001003 Root = optimizeScheduleNode(Root, TTI);
Tobias Grosser808cd692015-07-14 09:33:13 +00001004 isl_schedule_free(Schedule);
Tobias Grosser808cd692015-07-14 09:33:13 +00001005 auto S = isl_schedule_node_get_schedule(Root);
Tobias Grosserbbb4cec2015-03-22 12:06:39 +00001006 isl_schedule_node_free(Root);
Tobias Grosser808cd692015-07-14 09:33:13 +00001007 return S;
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001008}
1009
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001010__isl_give isl_schedule_node *ScheduleTreeOptimizer::optimizeScheduleNode(
Roman Gareev42402c92016-06-22 09:52:37 +00001011 __isl_take isl_schedule_node *Node, const llvm::TargetTransformInfo *TTI) {
1012 Node = isl_schedule_node_map_descendant_bottom_up(
1013 Node, optimizeBand, const_cast<void *>(static_cast<const void *>(TTI)));
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001014 return Node;
1015}
1016
1017bool ScheduleTreeOptimizer::isProfitableSchedule(
Roman Gareevb3224ad2016-09-14 06:26:09 +00001018 Scop &S, __isl_keep isl_schedule *NewSchedule) {
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001019 // To understand if the schedule has been optimized we check if the schedule
1020 // has changed at all.
1021 // TODO: We can improve this by tracking if any necessarily beneficial
1022 // transformations have been performed. This can e.g. be tiling, loop
1023 // interchange, or ...) We can track this either at the place where the
1024 // transformation has been performed or, in case of automatic ILP based
1025 // optimizations, by comparing (yet to be defined) performance metrics
1026 // before/after the scheduling optimizer
1027 // (e.g., #stride-one accesses)
Roman Gareevb3224ad2016-09-14 06:26:09 +00001028 if (S.containsExtensionNode(NewSchedule))
1029 return true;
1030 auto *NewScheduleMap = isl_schedule_get_map(NewSchedule);
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001031 isl_union_map *OldSchedule = S.getSchedule();
Roman Gareevb3224ad2016-09-14 06:26:09 +00001032 assert(OldSchedule && "Only IslScheduleOptimizer can insert extension nodes "
1033 "that make Scop::getSchedule() return nullptr.");
1034 bool changed = !isl_union_map_is_equal(OldSchedule, NewScheduleMap);
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001035 isl_union_map_free(OldSchedule);
Roman Gareevb3224ad2016-09-14 06:26:09 +00001036 isl_union_map_free(NewScheduleMap);
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001037 return changed;
1038}
1039
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001040namespace {
1041class IslScheduleOptimizer : public ScopPass {
1042public:
1043 static char ID;
1044 explicit IslScheduleOptimizer() : ScopPass(ID) { LastSchedule = nullptr; }
1045
1046 ~IslScheduleOptimizer() { isl_schedule_free(LastSchedule); }
1047
Tobias Grosserc80d6972016-09-02 06:33:33 +00001048 /// Optimize the schedule of the SCoP @p S.
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001049 bool runOnScop(Scop &S) override;
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001050
Tobias Grosserc80d6972016-09-02 06:33:33 +00001051 /// Print the new schedule for the SCoP @p S.
Johannes Doerfert45be6442015-09-27 15:43:29 +00001052 void printScop(raw_ostream &OS, Scop &S) const override;
1053
Tobias Grosserc80d6972016-09-02 06:33:33 +00001054 /// Register all analyses and transformation required.
Johannes Doerfert45be6442015-09-27 15:43:29 +00001055 void getAnalysisUsage(AnalysisUsage &AU) const override;
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001056
Tobias Grosserc80d6972016-09-02 06:33:33 +00001057 /// Release the internal memory.
Johannes Doerfert0f376302015-09-27 15:42:28 +00001058 void releaseMemory() override {
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001059 isl_schedule_free(LastSchedule);
1060 LastSchedule = nullptr;
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001061 }
Johannes Doerfert45be6442015-09-27 15:43:29 +00001062
1063private:
1064 isl_schedule *LastSchedule;
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001065};
Tobias Grosser522478d2016-06-23 22:17:27 +00001066} // namespace
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001067
1068char IslScheduleOptimizer::ID = 0;
1069
Tobias Grosser73600b82011-10-08 00:30:40 +00001070bool IslScheduleOptimizer::runOnScop(Scop &S) {
Johannes Doerfert6f7921f2015-02-14 12:02:24 +00001071
1072 // Skip empty SCoPs but still allow code generation as it will delete the
1073 // loops present but not needed.
1074 if (S.getSize() == 0) {
1075 S.markAsOptimized();
1076 return false;
1077 }
1078
Hongbin Zheng2a798852016-03-03 08:15:33 +00001079 const Dependences &D =
1080 getAnalysis<DependenceInfo>().getDependences(Dependences::AL_Statement);
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001081
Johannes Doerfert7e6424b2015-03-05 00:43:48 +00001082 if (!D.hasValidDependences())
Tobias Grosser38c36ea2014-02-23 15:15:44 +00001083 return false;
1084
Tobias Grosser28781422012-10-16 07:29:19 +00001085 isl_schedule_free(LastSchedule);
Tobias Grosser5a56cbf2014-04-16 07:33:47 +00001086 LastSchedule = nullptr;
Tobias Grosser28781422012-10-16 07:29:19 +00001087
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001088 // Build input data.
Johannes Doerfert7e6424b2015-03-05 00:43:48 +00001089 int ValidityKinds =
1090 Dependences::TYPE_RAW | Dependences::TYPE_WAR | Dependences::TYPE_WAW;
Tobias Grosser1deda292012-02-14 14:02:48 +00001091 int ProximityKinds;
1092
1093 if (OptimizeDeps == "all")
Johannes Doerfert7e6424b2015-03-05 00:43:48 +00001094 ProximityKinds =
1095 Dependences::TYPE_RAW | Dependences::TYPE_WAR | Dependences::TYPE_WAW;
Tobias Grosser1deda292012-02-14 14:02:48 +00001096 else if (OptimizeDeps == "raw")
Johannes Doerfert7e6424b2015-03-05 00:43:48 +00001097 ProximityKinds = Dependences::TYPE_RAW;
Tobias Grosser1deda292012-02-14 14:02:48 +00001098 else {
1099 errs() << "Do not know how to optimize for '" << OptimizeDeps << "'"
Tobias Grosser4d96c8d2013-03-23 01:05:07 +00001100 << " Falling back to optimizing all dependences.\n";
Johannes Doerfert7e6424b2015-03-05 00:43:48 +00001101 ProximityKinds =
1102 Dependences::TYPE_RAW | Dependences::TYPE_WAR | Dependences::TYPE_WAW;
Tobias Grosser1deda292012-02-14 14:02:48 +00001103 }
1104
Tobias Grosser5f9a7622012-02-14 14:02:40 +00001105 isl_union_set *Domain = S.getDomains();
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001106
Tobias Grosser98610ee2012-02-13 23:31:39 +00001107 if (!Domain)
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001108 return false;
1109
Johannes Doerfert7e6424b2015-03-05 00:43:48 +00001110 isl_union_map *Validity = D.getDependences(ValidityKinds);
1111 isl_union_map *Proximity = D.getDependences(ProximityKinds);
Tobias Grosser8a507022012-03-16 11:51:41 +00001112
Tobias Grossera26db472012-01-30 19:38:43 +00001113 // Simplify the dependences by removing the constraints introduced by the
1114 // domains. This can speed up the scheduling time significantly, as large
1115 // constant coefficients will be removed from the dependences. The
1116 // introduction of some additional dependences reduces the possible
1117 // transformations, but in most cases, such transformation do not seem to be
1118 // interesting anyway. In some cases this option may stop the scheduler to
1119 // find any schedule.
1120 if (SimplifyDeps == "yes") {
Tobias Grosser00383a72012-02-14 14:02:44 +00001121 Validity = isl_union_map_gist_domain(Validity, isl_union_set_copy(Domain));
1122 Validity = isl_union_map_gist_range(Validity, isl_union_set_copy(Domain));
Tobias Grosser4d96c8d2013-03-23 01:05:07 +00001123 Proximity =
1124 isl_union_map_gist_domain(Proximity, isl_union_set_copy(Domain));
Tobias Grosser00383a72012-02-14 14:02:44 +00001125 Proximity = isl_union_map_gist_range(Proximity, isl_union_set_copy(Domain));
Tobias Grossera26db472012-01-30 19:38:43 +00001126 } else if (SimplifyDeps != "no") {
1127 errs() << "warning: Option -polly-opt-simplify-deps should either be 'yes' "
1128 "or 'no'. Falling back to default: 'yes'\n";
1129 }
1130
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001131 DEBUG(dbgs() << "\n\nCompute schedule from: ");
Tobias Grosser01aea582014-10-22 23:16:28 +00001132 DEBUG(dbgs() << "Domain := " << stringFromIslObj(Domain) << ";\n");
1133 DEBUG(dbgs() << "Proximity := " << stringFromIslObj(Proximity) << ";\n");
1134 DEBUG(dbgs() << "Validity := " << stringFromIslObj(Validity) << ";\n");
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001135
Michael Krusec59f22c2015-06-18 16:45:40 +00001136 unsigned IslSerializeSCCs;
Tobias Grosserb3ad85b2012-01-30 19:38:50 +00001137
1138 if (FusionStrategy == "max") {
Michael Krusec59f22c2015-06-18 16:45:40 +00001139 IslSerializeSCCs = 0;
Tobias Grosserb3ad85b2012-01-30 19:38:50 +00001140 } else if (FusionStrategy == "min") {
Michael Krusec59f22c2015-06-18 16:45:40 +00001141 IslSerializeSCCs = 1;
Tobias Grosserb3ad85b2012-01-30 19:38:50 +00001142 } else {
1143 errs() << "warning: Unknown fusion strategy. Falling back to maximal "
1144 "fusion.\n";
Michael Krusec59f22c2015-06-18 16:45:40 +00001145 IslSerializeSCCs = 0;
Tobias Grosserb3ad85b2012-01-30 19:38:50 +00001146 }
1147
Tobias Grosser95e860c2012-01-30 19:38:54 +00001148 int IslMaximizeBands;
1149
Tobias Grossera4ea90b2012-01-30 22:43:56 +00001150 if (MaximizeBandDepth == "yes") {
Tobias Grosser95e860c2012-01-30 19:38:54 +00001151 IslMaximizeBands = 1;
Tobias Grossera4ea90b2012-01-30 22:43:56 +00001152 } else if (MaximizeBandDepth == "no") {
Tobias Grosser95e860c2012-01-30 19:38:54 +00001153 IslMaximizeBands = 0;
1154 } else {
1155 errs() << "warning: Option -polly-opt-maximize-bands should either be 'yes'"
1156 " or 'no'. Falling back to default: 'yes'\n";
1157 IslMaximizeBands = 1;
1158 }
1159
Michael Kruse315aa322016-05-02 11:35:27 +00001160 int IslOuterCoincidence;
1161
1162 if (OuterCoincidence == "yes") {
1163 IslOuterCoincidence = 1;
1164 } else if (OuterCoincidence == "no") {
1165 IslOuterCoincidence = 0;
1166 } else {
1167 errs() << "warning: Option -polly-opt-outer-coincidence should either be "
1168 "'yes' or 'no'. Falling back to default: 'no'\n";
1169 IslOuterCoincidence = 0;
1170 }
1171
Tobias Grosseraf149932016-06-30 20:42:56 +00001172 isl_ctx *Ctx = S.getIslCtx();
Tobias Grosser42152ff2012-01-30 19:38:47 +00001173
Tobias Grosseraf149932016-06-30 20:42:56 +00001174 isl_options_set_schedule_outer_coincidence(Ctx, IslOuterCoincidence);
1175 isl_options_set_schedule_serialize_sccs(Ctx, IslSerializeSCCs);
1176 isl_options_set_schedule_maximize_band_depth(Ctx, IslMaximizeBands);
1177 isl_options_set_schedule_max_constant_term(Ctx, MaxConstantTerm);
1178 isl_options_set_schedule_max_coefficient(Ctx, MaxCoefficient);
1179 isl_options_set_tile_scale_tile_loops(Ctx, 0);
1180
Tobias Grosser3898a042016-06-30 20:42:58 +00001181 auto OnErrorStatus = isl_options_get_on_error(Ctx);
Tobias Grosseraf149932016-06-30 20:42:56 +00001182 isl_options_set_on_error(Ctx, ISL_ON_ERROR_CONTINUE);
Tobias Grossera38c9242014-01-26 19:36:28 +00001183
1184 isl_schedule_constraints *ScheduleConstraints;
1185 ScheduleConstraints = isl_schedule_constraints_on_domain(Domain);
1186 ScheduleConstraints =
1187 isl_schedule_constraints_set_proximity(ScheduleConstraints, Proximity);
1188 ScheduleConstraints = isl_schedule_constraints_set_validity(
1189 ScheduleConstraints, isl_union_map_copy(Validity));
1190 ScheduleConstraints =
1191 isl_schedule_constraints_set_coincidence(ScheduleConstraints, Validity);
Tobias Grosser00383a72012-02-14 14:02:44 +00001192 isl_schedule *Schedule;
Tobias Grossera38c9242014-01-26 19:36:28 +00001193 Schedule = isl_schedule_constraints_compute_schedule(ScheduleConstraints);
Tobias Grosser3898a042016-06-30 20:42:58 +00001194 isl_options_set_on_error(Ctx, OnErrorStatus);
Tobias Grosser42152ff2012-01-30 19:38:47 +00001195
1196 // In cases the scheduler is not able to optimize the code, we just do not
1197 // touch the schedule.
Tobias Grosser98610ee2012-02-13 23:31:39 +00001198 if (!Schedule)
Tobias Grosser42152ff2012-01-30 19:38:47 +00001199 return false;
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001200
Tobias Grosser97d87452015-05-30 06:46:59 +00001201 DEBUG({
Tobias Grosseraf149932016-06-30 20:42:56 +00001202 auto *P = isl_printer_to_str(Ctx);
Tobias Grosser97d87452015-05-30 06:46:59 +00001203 P = isl_printer_set_yaml_style(P, ISL_YAML_STYLE_BLOCK);
1204 P = isl_printer_print_schedule(P, Schedule);
Michael Kruse79c01732016-12-12 14:51:06 +00001205 auto *str = isl_printer_get_str(P);
1206 dbgs() << "NewScheduleTree: \n" << str << "\n";
1207 free(str);
Tobias Grosser97d87452015-05-30 06:46:59 +00001208 isl_printer_free(P);
1209 });
Tobias Grosser4d63b9d2012-02-20 08:41:21 +00001210
Roman Gareev42402c92016-06-22 09:52:37 +00001211 Function &F = S.getFunction();
1212 auto *TTI = &getAnalysis<TargetTransformInfoWrapperPass>().getTTI(F);
1213 isl_schedule *NewSchedule =
1214 ScheduleTreeOptimizer::optimizeSchedule(Schedule, TTI);
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001215
Roman Gareevb3224ad2016-09-14 06:26:09 +00001216 if (!ScheduleTreeOptimizer::isProfitableSchedule(S, NewSchedule)) {
Tobias Grosser808cd692015-07-14 09:33:13 +00001217 isl_schedule_free(NewSchedule);
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001218 return false;
1219 }
1220
Tobias Grosser808cd692015-07-14 09:33:13 +00001221 S.setScheduleTree(NewSchedule);
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001222 S.markAsOptimized();
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001223
Roman Gareev5f99f862016-08-21 11:20:39 +00001224 if (OptimizedScops)
1225 S.dump();
1226
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001227 return false;
1228}
1229
Johannes Doerfert3fe584d2015-03-01 18:40:25 +00001230void IslScheduleOptimizer::printScop(raw_ostream &OS, Scop &) const {
Tobias Grosser28781422012-10-16 07:29:19 +00001231 isl_printer *p;
1232 char *ScheduleStr;
1233
1234 OS << "Calculated schedule:\n";
1235
1236 if (!LastSchedule) {
1237 OS << "n/a\n";
1238 return;
1239 }
1240
1241 p = isl_printer_to_str(isl_schedule_get_ctx(LastSchedule));
1242 p = isl_printer_print_schedule(p, LastSchedule);
1243 ScheduleStr = isl_printer_get_str(p);
1244 isl_printer_free(p);
1245
1246 OS << ScheduleStr << "\n";
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001247}
1248
Tobias Grosser73600b82011-10-08 00:30:40 +00001249void IslScheduleOptimizer::getAnalysisUsage(AnalysisUsage &AU) const {
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001250 ScopPass::getAnalysisUsage(AU);
Johannes Doerfertf6557f92015-03-04 22:43:40 +00001251 AU.addRequired<DependenceInfo>();
Roman Gareev42402c92016-06-22 09:52:37 +00001252 AU.addRequired<TargetTransformInfoWrapperPass>();
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001253}
1254
Tobias Grosser4d96c8d2013-03-23 01:05:07 +00001255Pass *polly::createIslScheduleOptimizerPass() {
Tobias Grosser73600b82011-10-08 00:30:40 +00001256 return new IslScheduleOptimizer();
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001257}
Tobias Grosser4d96c8d2013-03-23 01:05:07 +00001258
1259INITIALIZE_PASS_BEGIN(IslScheduleOptimizer, "polly-opt-isl",
1260 "Polly - Optimize schedule of SCoP", false, false);
Johannes Doerfertf6557f92015-03-04 22:43:40 +00001261INITIALIZE_PASS_DEPENDENCY(DependenceInfo);
Johannes Doerfert99191c72016-05-31 09:41:04 +00001262INITIALIZE_PASS_DEPENDENCY(ScopInfoRegionPass);
Roman Gareev42402c92016-06-22 09:52:37 +00001263INITIALIZE_PASS_DEPENDENCY(TargetTransformInfoWrapperPass);
Tobias Grosser4d96c8d2013-03-23 01:05:07 +00001264INITIALIZE_PASS_END(IslScheduleOptimizer, "polly-opt-isl",
1265 "Polly - Optimize schedule of SCoP", false, false)