1 //===- IslAst.cpp - isl code generator interface --------------------------===//
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 //
10 // The isl code generator interface takes a Scop and generates an isl_ast. This
11 // ist_ast can either be returned directly or it can be pretty printed to
12 // stdout.
13 //
14 // A typical isl_ast output looks like this:
15 //
16 // for (c2 = max(0, ceild(n + m, 2); c2 <= min(511, floord(5 * n, 3)); c2++) {
17 //   bb2(c2);
18 // }
19 //
20 // An in-depth discussion of our AST generation approach can be found in:
21 //
22 // Polyhedral AST generation is more than scanning polyhedra
23 // Tobias Grosser, Sven Verdoolaege, Albert Cohen
24 // ACM Transactions on Programming Languages and Systems (TOPLAS),
25 // 37(4), July 2015
26 // http://www.grosser.es/#pub-polyhedral-AST-generation
27 //
28 //===----------------------------------------------------------------------===//
29 
30 #include "polly/CodeGen/IslAst.h"
31 #include "polly/CodeGen/CodeGeneration.h"
32 #include "polly/DependenceInfo.h"
33 #include "polly/LinkAllPasses.h"
34 #include "polly/Options.h"
35 #include "polly/ScopDetection.h"
36 #include "polly/ScopInfo.h"
37 #include "polly/ScopPass.h"
38 #include "polly/Support/GICHelper.h"
39 #include "llvm/ADT/Statistic.h"
40 #include "llvm/IR/Function.h"
41 #include "llvm/Pass.h"
42 #include "llvm/Support/CommandLine.h"
43 #include "llvm/Support/Debug.h"
44 #include "llvm/Support/raw_ostream.h"
45 #include "isl/aff.h"
46 #include "isl/ast.h"
47 #include "isl/ast_build.h"
48 #include "isl/id.h"
49 #include "isl/isl-noexceptions.h"
50 #include "isl/map.h"
51 #include "isl/printer.h"
52 #include "isl/schedule.h"
53 #include "isl/set.h"
54 #include "isl/union_map.h"
55 #include "isl/val.h"
56 #include <cassert>
57 #include <cstdlib>
58 #include <cstring>
59 #include <map>
60 #include <string>
61 #include <utility>
62 
63 #define DEBUG_TYPE "polly-ast"
64 
65 using namespace llvm;
66 using namespace polly;
67 
68 using IslAstUserPayload = IslAstInfo::IslAstUserPayload;
69 
70 static cl::opt<bool>
71     PollyParallel("polly-parallel",
72                   cl::desc("Generate thread parallel code (isl codegen only)"),
73                   cl::init(false), cl::ZeroOrMore, cl::cat(PollyCategory));
74 
75 static cl::opt<bool> PrintAccesses("polly-ast-print-accesses",
76                                    cl::desc("Print memory access functions"),
77                                    cl::init(false), cl::ZeroOrMore,
78                                    cl::cat(PollyCategory));
79 
80 static cl::opt<bool> PollyParallelForce(
81     "polly-parallel-force",
82     cl::desc(
83         "Force generation of thread parallel code ignoring any cost model"),
84     cl::init(false), cl::ZeroOrMore, cl::cat(PollyCategory));
85 
86 static cl::opt<bool> UseContext("polly-ast-use-context",
87                                 cl::desc("Use context"), cl::Hidden,
88                                 cl::init(true), cl::ZeroOrMore,
89                                 cl::cat(PollyCategory));
90 
91 static cl::opt<bool> DetectParallel("polly-ast-detect-parallel",
92                                     cl::desc("Detect parallelism"), cl::Hidden,
93                                     cl::init(false), cl::ZeroOrMore,
94                                     cl::cat(PollyCategory));
95 
96 STATISTIC(ScopsProcessed, "Number of SCoPs processed");
97 STATISTIC(ScopsBeneficial, "Number of beneficial SCoPs");
98 STATISTIC(BeneficialAffineLoops, "Number of beneficial affine loops");
99 STATISTIC(BeneficialBoxedLoops, "Number of beneficial boxed loops");
100 
101 STATISTIC(NumForLoops, "Number of for-loops");
102 STATISTIC(NumParallel, "Number of parallel for-loops");
103 STATISTIC(NumInnermostParallel, "Number of innermost parallel for-loops");
104 STATISTIC(NumOutermostParallel, "Number of outermost parallel for-loops");
105 STATISTIC(NumReductionParallel, "Number of reduction-parallel for-loops");
106 STATISTIC(NumExecutedInParallel, "Number of for-loops executed in parallel");
107 STATISTIC(NumIfConditions, "Number of if-conditions");
108 
109 namespace polly {
110 
111 /// Temporary information used when building the ast.
112 struct AstBuildUserInfo {
113   /// Construct and initialize the helper struct for AST creation.
114   AstBuildUserInfo() = default;
115 
116   /// The dependence information used for the parallelism check.
117   const Dependences *Deps = nullptr;
118 
119   /// Flag to indicate that we are inside a parallel for node.
120   bool InParallelFor = false;
121 
122   /// The last iterator id created for the current SCoP.
123   isl_id *LastForNodeId = nullptr;
124 };
125 
126 } // namespace polly
127 
128 /// Free an IslAstUserPayload object pointed to by @p Ptr.
129 static void freeIslAstUserPayload(void *Ptr) {
130   delete ((IslAstInfo::IslAstUserPayload *)Ptr);
131 }
132 
133 IslAstInfo::IslAstUserPayload::~IslAstUserPayload() {
134   isl_ast_build_free(Build);
135   isl_pw_aff_free(MinimalDependenceDistance);
136 }
137 
138 /// Print a string @p str in a single line using @p Printer.
139 static isl_printer *printLine(__isl_take isl_printer *Printer,
140                               const std::string &str,
141                               __isl_keep isl_pw_aff *PWA = nullptr) {
142   Printer = isl_printer_start_line(Printer);
143   Printer = isl_printer_print_str(Printer, str.c_str());
144   if (PWA)
145     Printer = isl_printer_print_pw_aff(Printer, PWA);
146   return isl_printer_end_line(Printer);
147 }
148 
149 /// Return all broken reductions as a string of clauses (OpenMP style).
150 static const std::string getBrokenReductionsStr(__isl_keep isl_ast_node *Node) {
151   IslAstInfo::MemoryAccessSet *BrokenReductions;
152   std::string str;
153 
154   BrokenReductions = IslAstInfo::getBrokenReductions(Node);
155   if (!BrokenReductions || BrokenReductions->empty())
156     return "";
157 
158   // Map each type of reduction to a comma separated list of the base addresses.
159   std::map<MemoryAccess::ReductionType, std::string> Clauses;
160   for (MemoryAccess *MA : *BrokenReductions)
161     if (MA->isWrite())
162       Clauses[MA->getReductionType()] +=
163           ", " + MA->getScopArrayInfo()->getName();
164 
165   // Now print the reductions sorted by type. Each type will cause a clause
166   // like:  reduction (+ : sum0, sum1, sum2)
167   for (const auto &ReductionClause : Clauses) {
168     str += " reduction (";
169     str += MemoryAccess::getReductionOperatorStr(ReductionClause.first);
170     // Remove the first two symbols (", ") to make the output look pretty.
171     str += " : " + ReductionClause.second.substr(2) + ")";
172   }
173 
174   return str;
175 }
176 
177 /// Callback executed for each for node in the ast in order to print it.
178 static isl_printer *cbPrintFor(__isl_take isl_printer *Printer,
179                                __isl_take isl_ast_print_options *Options,
180                                __isl_keep isl_ast_node *Node, void *) {
181   isl_pw_aff *DD = IslAstInfo::getMinimalDependenceDistance(Node);
182   const std::string BrokenReductionsStr = getBrokenReductionsStr(Node);
183   const std::string KnownParallelStr = "#pragma known-parallel";
184   const std::string DepDisPragmaStr = "#pragma minimal dependence distance: ";
185   const std::string SimdPragmaStr = "#pragma simd";
186   const std::string OmpPragmaStr = "#pragma omp parallel for";
187 
188   if (DD)
189     Printer = printLine(Printer, DepDisPragmaStr, DD);
190 
191   if (IslAstInfo::isInnermostParallel(Node))
192     Printer = printLine(Printer, SimdPragmaStr + BrokenReductionsStr);
193 
194   if (IslAstInfo::isExecutedInParallel(Node))
195     Printer = printLine(Printer, OmpPragmaStr);
196   else if (IslAstInfo::isOutermostParallel(Node))
197     Printer = printLine(Printer, KnownParallelStr + BrokenReductionsStr);
198 
199   isl_pw_aff_free(DD);
200   return isl_ast_node_for_print(Node, Printer, Options);
201 }
202 
203 /// Check if the current scheduling dimension is parallel.
204 ///
205 /// In case the dimension is parallel we also check if any reduction
206 /// dependences is broken when we exploit this parallelism. If so,
207 /// @p IsReductionParallel will be set to true. The reduction dependences we use
208 /// to check are actually the union of the transitive closure of the initial
209 /// reduction dependences together with their reversal. Even though these
210 /// dependences connect all iterations with each other (thus they are cyclic)
211 /// we can perform the parallelism check as we are only interested in a zero
212 /// (or non-zero) dependence distance on the dimension in question.
213 static bool astScheduleDimIsParallel(__isl_keep isl_ast_build *Build,
214                                      const Dependences *D,
215                                      IslAstUserPayload *NodeInfo) {
216   if (!D->hasValidDependences())
217     return false;
218 
219   isl_union_map *Schedule = isl_ast_build_get_schedule(Build);
220   isl_union_map *Deps = D->getDependences(
221       Dependences::TYPE_RAW | Dependences::TYPE_WAW | Dependences::TYPE_WAR);
222 
223   if (!D->isParallel(Schedule, Deps, &NodeInfo->MinimalDependenceDistance) &&
224       !isl_union_map_free(Schedule))
225     return false;
226 
227   isl_union_map *RedDeps = D->getDependences(Dependences::TYPE_TC_RED);
228   if (!D->isParallel(Schedule, RedDeps))
229     NodeInfo->IsReductionParallel = true;
230 
231   if (!NodeInfo->IsReductionParallel && !isl_union_map_free(Schedule))
232     return true;
233 
234   // Annotate reduction parallel nodes with the memory accesses which caused the
235   // reduction dependences parallel execution of the node conflicts with.
236   for (const auto &MaRedPair : D->getReductionDependences()) {
237     if (!MaRedPair.second)
238       continue;
239     RedDeps = isl_union_map_from_map(isl_map_copy(MaRedPair.second));
240     if (!D->isParallel(Schedule, RedDeps))
241       NodeInfo->BrokenReductions.insert(MaRedPair.first);
242   }
243 
244   isl_union_map_free(Schedule);
245   return true;
246 }
247 
248 // This method is executed before the construction of a for node. It creates
249 // an isl_id that is used to annotate the subsequently generated ast for nodes.
250 //
251 // In this function we also run the following analyses:
252 //
253 // - Detection of openmp parallel loops
254 //
255 static __isl_give isl_id *astBuildBeforeFor(__isl_keep isl_ast_build *Build,
256                                             void *User) {
257   AstBuildUserInfo *BuildInfo = (AstBuildUserInfo *)User;
258   IslAstUserPayload *Payload = new IslAstUserPayload();
259   isl_id *Id = isl_id_alloc(isl_ast_build_get_ctx(Build), "", Payload);
260   Id = isl_id_set_free_user(Id, freeIslAstUserPayload);
261   BuildInfo->LastForNodeId = Id;
262 
263   // Test for parallelism only if we are not already inside a parallel loop
264   if (!BuildInfo->InParallelFor)
265     BuildInfo->InParallelFor = Payload->IsOutermostParallel =
266         astScheduleDimIsParallel(Build, BuildInfo->Deps, Payload);
267 
268   return Id;
269 }
270 
271 // This method is executed after the construction of a for node.
272 //
273 // It performs the following actions:
274 //
275 // - Reset the 'InParallelFor' flag, as soon as we leave a for node,
276 //   that is marked as openmp parallel.
277 //
278 static __isl_give isl_ast_node *
279 astBuildAfterFor(__isl_take isl_ast_node *Node, __isl_keep isl_ast_build *Build,
280                  void *User) {
281   isl_id *Id = isl_ast_node_get_annotation(Node);
282   assert(Id && "Post order visit assumes annotated for nodes");
283   IslAstUserPayload *Payload = (IslAstUserPayload *)isl_id_get_user(Id);
284   assert(Payload && "Post order visit assumes annotated for nodes");
285 
286   AstBuildUserInfo *BuildInfo = (AstBuildUserInfo *)User;
287   assert(!Payload->Build && "Build environment already set");
288   Payload->Build = isl_ast_build_copy(Build);
289   Payload->IsInnermost = (Id == BuildInfo->LastForNodeId);
290 
291   // Innermost loops that are surrounded by parallel loops have not yet been
292   // tested for parallelism. Test them here to ensure we check all innermost
293   // loops for parallelism.
294   if (Payload->IsInnermost && BuildInfo->InParallelFor) {
295     if (Payload->IsOutermostParallel) {
296       Payload->IsInnermostParallel = true;
297     } else {
298       if (PollyVectorizerChoice == VECTORIZER_NONE)
299         Payload->IsInnermostParallel =
300             astScheduleDimIsParallel(Build, BuildInfo->Deps, Payload);
301     }
302   }
303   if (Payload->IsOutermostParallel)
304     BuildInfo->InParallelFor = false;
305 
306   isl_id_free(Id);
307   return Node;
308 }
309 
310 static isl_stat astBuildBeforeMark(__isl_keep isl_id *MarkId,
311                                    __isl_keep isl_ast_build *Build,
312                                    void *User) {
313   if (!MarkId)
314     return isl_stat_error;
315 
316   AstBuildUserInfo *BuildInfo = (AstBuildUserInfo *)User;
317   if (strcmp(isl_id_get_name(MarkId), "SIMD") == 0)
318     BuildInfo->InParallelFor = true;
319 
320   return isl_stat_ok;
321 }
322 
323 static __isl_give isl_ast_node *
324 astBuildAfterMark(__isl_take isl_ast_node *Node,
325                   __isl_keep isl_ast_build *Build, void *User) {
326   assert(isl_ast_node_get_type(Node) == isl_ast_node_mark);
327   AstBuildUserInfo *BuildInfo = (AstBuildUserInfo *)User;
328   auto *Id = isl_ast_node_mark_get_id(Node);
329   if (strcmp(isl_id_get_name(Id), "SIMD") == 0)
330     BuildInfo->InParallelFor = false;
331   isl_id_free(Id);
332   return Node;
333 }
334 
335 static __isl_give isl_ast_node *AtEachDomain(__isl_take isl_ast_node *Node,
336                                              __isl_keep isl_ast_build *Build,
337                                              void *User) {
338   assert(!isl_ast_node_get_annotation(Node) && "Node already annotated");
339 
340   IslAstUserPayload *Payload = new IslAstUserPayload();
341   isl_id *Id = isl_id_alloc(isl_ast_build_get_ctx(Build), "", Payload);
342   Id = isl_id_set_free_user(Id, freeIslAstUserPayload);
343 
344   Payload->Build = isl_ast_build_copy(Build);
345 
346   return isl_ast_node_set_annotation(Node, Id);
347 }
348 
349 // Build alias check condition given a pair of minimal/maximal access.
350 static __isl_give isl_ast_expr *
351 buildCondition(__isl_keep isl_ast_build *Build, const Scop::MinMaxAccessTy *It0,
352                const Scop::MinMaxAccessTy *It1) {
353   isl_ast_expr *NonAliasGroup, *MinExpr, *MaxExpr;
354   MinExpr = isl_ast_expr_address_of(isl_ast_build_access_from_pw_multi_aff(
355       Build, isl_pw_multi_aff_copy(It0->first)));
356   MaxExpr = isl_ast_expr_address_of(isl_ast_build_access_from_pw_multi_aff(
357       Build, isl_pw_multi_aff_copy(It1->second)));
358   NonAliasGroup = isl_ast_expr_le(MaxExpr, MinExpr);
359   MinExpr = isl_ast_expr_address_of(isl_ast_build_access_from_pw_multi_aff(
360       Build, isl_pw_multi_aff_copy(It1->first)));
361   MaxExpr = isl_ast_expr_address_of(isl_ast_build_access_from_pw_multi_aff(
362       Build, isl_pw_multi_aff_copy(It0->second)));
363   NonAliasGroup =
364       isl_ast_expr_or(NonAliasGroup, isl_ast_expr_le(MaxExpr, MinExpr));
365 
366   return NonAliasGroup;
367 }
368 
369 __isl_give isl_ast_expr *
370 IslAst::buildRunCondition(Scop &S, __isl_keep isl_ast_build *Build) {
371   isl_ast_expr *RunCondition;
372 
373   // The conditions that need to be checked at run-time for this scop are
374   // available as an isl_set in the runtime check context from which we can
375   // directly derive a run-time condition.
376   auto *PosCond =
377       isl_ast_build_expr_from_set(Build, S.getAssumedContext().release());
378   if (S.hasTrivialInvalidContext()) {
379     RunCondition = PosCond;
380   } else {
381     auto *ZeroV = isl_val_zero(isl_ast_build_get_ctx(Build));
382     auto *NegCond =
383         isl_ast_build_expr_from_set(Build, S.getInvalidContext().release());
384     auto *NotNegCond = isl_ast_expr_eq(isl_ast_expr_from_val(ZeroV), NegCond);
385     RunCondition = isl_ast_expr_and(PosCond, NotNegCond);
386   }
387 
388   // Create the alias checks from the minimal/maximal accesses in each alias
389   // group which consists of read only and non read only (read write) accesses.
390   // This operation is by construction quadratic in the read-write pointers and
391   // linear in the read only pointers in each alias group.
392   for (const Scop::MinMaxVectorPairTy &MinMaxAccessPair : S.getAliasGroups()) {
393     auto &MinMaxReadWrite = MinMaxAccessPair.first;
394     auto &MinMaxReadOnly = MinMaxAccessPair.second;
395     auto RWAccEnd = MinMaxReadWrite.end();
396 
397     for (auto RWAccIt0 = MinMaxReadWrite.begin(); RWAccIt0 != RWAccEnd;
398          ++RWAccIt0) {
399       for (auto RWAccIt1 = RWAccIt0 + 1; RWAccIt1 != RWAccEnd; ++RWAccIt1)
400         RunCondition = isl_ast_expr_and(
401             RunCondition, buildCondition(Build, RWAccIt0, RWAccIt1));
402       for (const Scop::MinMaxAccessTy &ROAccIt : MinMaxReadOnly)
403         RunCondition = isl_ast_expr_and(
404             RunCondition, buildCondition(Build, RWAccIt0, &ROAccIt));
405     }
406   }
407 
408   return RunCondition;
409 }
410 
411 /// Simple cost analysis for a given SCoP.
412 ///
413 /// TODO: Improve this analysis and extract it to make it usable in other
414 ///       places too.
415 ///       In order to improve the cost model we could either keep track of
416 ///       performed optimizations (e.g., tiling) or compute properties on the
417 ///       original as well as optimized SCoP (e.g., #stride-one-accesses).
418 static bool benefitsFromPolly(Scop &Scop, bool PerformParallelTest) {
419   if (PollyProcessUnprofitable)
420     return true;
421 
422   // Check if nothing interesting happened.
423   if (!PerformParallelTest && !Scop.isOptimized() &&
424       Scop.getAliasGroups().empty())
425     return false;
426 
427   // The default assumption is that Polly improves the code.
428   return true;
429 }
430 
431 /// Collect statistics for the syntax tree rooted at @p Ast.
432 static void walkAstForStatistics(__isl_keep isl_ast_node *Ast) {
433   assert(Ast);
434   isl_ast_node_foreach_descendant_top_down(
435       Ast,
436       [](__isl_keep isl_ast_node *Node, void *User) -> isl_bool {
437         switch (isl_ast_node_get_type(Node)) {
438         case isl_ast_node_for:
439           NumForLoops++;
440           if (IslAstInfo::isParallel(Node))
441             NumParallel++;
442           if (IslAstInfo::isInnermostParallel(Node))
443             NumInnermostParallel++;
444           if (IslAstInfo::isOutermostParallel(Node))
445             NumOutermostParallel++;
446           if (IslAstInfo::isReductionParallel(Node))
447             NumReductionParallel++;
448           if (IslAstInfo::isExecutedInParallel(Node))
449             NumExecutedInParallel++;
450           break;
451 
452         case isl_ast_node_if:
453           NumIfConditions++;
454           break;
455 
456         default:
457           break;
458         }
459 
460         // Continue traversing subtrees.
461         return isl_bool_true;
462       },
463       nullptr);
464 }
465 
466 IslAst::IslAst(Scop &Scop) : S(Scop), Ctx(Scop.getSharedIslCtx()) {}
467 
468 IslAst::IslAst(IslAst &&O)
469     : S(O.S), Root(O.Root), RunCondition(O.RunCondition), Ctx(O.Ctx) {
470   O.Root = nullptr;
471   O.RunCondition = nullptr;
472 }
473 
474 IslAst::~IslAst() {
475   isl_ast_node_free(Root);
476   isl_ast_expr_free(RunCondition);
477 }
478 
479 void IslAst::init(const Dependences &D) {
480   bool PerformParallelTest = PollyParallel || DetectParallel ||
481                              PollyVectorizerChoice != VECTORIZER_NONE;
482 
483   // We can not perform the dependence analysis and, consequently,
484   // the parallel code generation in case the schedule tree contains
485   // extension nodes.
486   auto *ScheduleTree = S.getScheduleTree().release();
487   PerformParallelTest =
488       PerformParallelTest && !S.containsExtensionNode(ScheduleTree);
489   isl_schedule_free(ScheduleTree);
490 
491   // Skip AST and code generation if there was no benefit achieved.
492   if (!benefitsFromPolly(S, PerformParallelTest))
493     return;
494 
495   auto ScopStats = S.getStatistics();
496   ScopsBeneficial++;
497   BeneficialAffineLoops += ScopStats.NumAffineLoops;
498   BeneficialBoxedLoops += ScopStats.NumBoxedLoops;
499 
500   isl_ctx *Ctx = S.getIslCtx();
501   isl_options_set_ast_build_atomic_upper_bound(Ctx, true);
502   isl_options_set_ast_build_detect_min_max(Ctx, true);
503   isl_ast_build *Build;
504   AstBuildUserInfo BuildInfo;
505 
506   if (UseContext)
507     Build = isl_ast_build_from_context(S.getContext().release());
508   else
509     Build = isl_ast_build_from_context(
510         isl_set_universe(S.getParamSpace().release()));
511 
512   Build = isl_ast_build_set_at_each_domain(Build, AtEachDomain, nullptr);
513 
514   if (PerformParallelTest) {
515     BuildInfo.Deps = &D;
516     BuildInfo.InParallelFor = false;
517 
518     Build = isl_ast_build_set_before_each_for(Build, &astBuildBeforeFor,
519                                               &BuildInfo);
520     Build =
521         isl_ast_build_set_after_each_for(Build, &astBuildAfterFor, &BuildInfo);
522 
523     Build = isl_ast_build_set_before_each_mark(Build, &astBuildBeforeMark,
524                                                &BuildInfo);
525 
526     Build = isl_ast_build_set_after_each_mark(Build, &astBuildAfterMark,
527                                               &BuildInfo);
528   }
529 
530   RunCondition = buildRunCondition(S, Build);
531 
532   Root = isl_ast_build_node_from_schedule(Build, S.getScheduleTree().release());
533   walkAstForStatistics(Root);
534 
535   isl_ast_build_free(Build);
536 }
537 
538 IslAst IslAst::create(Scop &Scop, const Dependences &D) {
539   IslAst Ast{Scop};
540   Ast.init(D);
541   return Ast;
542 }
543 
544 __isl_give isl_ast_node *IslAst::getAst() { return isl_ast_node_copy(Root); }
545 __isl_give isl_ast_expr *IslAst::getRunCondition() {
546   return isl_ast_expr_copy(RunCondition);
547 }
548 
549 __isl_give isl_ast_node *IslAstInfo::getAst() { return Ast.getAst(); }
550 __isl_give isl_ast_expr *IslAstInfo::getRunCondition() {
551   return Ast.getRunCondition();
552 }
553 
554 IslAstUserPayload *IslAstInfo::getNodePayload(__isl_keep isl_ast_node *Node) {
555   isl_id *Id = isl_ast_node_get_annotation(Node);
556   if (!Id)
557     return nullptr;
558   IslAstUserPayload *Payload = (IslAstUserPayload *)isl_id_get_user(Id);
559   isl_id_free(Id);
560   return Payload;
561 }
562 
563 bool IslAstInfo::isInnermost(__isl_keep isl_ast_node *Node) {
564   IslAstUserPayload *Payload = getNodePayload(Node);
565   return Payload && Payload->IsInnermost;
566 }
567 
568 bool IslAstInfo::isParallel(__isl_keep isl_ast_node *Node) {
569   return IslAstInfo::isInnermostParallel(Node) ||
570          IslAstInfo::isOutermostParallel(Node);
571 }
572 
573 bool IslAstInfo::isInnermostParallel(__isl_keep isl_ast_node *Node) {
574   IslAstUserPayload *Payload = getNodePayload(Node);
575   return Payload && Payload->IsInnermostParallel;
576 }
577 
578 bool IslAstInfo::isOutermostParallel(__isl_keep isl_ast_node *Node) {
579   IslAstUserPayload *Payload = getNodePayload(Node);
580   return Payload && Payload->IsOutermostParallel;
581 }
582 
583 bool IslAstInfo::isReductionParallel(__isl_keep isl_ast_node *Node) {
584   IslAstUserPayload *Payload = getNodePayload(Node);
585   return Payload && Payload->IsReductionParallel;
586 }
587 
588 bool IslAstInfo::isExecutedInParallel(__isl_keep isl_ast_node *Node) {
589   if (!PollyParallel)
590     return false;
591 
592   // Do not parallelize innermost loops.
593   //
594   // Parallelizing innermost loops is often not profitable, especially if
595   // they have a low number of iterations.
596   //
597   // TODO: Decide this based on the number of loop iterations that will be
598   //       executed. This can possibly require run-time checks, which again
599   //       raises the question of both run-time check overhead and code size
600   //       costs.
601   if (!PollyParallelForce && isInnermost(Node))
602     return false;
603 
604   return isOutermostParallel(Node) && !isReductionParallel(Node);
605 }
606 
607 __isl_give isl_union_map *
608 IslAstInfo::getSchedule(__isl_keep isl_ast_node *Node) {
609   IslAstUserPayload *Payload = getNodePayload(Node);
610   return Payload ? isl_ast_build_get_schedule(Payload->Build) : nullptr;
611 }
612 
613 __isl_give isl_pw_aff *
614 IslAstInfo::getMinimalDependenceDistance(__isl_keep isl_ast_node *Node) {
615   IslAstUserPayload *Payload = getNodePayload(Node);
616   return Payload ? isl_pw_aff_copy(Payload->MinimalDependenceDistance)
617                  : nullptr;
618 }
619 
620 IslAstInfo::MemoryAccessSet *
621 IslAstInfo::getBrokenReductions(__isl_keep isl_ast_node *Node) {
622   IslAstUserPayload *Payload = getNodePayload(Node);
623   return Payload ? &Payload->BrokenReductions : nullptr;
624 }
625 
626 isl_ast_build *IslAstInfo::getBuild(__isl_keep isl_ast_node *Node) {
627   IslAstUserPayload *Payload = getNodePayload(Node);
628   return Payload ? Payload->Build : nullptr;
629 }
630 
631 IslAstInfo IslAstAnalysis::run(Scop &S, ScopAnalysisManager &SAM,
632                                ScopStandardAnalysisResults &SAR) {
633   return {S, SAM.getResult<DependenceAnalysis>(S, SAR).getDependences(
634                  Dependences::AL_Statement)};
635 }
636 
637 static __isl_give isl_printer *cbPrintUser(__isl_take isl_printer *P,
638                                            __isl_take isl_ast_print_options *O,
639                                            __isl_keep isl_ast_node *Node,
640                                            void *User) {
641   isl::ast_node AstNode = isl::manage(isl_ast_node_copy(Node));
642   isl::ast_expr NodeExpr = AstNode.user_get_expr();
643   isl::ast_expr CallExpr = NodeExpr.get_op_arg(0);
644   isl::id CallExprId = CallExpr.get_id();
645   ScopStmt *AccessStmt = (ScopStmt *)CallExprId.get_user();
646 
647   P = isl_printer_start_line(P);
648   P = isl_printer_print_str(P, AccessStmt->getBaseName());
649   P = isl_printer_print_str(P, "(");
650   P = isl_printer_end_line(P);
651   P = isl_printer_indent(P, 2);
652 
653   for (MemoryAccess *MemAcc : *AccessStmt) {
654     P = isl_printer_start_line(P);
655 
656     if (MemAcc->isRead())
657       P = isl_printer_print_str(P, "/* read  */ &");
658     else
659       P = isl_printer_print_str(P, "/* write */  ");
660 
661     isl::ast_build Build =
662         isl::manage(isl_ast_build_copy(IslAstInfo::getBuild(Node)));
663     if (MemAcc->isAffine()) {
664       isl_pw_multi_aff *PwmaPtr =
665           MemAcc->applyScheduleToAccessRelation(Build.get_schedule()).release();
666       isl::pw_multi_aff Pwma = isl::manage(PwmaPtr);
667       isl::ast_expr AccessExpr = Build.access_from(Pwma);
668       P = isl_printer_print_ast_expr(P, AccessExpr.get());
669     } else {
670       P = isl_printer_print_str(
671           P, MemAcc->getLatestScopArrayInfo()->getName().c_str());
672       P = isl_printer_print_str(P, "[*]");
673     }
674     P = isl_printer_end_line(P);
675   }
676 
677   P = isl_printer_indent(P, -2);
678   P = isl_printer_start_line(P);
679   P = isl_printer_print_str(P, ");");
680   P = isl_printer_end_line(P);
681 
682   isl_ast_print_options_free(O);
683   return P;
684 }
685 
686 void IslAstInfo::print(raw_ostream &OS) {
687   isl_ast_print_options *Options;
688   isl_ast_node *RootNode = Ast.getAst();
689   Function &F = S.getFunction();
690 
691   OS << ":: isl ast :: " << F.getName() << " :: " << S.getNameStr() << "\n";
692 
693   if (!RootNode) {
694     OS << ":: isl ast generation and code generation was skipped!\n\n";
695     OS << ":: This is either because no useful optimizations could be applied "
696           "(use -polly-process-unprofitable to enforce code generation) or "
697           "because earlier passes such as dependence analysis timed out (use "
698           "-polly-dependences-computeout=0 to set dependence analysis timeout "
699           "to infinity)\n\n";
700     return;
701   }
702 
703   isl_ast_expr *RunCondition = Ast.getRunCondition();
704   char *RtCStr, *AstStr;
705 
706   Options = isl_ast_print_options_alloc(S.getIslCtx());
707 
708   if (PrintAccesses)
709     Options =
710         isl_ast_print_options_set_print_user(Options, cbPrintUser, nullptr);
711   Options = isl_ast_print_options_set_print_for(Options, cbPrintFor, nullptr);
712 
713   isl_printer *P = isl_printer_to_str(S.getIslCtx());
714   P = isl_printer_set_output_format(P, ISL_FORMAT_C);
715   P = isl_printer_print_ast_expr(P, RunCondition);
716   RtCStr = isl_printer_get_str(P);
717   P = isl_printer_flush(P);
718   P = isl_printer_indent(P, 4);
719   P = isl_ast_node_print(RootNode, P, Options);
720   AstStr = isl_printer_get_str(P);
721 
722   auto *Schedule = S.getScheduleTree().release();
723 
724   DEBUG({
725     dbgs() << S.getContextStr() << "\n";
726     dbgs() << stringFromIslObj(Schedule);
727   });
728   OS << "\nif (" << RtCStr << ")\n\n";
729   OS << AstStr << "\n";
730   OS << "else\n";
731   OS << "    {  /* original code */ }\n\n";
732 
733   free(RtCStr);
734   free(AstStr);
735 
736   isl_ast_expr_free(RunCondition);
737   isl_schedule_free(Schedule);
738   isl_ast_node_free(RootNode);
739   isl_printer_free(P);
740 }
741 
742 AnalysisKey IslAstAnalysis::Key;
743 PreservedAnalyses IslAstPrinterPass::run(Scop &S, ScopAnalysisManager &SAM,
744                                          ScopStandardAnalysisResults &SAR,
745                                          SPMUpdater &U) {
746   auto &Ast = SAM.getResult<IslAstAnalysis>(S, SAR);
747   Ast.print(OS);
748   return PreservedAnalyses::all();
749 }
750 
751 void IslAstInfoWrapperPass::releaseMemory() { Ast.reset(); }
752 
753 bool IslAstInfoWrapperPass::runOnScop(Scop &Scop) {
754   // Skip SCoPs in case they're already handled by PPCGCodeGeneration.
755   if (Scop.isToBeSkipped())
756     return false;
757 
758   ScopsProcessed++;
759 
760   const Dependences &D =
761       getAnalysis<DependenceInfo>().getDependences(Dependences::AL_Statement);
762 
763   Ast.reset(new IslAstInfo(Scop, D));
764 
765   DEBUG(printScop(dbgs(), Scop));
766   return false;
767 }
768 
769 void IslAstInfoWrapperPass::getAnalysisUsage(AnalysisUsage &AU) const {
770   // Get the Common analysis usage of ScopPasses.
771   ScopPass::getAnalysisUsage(AU);
772   AU.addRequired<ScopInfoRegionPass>();
773   AU.addRequired<DependenceInfo>();
774 }
775 
776 void IslAstInfoWrapperPass::printScop(raw_ostream &OS, Scop &S) const {
777   if (Ast)
778     Ast->print(OS);
779 }
780 
781 char IslAstInfoWrapperPass::ID = 0;
782 
783 Pass *polly::createIslAstInfoWrapperPassPass() {
784   return new IslAstInfoWrapperPass();
785 }
786 
787 INITIALIZE_PASS_BEGIN(IslAstInfoWrapperPass, "polly-ast",
788                       "Polly - Generate an AST of the SCoP (isl)", false,
789                       false);
790 INITIALIZE_PASS_DEPENDENCY(ScopInfoRegionPass);
791 INITIALIZE_PASS_DEPENDENCY(DependenceInfo);
792 INITIALIZE_PASS_END(IslAstInfoWrapperPass, "polly-ast",
793                     "Polly - Generate an AST from the SCoP (isl)", false, false)
794