1 /* Heuristics and transform for loop blocking and strip mining on
2 polyhedral representation.
4 Copyright (C) 2009-2014 Free Software Foundation, Inc.
5 Contributed by Sebastian Pop <sebastian.pop@amd.com> and
6 Pranav Garg <pranav.garg2107@gmail.com>.
8 This file is part of GCC.
10 GCC is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 3, or (at your option)
15 GCC is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with GCC; see the file COPYING3. If not see
22 <http://www.gnu.org/licenses/>. */
29 #include <isl/union_map.h>
30 #include <isl/constraint.h>
32 #include <cloog/cloog.h>
33 #include <cloog/isl/domain.h>
38 #include "coretypes.h"
46 #include "hard-reg-set.h"
49 #include "dominance.h"
50 #include "basic-block.h"
51 #include "tree-ssa-alias.h"
52 #include "internal-fn.h"
53 #include "gimple-expr.h"
56 #include "gimple-iterator.h"
57 #include "tree-ssa-loop.h"
60 #include "tree-chrec.h"
61 #include "tree-data-ref.h"
65 #include "graphite-poly.h"
68 /* Strip mines with a factor STRIDE the scattering (time) dimension
69 around PBB at depth TIME_DEPTH.
71 The following example comes from the wiki page:
72 http://gcc.gnu.org/wiki/Graphite/Strip_mine
74 The strip mine of a loop with a tile of 64 can be obtained with a
75 scattering function as follows:
77 $ cat ./albert_strip_mine.cloog
81 # parameter {n | n >= 0}
88 1 # Number of statements:
101 1 # Scattering functions
112 #the output of CLooG is like this:
113 #$ cloog ./albert_strip_mine.cloog
114 # for (NEW=0;NEW<=floord(n,64);NEW++) {
115 # for (OLD=max(64*NEW,0);OLD<=min(64*NEW+63,n);OLD++) {
122 pbb_strip_mine_time_depth (poly_bb_p pbb
, int time_depth
, int stride
)
127 /* STRIP is the dimension that iterates with stride STRIDE. */
128 /* ITER is the dimension that enumerates single iterations inside
129 one strip that has at most STRIDE iterations. */
133 pbb
->transformed
= isl_map_insert_dims (pbb
->transformed
, isl_dim_out
,
136 /* Lower bound of the striped loop. */
137 d
= isl_map_get_space (pbb
->transformed
);
138 c
= isl_inequality_alloc (isl_local_space_from_space (d
));
139 c
= isl_constraint_set_coefficient_si (c
, isl_dim_out
, strip
, -stride
);
140 c
= isl_constraint_set_coefficient_si (c
, isl_dim_out
, iter
, 1);
141 pbb
->transformed
= isl_map_add_constraint (pbb
->transformed
, c
);
143 /* Upper bound of the striped loop. */
144 d
= isl_map_get_space (pbb
->transformed
);
145 c
= isl_inequality_alloc (isl_local_space_from_space (d
));
146 c
= isl_constraint_set_coefficient_si (c
, isl_dim_out
, strip
, stride
);
147 c
= isl_constraint_set_coefficient_si (c
, isl_dim_out
, iter
, -1);
148 c
= isl_constraint_set_constant_si (c
, stride
- 1);
149 pbb
->transformed
= isl_map_add_constraint (pbb
->transformed
, c
);
151 /* Static scheduling for ITER level.
152 This is mandatory to keep the 2d + 1 canonical scheduling format. */
153 d
= isl_map_get_space (pbb
->transformed
);
154 c
= isl_equality_alloc (isl_local_space_from_space (d
));
155 c
= isl_constraint_set_coefficient_si (c
, isl_dim_out
, strip
+ 1, 1);
156 pbb
->transformed
= isl_map_add_constraint (pbb
->transformed
, c
);
159 /* Returns true when strip mining with STRIDE of the loop LST is
163 lst_strip_mine_profitable_p (lst_p lst
, int stride
)
165 mpz_t niter
, strip_stride
;
168 gcc_assert (LST_LOOP_P (lst
));
169 mpz_init (strip_stride
);
172 mpz_set_si (strip_stride
, stride
);
173 lst_niter_for_loop (lst
, niter
);
174 res
= (mpz_cmp (niter
, strip_stride
) > 0);
176 mpz_clear (strip_stride
);
181 /* Strip-mines all the loops of LST with STRIDE. Return the number of
182 loops strip-mined. */
185 lst_do_strip_mine_loop (lst_p lst
, int depth
, int stride
)
194 if (LST_LOOP_P (lst
))
198 FOR_EACH_VEC_ELT (LST_SEQ (lst
), i
, l
)
199 res
+= lst_do_strip_mine_loop (l
, depth
, stride
);
205 pbb_strip_mine_time_depth (pbb
, psct_dynamic_dim (pbb
, depth
), stride
);
209 /* Strip-mines all the loops of LST with STRIDE. When STRIDE is zero,
210 read the stride from the PARAM_LOOP_BLOCK_TILE_SIZE. Return the
211 number of strip-mined loops.
213 Strip mining transforms a loop
215 | for (i = 0; i < N; i++)
218 into the following loop nest:
220 | for (k = 0; k < N; k += STRIDE)
221 | for (j = 0; j < STRIDE; j++)
226 lst_do_strip_mine (lst_p lst
, int stride
)
234 stride
= PARAM_VALUE (PARAM_LOOP_BLOCK_TILE_SIZE
);
237 || !LST_LOOP_P (lst
))
240 FOR_EACH_VEC_ELT (LST_SEQ (lst
), i
, l
)
241 res
+= lst_do_strip_mine (l
, stride
);
243 depth
= lst_depth (lst
);
245 && lst_strip_mine_profitable_p (lst
, stride
))
247 res
+= lst_do_strip_mine_loop (lst
, lst_depth (lst
), stride
);
248 lst_add_loop_under_loop (lst
);
254 /* Strip mines all the loops in SCOP. Returns the number of
255 strip-mined loops. */
258 scop_do_strip_mine (scop_p scop
, int stride
)
260 return lst_do_strip_mine (SCOP_TRANSFORMED_SCHEDULE (scop
), stride
);
263 /* Loop blocks all the loops in SCOP. Returns true when we manage to
267 scop_do_block (scop_p scop
)
269 store_scattering (scop
);
271 /* If we don't strip mine at least two loops, or not interchange
272 loops, the strip mine alone will not be profitable, and the
273 transform is not a loop blocking: so revert the transform. */
274 if (lst_do_strip_mine (SCOP_TRANSFORMED_SCHEDULE (scop
), 0) < 2
275 || scop_do_interchange (scop
) == 0)
277 restore_scattering (scop
);
281 if (dump_file
&& (dump_flags
& TDF_DETAILS
))
282 fprintf (dump_file
, "SCoP will be loop blocked.\n");