blob: 7f68573cc775b408a365b1c784f46228711b49e2 [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 Gareevf5aff702016-09-12 17:08:31 +0000788/// [O0, O1, O2, O3, O4, O5, O6, O7, O8] -> [O5 + K * OI, OJ],
Roman Gareev1c892e92016-08-15 12:22:54 +0000789/// where K is @p Coeff, I is @p FirstDim, J is @p SecondDim.
790///
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.
807/// @param Coeff The coefficient that is used to define the specified access
808/// relation.
809/// @param FirstDim, SecondDim The input dimensions that are used to define
810/// the specified access relation.
811/// @return The specified access relation.
812__isl_give isl_map *getMatMulAccRel(__isl_take isl_map *MapOldIndVar,
813 unsigned Coeff, unsigned FirstDim,
814 unsigned SecondDim) {
815 auto *Ctx = isl_map_get_ctx(MapOldIndVar);
Roman Gareevf5aff702016-09-12 17:08:31 +0000816 auto *AccessRelSpace = isl_space_alloc(Ctx, 0, 9, 2);
Roman Gareev1c892e92016-08-15 12:22:54 +0000817 auto *AccessRel = isl_map_universe(isl_space_copy(AccessRelSpace));
818 auto *ConstrSpace = isl_local_space_from_space(AccessRelSpace);
819 auto *Constr = isl_constraint_alloc_equality(ConstrSpace);
Roman Gareevf5aff702016-09-12 17:08:31 +0000820 Constr = isl_constraint_set_coefficient_si(Constr, isl_dim_out, 0, -1);
Roman Gareev1c892e92016-08-15 12:22:54 +0000821 Constr = isl_constraint_set_coefficient_si(Constr, isl_dim_in, 5, 1);
822 Constr =
823 isl_constraint_set_coefficient_si(Constr, isl_dim_in, FirstDim, Coeff);
824 AccessRel = isl_map_add_constraint(AccessRel, Constr);
Roman Gareevf5aff702016-09-12 17:08:31 +0000825 AccessRel = isl_map_equate(AccessRel, isl_dim_in, SecondDim, isl_dim_out, 1);
Roman Gareev1c892e92016-08-15 12:22:54 +0000826 return isl_map_apply_range(MapOldIndVar, AccessRel);
827}
828
Roman Gareevb3224ad2016-09-14 06:26:09 +0000829__isl_give isl_schedule_node *
830createExtensionNode(__isl_take isl_schedule_node *Node,
831 __isl_take isl_map *ExtensionMap) {
832 auto *Extension = isl_union_map_from_map(ExtensionMap);
833 auto *NewNode = isl_schedule_node_from_extension(Extension);
834 return isl_schedule_node_graft_before(Node, NewNode);
835}
836
Tobias Grosserc80d6972016-09-02 06:33:33 +0000837/// Apply the packing transformation.
Roman Gareev1c892e92016-08-15 12:22:54 +0000838///
839/// The packing transformation can be described as a data-layout
840/// transformation that requires to introduce a new array, copy data
841/// to the array, and change memory access locations of the compute kernel
842/// to reference the array.
843///
844/// @param Node The schedule node to be optimized.
845/// @param MapOldIndVar The relation, which maps original induction variables
846/// to the ones, which are produced by schedule
847/// transformations.
848/// @param MicroParams, MacroParams Parameters of the BLIS kernel
849/// to be taken into account.
850/// @return The optimized schedule node.
Roman Gareevb3224ad2016-09-14 06:26:09 +0000851static __isl_give isl_schedule_node *optimizeDataLayoutMatrMulPattern(
852 __isl_take isl_schedule_node *Node, __isl_take isl_map *MapOldIndVar,
853 MicroKernelParamsTy MicroParams, MacroKernelParamsTy MacroParams) {
Roman Gareev2606c482016-12-15 12:35:59 +0000854 // Check whether memory accesses of the SCoP statement correspond to
855 // the matrix multiplication pattern and if this is true, obtain them.
Roman Gareev1c892e92016-08-15 12:22:54 +0000856 auto InputDimsId = isl_map_get_tuple_id(MapOldIndVar, isl_dim_in);
857 auto *Stmt = static_cast<ScopStmt *>(isl_id_get_user(InputDimsId));
858 isl_id_free(InputDimsId);
859 MemoryAccess *MemAccessA = identifyAccessA(Stmt);
860 MemoryAccess *MemAccessB = identifyAccessB(Stmt);
861 if (!MemAccessA || !MemAccessB) {
862 isl_map_free(MapOldIndVar);
Roman Gareevb3224ad2016-09-14 06:26:09 +0000863 return Node;
Roman Gareev1c892e92016-08-15 12:22:54 +0000864 }
Roman Gareev2606c482016-12-15 12:35:59 +0000865
866 // Create a copy statement that corresponds to the memory access to the
867 // matrix B, the second operand of the matrix multiplication.
Roman Gareevb3224ad2016-09-14 06:26:09 +0000868 Node = isl_schedule_node_parent(isl_schedule_node_parent(Node));
869 Node = isl_schedule_node_parent(isl_schedule_node_parent(Node));
870 Node = isl_schedule_node_parent(Node);
871 Node = isl_schedule_node_child(isl_schedule_node_band_split(Node, 2), 0);
Roman Gareev1c892e92016-08-15 12:22:54 +0000872 auto *AccRel =
Roman Gareev8babe1a2016-12-15 11:47:38 +0000873 getMatMulAccRel(isl_map_copy(MapOldIndVar), MacroParams.Kc, 3, 7);
874 unsigned FirstDimSize = MacroParams.Nc * MacroParams.Kc / MicroParams.Nr;
875 unsigned SecondDimSize = MicroParams.Nr;
Roman Gareev1c892e92016-08-15 12:22:54 +0000876 auto *SAI = Stmt->getParent()->createScopArrayInfo(
Roman Gareev8babe1a2016-12-15 11:47:38 +0000877 MemAccessB->getElementType(), "Packed_B", {FirstDimSize, SecondDimSize});
Roman Gareev1c892e92016-08-15 12:22:54 +0000878 AccRel = isl_map_set_tuple_id(AccRel, isl_dim_out, SAI->getBasePtrId());
Roman Gareev8babe1a2016-12-15 11:47:38 +0000879 auto *OldAcc = MemAccessB->getAccessRelation();
880 MemAccessB->setNewAccessRelation(AccRel);
Roman Gareevb3224ad2016-09-14 06:26:09 +0000881 auto *ExtMap =
Roman Gareev8babe1a2016-12-15 11:47:38 +0000882 getMatMulExt(Stmt->getIslCtx(), 0, MacroParams.Nc, MacroParams.Kc);
883 isl_map_move_dims(ExtMap, isl_dim_out, 0, isl_dim_in, 0, 1);
884 isl_map_move_dims(ExtMap, isl_dim_in, 2, isl_dim_out, 0, 1);
885 ExtMap = isl_map_project_out(ExtMap, isl_dim_in, 2, 1);
Roman Gareevb3224ad2016-09-14 06:26:09 +0000886 auto *Domain = Stmt->getDomain();
Roman Gareev2606c482016-12-15 12:35:59 +0000887
888 // Restrict the domains of the copy statements to only execute when also its
889 // originating statement is executed.
890 auto *DomainId = isl_set_get_tuple_id(Domain);
Roman Gareevb3224ad2016-09-14 06:26:09 +0000891 auto *NewStmt = Stmt->getParent()->addScopStmt(
Roman Gareev8babe1a2016-12-15 11:47:38 +0000892 OldAcc, MemAccessB->getAccessRelation(), isl_set_copy(Domain));
Roman Gareev2606c482016-12-15 12:35:59 +0000893 ExtMap = isl_map_set_tuple_id(ExtMap, isl_dim_out, isl_id_copy(DomainId));
894 ExtMap = isl_map_intersect_range(ExtMap, isl_set_copy(Domain));
Roman Gareevb3224ad2016-09-14 06:26:09 +0000895 ExtMap = isl_map_set_tuple_id(ExtMap, isl_dim_out, NewStmt->getDomainId());
896 Node = createExtensionNode(Node, ExtMap);
Roman Gareev2606c482016-12-15 12:35:59 +0000897
898 // Create a copy statement that corresponds to the memory access
899 // to the matrix A, the first operand of the matrix multiplication.
Roman Gareevb3224ad2016-09-14 06:26:09 +0000900 Node = isl_schedule_node_child(Node, 0);
Roman Gareev8babe1a2016-12-15 11:47:38 +0000901 AccRel = getMatMulAccRel(MapOldIndVar, MacroParams.Kc, 4, 6);
902 FirstDimSize = MacroParams.Mc * MacroParams.Kc / MicroParams.Mr;
903 SecondDimSize = MicroParams.Mr;
Roman Gareev1c892e92016-08-15 12:22:54 +0000904 SAI = Stmt->getParent()->createScopArrayInfo(
Roman Gareev8babe1a2016-12-15 11:47:38 +0000905 MemAccessA->getElementType(), "Packed_A", {FirstDimSize, SecondDimSize});
Roman Gareev1c892e92016-08-15 12:22:54 +0000906 AccRel = isl_map_set_tuple_id(AccRel, isl_dim_out, SAI->getBasePtrId());
Roman Gareev8babe1a2016-12-15 11:47:38 +0000907 OldAcc = MemAccessA->getAccessRelation();
908 MemAccessA->setNewAccessRelation(AccRel);
909 ExtMap = getMatMulExt(Stmt->getIslCtx(), MacroParams.Mc, 0, MacroParams.Kc);
910 isl_map_move_dims(ExtMap, isl_dim_out, 0, isl_dim_in, 0, 1);
Roman Gareevb3224ad2016-09-14 06:26:09 +0000911 isl_map_move_dims(ExtMap, isl_dim_in, 2, isl_dim_out, 0, 1);
912 NewStmt = Stmt->getParent()->addScopStmt(
Roman Gareev2606c482016-12-15 12:35:59 +0000913 OldAcc, MemAccessA->getAccessRelation(), isl_set_copy(Domain));
914
915 // Restrict the domains of the copy statements to only execute when also its
916 // originating statement is executed.
917 ExtMap = isl_map_set_tuple_id(ExtMap, isl_dim_out, DomainId);
918 ExtMap = isl_map_intersect_range(ExtMap, Domain);
Roman Gareevb3224ad2016-09-14 06:26:09 +0000919 ExtMap = isl_map_set_tuple_id(ExtMap, isl_dim_out, NewStmt->getDomainId());
920 Node = createExtensionNode(Node, ExtMap);
921 Node = isl_schedule_node_child(isl_schedule_node_child(Node, 0), 0);
922 return isl_schedule_node_child(isl_schedule_node_child(Node, 0), 0);
Roman Gareev1c892e92016-08-15 12:22:54 +0000923}
924
Tobias Grosserc80d6972016-09-02 06:33:33 +0000925/// Get a relation mapping induction variables produced by schedule
926/// transformations to the original ones.
Roman Gareev1c892e92016-08-15 12:22:54 +0000927///
928/// @param Node The schedule node produced as the result of creation
929/// of the BLIS kernels.
930/// @param MicroKernelParams, MacroKernelParams Parameters of the BLIS kernel
931/// to be taken into account.
932/// @return The relation mapping original induction variables to the ones
933/// produced by schedule transformation.
934/// @see ScheduleTreeOptimizer::createMicroKernel
935/// @see ScheduleTreeOptimizer::createMacroKernel
936/// @see getMacroKernelParams
937__isl_give isl_map *
938getInductionVariablesSubstitution(__isl_take isl_schedule_node *Node,
939 MicroKernelParamsTy MicroKernelParams,
940 MacroKernelParamsTy MacroKernelParams) {
941 auto *Child = isl_schedule_node_get_child(Node, 0);
942 auto *UnMapOldIndVar = isl_schedule_node_get_prefix_schedule_union_map(Child);
943 isl_schedule_node_free(Child);
944 auto *MapOldIndVar = isl_map_from_union_map(UnMapOldIndVar);
945 if (isl_map_dim(MapOldIndVar, isl_dim_out) > 9)
946 MapOldIndVar =
947 isl_map_project_out(MapOldIndVar, isl_dim_out, 0,
948 isl_map_dim(MapOldIndVar, isl_dim_out) - 9);
949 return MapOldIndVar;
950}
951
Roman Gareev2cb4d132016-07-25 07:27:59 +0000952__isl_give isl_schedule_node *ScheduleTreeOptimizer::optimizeMatMulPattern(
953 __isl_take isl_schedule_node *Node, const llvm::TargetTransformInfo *TTI) {
954 assert(TTI && "The target transform info should be provided.");
955 auto MicroKernelParams = getMicroKernelParams(TTI);
Roman Gareev3a18a932016-07-25 09:42:53 +0000956 auto MacroKernelParams = getMacroKernelParams(MicroKernelParams);
957 Node = createMacroKernel(Node, MacroKernelParams);
Roman Gareev2cb4d132016-07-25 07:27:59 +0000958 Node = createMicroKernel(Node, MicroKernelParams);
Roman Gareev1c892e92016-08-15 12:22:54 +0000959 if (MacroKernelParams.Mc == 1 || MacroKernelParams.Nc == 1 ||
960 MacroKernelParams.Kc == 1)
961 return Node;
962 auto *MapOldIndVar = getInductionVariablesSubstitution(
963 Node, MicroKernelParams, MacroKernelParams);
964 if (!MapOldIndVar)
965 return Node;
Roman Gareevb3224ad2016-09-14 06:26:09 +0000966 return optimizeDataLayoutMatrMulPattern(Node, MapOldIndVar, MicroKernelParams,
967 MacroKernelParams);
Roman Gareev42402c92016-06-22 09:52:37 +0000968}
969
Roman Gareev9c3eb592016-05-28 16:17:58 +0000970bool ScheduleTreeOptimizer::isMatrMultPattern(
971 __isl_keep isl_schedule_node *Node) {
972 auto *PartialSchedule =
973 isl_schedule_node_band_get_partial_schedule_union_map(Node);
Roman Gareev397a34a2016-06-22 12:11:30 +0000974 if (isl_schedule_node_band_n_member(Node) != 3 ||
975 isl_union_map_n_map(PartialSchedule) != 1) {
976 isl_union_map_free(PartialSchedule);
Roman Gareev9c3eb592016-05-28 16:17:58 +0000977 return false;
978 }
Roman Gareev397a34a2016-06-22 12:11:30 +0000979 auto *NewPartialSchedule = isl_map_from_union_map(PartialSchedule);
Roman Gareev9c3eb592016-05-28 16:17:58 +0000980 NewPartialSchedule = circularShiftOutputDims(NewPartialSchedule);
981 if (containsMatrMult(NewPartialSchedule)) {
982 isl_map_free(NewPartialSchedule);
983 return true;
984 }
985 isl_map_free(NewPartialSchedule);
986 return false;
987}
988
989__isl_give isl_schedule_node *
990ScheduleTreeOptimizer::optimizeBand(__isl_take isl_schedule_node *Node,
991 void *User) {
992 if (!isTileableBandNode(Node))
993 return Node;
994
Roman Gareev42402c92016-06-22 09:52:37 +0000995 if (PMBasedOpts && User && isMatrMultPattern(Node)) {
Roman Gareev9c3eb592016-05-28 16:17:58 +0000996 DEBUG(dbgs() << "The matrix multiplication pattern was detected\n");
Roman Gareev42402c92016-06-22 09:52:37 +0000997 const llvm::TargetTransformInfo *TTI;
998 TTI = static_cast<const llvm::TargetTransformInfo *>(User);
999 Node = optimizeMatMulPattern(Node, TTI);
1000 }
Roman Gareev9c3eb592016-05-28 16:17:58 +00001001
1002 return standardBandOpts(Node, User);
1003}
1004
Tobias Grosser808cd692015-07-14 09:33:13 +00001005__isl_give isl_schedule *
Roman Gareev42402c92016-06-22 09:52:37 +00001006ScheduleTreeOptimizer::optimizeSchedule(__isl_take isl_schedule *Schedule,
1007 const llvm::TargetTransformInfo *TTI) {
Tobias Grosserbbb4cec2015-03-22 12:06:39 +00001008 isl_schedule_node *Root = isl_schedule_get_root(Schedule);
Roman Gareev42402c92016-06-22 09:52:37 +00001009 Root = optimizeScheduleNode(Root, TTI);
Tobias Grosser808cd692015-07-14 09:33:13 +00001010 isl_schedule_free(Schedule);
Tobias Grosser808cd692015-07-14 09:33:13 +00001011 auto S = isl_schedule_node_get_schedule(Root);
Tobias Grosserbbb4cec2015-03-22 12:06:39 +00001012 isl_schedule_node_free(Root);
Tobias Grosser808cd692015-07-14 09:33:13 +00001013 return S;
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001014}
1015
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001016__isl_give isl_schedule_node *ScheduleTreeOptimizer::optimizeScheduleNode(
Roman Gareev42402c92016-06-22 09:52:37 +00001017 __isl_take isl_schedule_node *Node, const llvm::TargetTransformInfo *TTI) {
1018 Node = isl_schedule_node_map_descendant_bottom_up(
1019 Node, optimizeBand, const_cast<void *>(static_cast<const void *>(TTI)));
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001020 return Node;
1021}
1022
1023bool ScheduleTreeOptimizer::isProfitableSchedule(
Roman Gareevb3224ad2016-09-14 06:26:09 +00001024 Scop &S, __isl_keep isl_schedule *NewSchedule) {
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001025 // To understand if the schedule has been optimized we check if the schedule
1026 // has changed at all.
1027 // TODO: We can improve this by tracking if any necessarily beneficial
1028 // transformations have been performed. This can e.g. be tiling, loop
1029 // interchange, or ...) We can track this either at the place where the
1030 // transformation has been performed or, in case of automatic ILP based
1031 // optimizations, by comparing (yet to be defined) performance metrics
1032 // before/after the scheduling optimizer
1033 // (e.g., #stride-one accesses)
Roman Gareevb3224ad2016-09-14 06:26:09 +00001034 if (S.containsExtensionNode(NewSchedule))
1035 return true;
1036 auto *NewScheduleMap = isl_schedule_get_map(NewSchedule);
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001037 isl_union_map *OldSchedule = S.getSchedule();
Roman Gareevb3224ad2016-09-14 06:26:09 +00001038 assert(OldSchedule && "Only IslScheduleOptimizer can insert extension nodes "
1039 "that make Scop::getSchedule() return nullptr.");
1040 bool changed = !isl_union_map_is_equal(OldSchedule, NewScheduleMap);
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001041 isl_union_map_free(OldSchedule);
Roman Gareevb3224ad2016-09-14 06:26:09 +00001042 isl_union_map_free(NewScheduleMap);
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001043 return changed;
1044}
1045
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001046namespace {
1047class IslScheduleOptimizer : public ScopPass {
1048public:
1049 static char ID;
1050 explicit IslScheduleOptimizer() : ScopPass(ID) { LastSchedule = nullptr; }
1051
1052 ~IslScheduleOptimizer() { isl_schedule_free(LastSchedule); }
1053
Tobias Grosserc80d6972016-09-02 06:33:33 +00001054 /// Optimize the schedule of the SCoP @p S.
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001055 bool runOnScop(Scop &S) override;
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001056
Tobias Grosserc80d6972016-09-02 06:33:33 +00001057 /// Print the new schedule for the SCoP @p S.
Johannes Doerfert45be6442015-09-27 15:43:29 +00001058 void printScop(raw_ostream &OS, Scop &S) const override;
1059
Tobias Grosserc80d6972016-09-02 06:33:33 +00001060 /// Register all analyses and transformation required.
Johannes Doerfert45be6442015-09-27 15:43:29 +00001061 void getAnalysisUsage(AnalysisUsage &AU) const override;
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001062
Tobias Grosserc80d6972016-09-02 06:33:33 +00001063 /// Release the internal memory.
Johannes Doerfert0f376302015-09-27 15:42:28 +00001064 void releaseMemory() override {
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001065 isl_schedule_free(LastSchedule);
1066 LastSchedule = nullptr;
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001067 }
Johannes Doerfert45be6442015-09-27 15:43:29 +00001068
1069private:
1070 isl_schedule *LastSchedule;
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001071};
Tobias Grosser522478d2016-06-23 22:17:27 +00001072} // namespace
Tobias Grosserfa57e9b2015-08-24 06:01:47 +00001073
1074char IslScheduleOptimizer::ID = 0;
1075
Tobias Grosser73600b82011-10-08 00:30:40 +00001076bool IslScheduleOptimizer::runOnScop(Scop &S) {
Johannes Doerfert6f7921f2015-02-14 12:02:24 +00001077
1078 // Skip empty SCoPs but still allow code generation as it will delete the
1079 // loops present but not needed.
1080 if (S.getSize() == 0) {
1081 S.markAsOptimized();
1082 return false;
1083 }
1084
Hongbin Zheng2a798852016-03-03 08:15:33 +00001085 const Dependences &D =
1086 getAnalysis<DependenceInfo>().getDependences(Dependences::AL_Statement);
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001087
Johannes Doerfert7e6424b2015-03-05 00:43:48 +00001088 if (!D.hasValidDependences())
Tobias Grosser38c36ea2014-02-23 15:15:44 +00001089 return false;
1090
Tobias Grosser28781422012-10-16 07:29:19 +00001091 isl_schedule_free(LastSchedule);
Tobias Grosser5a56cbf2014-04-16 07:33:47 +00001092 LastSchedule = nullptr;
Tobias Grosser28781422012-10-16 07:29:19 +00001093
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001094 // Build input data.
Johannes Doerfert7e6424b2015-03-05 00:43:48 +00001095 int ValidityKinds =
1096 Dependences::TYPE_RAW | Dependences::TYPE_WAR | Dependences::TYPE_WAW;
Tobias Grosser1deda292012-02-14 14:02:48 +00001097 int ProximityKinds;
1098
1099 if (OptimizeDeps == "all")
Johannes Doerfert7e6424b2015-03-05 00:43:48 +00001100 ProximityKinds =
1101 Dependences::TYPE_RAW | Dependences::TYPE_WAR | Dependences::TYPE_WAW;
Tobias Grosser1deda292012-02-14 14:02:48 +00001102 else if (OptimizeDeps == "raw")
Johannes Doerfert7e6424b2015-03-05 00:43:48 +00001103 ProximityKinds = Dependences::TYPE_RAW;
Tobias Grosser1deda292012-02-14 14:02:48 +00001104 else {
1105 errs() << "Do not know how to optimize for '" << OptimizeDeps << "'"
Tobias Grosser4d96c8d2013-03-23 01:05:07 +00001106 << " Falling back to optimizing all dependences.\n";
Johannes Doerfert7e6424b2015-03-05 00:43:48 +00001107 ProximityKinds =
1108 Dependences::TYPE_RAW | Dependences::TYPE_WAR | Dependences::TYPE_WAW;
Tobias Grosser1deda292012-02-14 14:02:48 +00001109 }
1110
Tobias Grosser5f9a7622012-02-14 14:02:40 +00001111 isl_union_set *Domain = S.getDomains();
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001112
Tobias Grosser98610ee2012-02-13 23:31:39 +00001113 if (!Domain)
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001114 return false;
1115
Johannes Doerfert7e6424b2015-03-05 00:43:48 +00001116 isl_union_map *Validity = D.getDependences(ValidityKinds);
1117 isl_union_map *Proximity = D.getDependences(ProximityKinds);
Tobias Grosser8a507022012-03-16 11:51:41 +00001118
Tobias Grossera26db472012-01-30 19:38:43 +00001119 // Simplify the dependences by removing the constraints introduced by the
1120 // domains. This can speed up the scheduling time significantly, as large
1121 // constant coefficients will be removed from the dependences. The
1122 // introduction of some additional dependences reduces the possible
1123 // transformations, but in most cases, such transformation do not seem to be
1124 // interesting anyway. In some cases this option may stop the scheduler to
1125 // find any schedule.
1126 if (SimplifyDeps == "yes") {
Tobias Grosser00383a72012-02-14 14:02:44 +00001127 Validity = isl_union_map_gist_domain(Validity, isl_union_set_copy(Domain));
1128 Validity = isl_union_map_gist_range(Validity, isl_union_set_copy(Domain));
Tobias Grosser4d96c8d2013-03-23 01:05:07 +00001129 Proximity =
1130 isl_union_map_gist_domain(Proximity, isl_union_set_copy(Domain));
Tobias Grosser00383a72012-02-14 14:02:44 +00001131 Proximity = isl_union_map_gist_range(Proximity, isl_union_set_copy(Domain));
Tobias Grossera26db472012-01-30 19:38:43 +00001132 } else if (SimplifyDeps != "no") {
1133 errs() << "warning: Option -polly-opt-simplify-deps should either be 'yes' "
1134 "or 'no'. Falling back to default: 'yes'\n";
1135 }
1136
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001137 DEBUG(dbgs() << "\n\nCompute schedule from: ");
Tobias Grosser01aea582014-10-22 23:16:28 +00001138 DEBUG(dbgs() << "Domain := " << stringFromIslObj(Domain) << ";\n");
1139 DEBUG(dbgs() << "Proximity := " << stringFromIslObj(Proximity) << ";\n");
1140 DEBUG(dbgs() << "Validity := " << stringFromIslObj(Validity) << ";\n");
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001141
Michael Krusec59f22c2015-06-18 16:45:40 +00001142 unsigned IslSerializeSCCs;
Tobias Grosserb3ad85b2012-01-30 19:38:50 +00001143
1144 if (FusionStrategy == "max") {
Michael Krusec59f22c2015-06-18 16:45:40 +00001145 IslSerializeSCCs = 0;
Tobias Grosserb3ad85b2012-01-30 19:38:50 +00001146 } else if (FusionStrategy == "min") {
Michael Krusec59f22c2015-06-18 16:45:40 +00001147 IslSerializeSCCs = 1;
Tobias Grosserb3ad85b2012-01-30 19:38:50 +00001148 } else {
1149 errs() << "warning: Unknown fusion strategy. Falling back to maximal "
1150 "fusion.\n";
Michael Krusec59f22c2015-06-18 16:45:40 +00001151 IslSerializeSCCs = 0;
Tobias Grosserb3ad85b2012-01-30 19:38:50 +00001152 }
1153
Tobias Grosser95e860c2012-01-30 19:38:54 +00001154 int IslMaximizeBands;
1155
Tobias Grossera4ea90b2012-01-30 22:43:56 +00001156 if (MaximizeBandDepth == "yes") {
Tobias Grosser95e860c2012-01-30 19:38:54 +00001157 IslMaximizeBands = 1;
Tobias Grossera4ea90b2012-01-30 22:43:56 +00001158 } else if (MaximizeBandDepth == "no") {
Tobias Grosser95e860c2012-01-30 19:38:54 +00001159 IslMaximizeBands = 0;
1160 } else {
1161 errs() << "warning: Option -polly-opt-maximize-bands should either be 'yes'"
1162 " or 'no'. Falling back to default: 'yes'\n";
1163 IslMaximizeBands = 1;
1164 }
1165
Michael Kruse315aa322016-05-02 11:35:27 +00001166 int IslOuterCoincidence;
1167
1168 if (OuterCoincidence == "yes") {
1169 IslOuterCoincidence = 1;
1170 } else if (OuterCoincidence == "no") {
1171 IslOuterCoincidence = 0;
1172 } else {
1173 errs() << "warning: Option -polly-opt-outer-coincidence should either be "
1174 "'yes' or 'no'. Falling back to default: 'no'\n";
1175 IslOuterCoincidence = 0;
1176 }
1177
Tobias Grosseraf149932016-06-30 20:42:56 +00001178 isl_ctx *Ctx = S.getIslCtx();
Tobias Grosser42152ff2012-01-30 19:38:47 +00001179
Tobias Grosseraf149932016-06-30 20:42:56 +00001180 isl_options_set_schedule_outer_coincidence(Ctx, IslOuterCoincidence);
1181 isl_options_set_schedule_serialize_sccs(Ctx, IslSerializeSCCs);
1182 isl_options_set_schedule_maximize_band_depth(Ctx, IslMaximizeBands);
1183 isl_options_set_schedule_max_constant_term(Ctx, MaxConstantTerm);
1184 isl_options_set_schedule_max_coefficient(Ctx, MaxCoefficient);
1185 isl_options_set_tile_scale_tile_loops(Ctx, 0);
1186
Tobias Grosser3898a042016-06-30 20:42:58 +00001187 auto OnErrorStatus = isl_options_get_on_error(Ctx);
Tobias Grosseraf149932016-06-30 20:42:56 +00001188 isl_options_set_on_error(Ctx, ISL_ON_ERROR_CONTINUE);
Tobias Grossera38c9242014-01-26 19:36:28 +00001189
1190 isl_schedule_constraints *ScheduleConstraints;
1191 ScheduleConstraints = isl_schedule_constraints_on_domain(Domain);
1192 ScheduleConstraints =
1193 isl_schedule_constraints_set_proximity(ScheduleConstraints, Proximity);
1194 ScheduleConstraints = isl_schedule_constraints_set_validity(
1195 ScheduleConstraints, isl_union_map_copy(Validity));
1196 ScheduleConstraints =
1197 isl_schedule_constraints_set_coincidence(ScheduleConstraints, Validity);
Tobias Grosser00383a72012-02-14 14:02:44 +00001198 isl_schedule *Schedule;
Tobias Grossera38c9242014-01-26 19:36:28 +00001199 Schedule = isl_schedule_constraints_compute_schedule(ScheduleConstraints);
Tobias Grosser3898a042016-06-30 20:42:58 +00001200 isl_options_set_on_error(Ctx, OnErrorStatus);
Tobias Grosser42152ff2012-01-30 19:38:47 +00001201
1202 // In cases the scheduler is not able to optimize the code, we just do not
1203 // touch the schedule.
Tobias Grosser98610ee2012-02-13 23:31:39 +00001204 if (!Schedule)
Tobias Grosser42152ff2012-01-30 19:38:47 +00001205 return false;
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001206
Tobias Grosser97d87452015-05-30 06:46:59 +00001207 DEBUG({
Tobias Grosseraf149932016-06-30 20:42:56 +00001208 auto *P = isl_printer_to_str(Ctx);
Tobias Grosser97d87452015-05-30 06:46:59 +00001209 P = isl_printer_set_yaml_style(P, ISL_YAML_STYLE_BLOCK);
1210 P = isl_printer_print_schedule(P, Schedule);
Michael Kruse79c01732016-12-12 14:51:06 +00001211 auto *str = isl_printer_get_str(P);
1212 dbgs() << "NewScheduleTree: \n" << str << "\n";
1213 free(str);
Tobias Grosser97d87452015-05-30 06:46:59 +00001214 isl_printer_free(P);
1215 });
Tobias Grosser4d63b9d2012-02-20 08:41:21 +00001216
Roman Gareev42402c92016-06-22 09:52:37 +00001217 Function &F = S.getFunction();
1218 auto *TTI = &getAnalysis<TargetTransformInfoWrapperPass>().getTTI(F);
1219 isl_schedule *NewSchedule =
1220 ScheduleTreeOptimizer::optimizeSchedule(Schedule, TTI);
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001221
Roman Gareevb3224ad2016-09-14 06:26:09 +00001222 if (!ScheduleTreeOptimizer::isProfitableSchedule(S, NewSchedule)) {
Tobias Grosser808cd692015-07-14 09:33:13 +00001223 isl_schedule_free(NewSchedule);
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001224 return false;
1225 }
1226
Tobias Grosser808cd692015-07-14 09:33:13 +00001227 S.setScheduleTree(NewSchedule);
Johannes Doerfert7ceb0402015-02-11 17:25:09 +00001228 S.markAsOptimized();
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001229
Roman Gareev5f99f862016-08-21 11:20:39 +00001230 if (OptimizedScops)
1231 S.dump();
1232
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001233 return false;
1234}
1235
Johannes Doerfert3fe584d2015-03-01 18:40:25 +00001236void IslScheduleOptimizer::printScop(raw_ostream &OS, Scop &) const {
Tobias Grosser28781422012-10-16 07:29:19 +00001237 isl_printer *p;
1238 char *ScheduleStr;
1239
1240 OS << "Calculated schedule:\n";
1241
1242 if (!LastSchedule) {
1243 OS << "n/a\n";
1244 return;
1245 }
1246
1247 p = isl_printer_to_str(isl_schedule_get_ctx(LastSchedule));
1248 p = isl_printer_print_schedule(p, LastSchedule);
1249 ScheduleStr = isl_printer_get_str(p);
1250 isl_printer_free(p);
1251
1252 OS << ScheduleStr << "\n";
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001253}
1254
Tobias Grosser73600b82011-10-08 00:30:40 +00001255void IslScheduleOptimizer::getAnalysisUsage(AnalysisUsage &AU) const {
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001256 ScopPass::getAnalysisUsage(AU);
Johannes Doerfertf6557f92015-03-04 22:43:40 +00001257 AU.addRequired<DependenceInfo>();
Roman Gareev42402c92016-06-22 09:52:37 +00001258 AU.addRequired<TargetTransformInfoWrapperPass>();
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001259}
1260
Tobias Grosser4d96c8d2013-03-23 01:05:07 +00001261Pass *polly::createIslScheduleOptimizerPass() {
Tobias Grosser73600b82011-10-08 00:30:40 +00001262 return new IslScheduleOptimizer();
Tobias Grosser30aa24c2011-05-14 19:02:06 +00001263}
Tobias Grosser4d96c8d2013-03-23 01:05:07 +00001264
1265INITIALIZE_PASS_BEGIN(IslScheduleOptimizer, "polly-opt-isl",
1266 "Polly - Optimize schedule of SCoP", false, false);
Johannes Doerfertf6557f92015-03-04 22:43:40 +00001267INITIALIZE_PASS_DEPENDENCY(DependenceInfo);
Johannes Doerfert99191c72016-05-31 09:41:04 +00001268INITIALIZE_PASS_DEPENDENCY(ScopInfoRegionPass);
Roman Gareev42402c92016-06-22 09:52:37 +00001269INITIALIZE_PASS_DEPENDENCY(TargetTransformInfoWrapperPass);
Tobias Grosser4d96c8d2013-03-23 01:05:07 +00001270INITIALIZE_PASS_END(IslScheduleOptimizer, "polly-opt-isl",
1271 "Polly - Optimize schedule of SCoP", false, false)