Substantial improvements to coercion optimisation
[ghc-hetmet.git] / compiler / types / OptCoercion.lhs
1 %\r
2 % (c) The University of Glasgow 2006\r
3 %\r
4 \r
5 \begin{code}\r
6 {-# OPTIONS_GHC -w #-}\r
7 module OptCoercion (\r
8         optCoercion\r
9    ) where \r
10 \r
11 #include "HsVersions.h"\r
12 \r
13 import Unify    ( tcMatchTy )\r
14 import Coercion\r
15 import Type\r
16 import TypeRep\r
17 import TyCon\r
18 import Var\r
19 import VarSet\r
20 import PrelNames\r
21 import Util\r
22 import Outputable\r
23 \end{code}\r
24 \r
25 %************************************************************************\r
26 %*                                                                      *\r
27                  Optimising coercions                                                                   \r
28 %*                                                                      *\r
29 %************************************************************************\r
30 \r
31 \begin{code}\r
32 optCoercion :: TvSubst -> Coercion -> NormalCo\r
33 -- ^ optCoercion applies a substitution to a coercion, \r
34 --   *and* optimises it to reduce its size\r
35 optCoercion env co = opt_co env False co\r
36 \r
37 type NormalCo = Coercion\r
38   -- Invariants: \r
39   --  * The substitution has been fully applied\r
40   --  * For trans coercions (co1 `trans` co2)\r
41   --       co1 is not a trans, and neither co1 nor co2 is identity\r
42   --  * If the coercion is the identity, it has no CoVars of CoTyCons in it (just types)\r
43 \r
44 type NormalNonIdCo = NormalCo  -- Extra invariant: not the identity\r
45 \r
46 opt_co, opt_co' :: TvSubst\r
47                 -> Bool        -- True <=> return (sym co)\r
48                 -> Coercion\r
49                 -> NormalCo     \r
50 opt_co = opt_co'\r
51 -- opt_co sym co = pprTrace "opt_co {" (ppr sym <+> ppr co) $\r
52 --                      co1 `seq` \r
53 --                pprTrace "opt_co done }" (ppr co1) \r
54 --               WARN( not same_co_kind, ppr co  <+> dcolon <+> pprEqPred (s1,t1) \r
55 --                                     $$ ppr co1 <+> dcolon <+> pprEqPred (s2,t2) )\r
56 --                co1\r
57 --  where\r
58 --    co1 = opt_co' sym co\r
59 --    same_co_kind = s1 `coreEqType` s2 && t1 `coreEqType` t2\r
60 --    (s,t) = coercionKind co\r
61 --    (s1,t1) | sym = (t,s)\r
62 --            | otherwise = (s,t)\r
63 --    (s2,t2) = coercionKind co1\r
64 \r
65 opt_co' env sym (AppTy ty1 ty2)           = mkAppTy (opt_co env sym ty1) (opt_co env sym ty2)\r
66 opt_co' env sym (FunTy ty1 ty2)           = FunTy (opt_co env sym ty1) (opt_co env sym ty2)\r
67 opt_co' env sym (PredTy (ClassP cls tys)) = PredTy (ClassP cls (map (opt_co env sym) tys))\r
68 opt_co' env sym (PredTy (IParam n ty))    = PredTy (IParam n (opt_co env sym ty))\r
69 opt_co' _   _   co@(PredTy (EqPred {}))   = pprPanic "optCoercion" (ppr co)\r
70 \r
71 opt_co' env sym co@(TyVarTy tv)\r
72   | Just ty <- lookupTyVar env tv = opt_co' (zapTvSubstEnv env) sym ty\r
73   | not (isCoVar tv)     = co   -- Identity; does not mention a CoVar\r
74   | ty1 `coreEqType` ty2 = ty1  -- Identity; ..ditto..\r
75   | not sym              = co\r
76   | otherwise            = mkSymCoercion co\r
77   where\r
78     (ty1,ty2) = coVarKind tv\r
79 \r
80 opt_co' env sym (ForAllTy tv cor) \r
81   | isCoVar tv = mkCoPredTy (opt_co env sym co1) (opt_co env sym co2) (opt_co env sym cor)\r
82   | otherwise  = case substTyVarBndr env tv of\r
83                    (env', tv') -> ForAllTy tv' (opt_co env' sym cor)\r
84   where\r
85     (co1,co2) = coVarKind tv\r
86 \r
87 opt_co' env sym (TyConApp tc cos)\r
88   | Just (arity, desc) <- isCoercionTyCon_maybe tc\r
89   = mkAppTys (opt_co_tc_app env sym tc desc (take arity cos))\r
90              (map (opt_co env sym) (drop arity cos))\r
91   | otherwise\r
92   = TyConApp tc (map (opt_co env sym) cos)\r
93 \r
94 --------\r
95 opt_co_tc_app :: TvSubst -> Bool -> TyCon -> CoTyConDesc -> [Coercion] -> NormalCo\r
96 -- Used for CoercionTyCons only\r
97 -- Arguments are *not* already simplified/substituted\r
98 opt_co_tc_app env sym tc desc cos\r
99   = case desc of\r
100       CoAxiom {} -- Do *not* push sym inside top-level axioms\r
101                  -- e.g. if g is a top-level axiom\r
102                  --   g a : F a ~ a\r
103                  -- Then (sym (g ty)) /= g (sym ty) !!\r
104         | sym       -> mkSymCoercion the_co  \r
105         | otherwise -> the_co\r
106         where\r
107            the_co = TyConApp tc (map (opt_co env False) cos)\r
108            -- Note that the_co does *not* have sym pushed into it\r
109     \r
110       CoTrans \r
111         | sym       -> opt_trans opt_co2 opt_co1   -- sym (g `o` h) = sym h `o` sym g\r
112         | otherwise -> opt_trans opt_co1 opt_co2\r
113 \r
114       CoUnsafe\r
115         | sym       -> TyConApp tc [opt_co2,opt_co1]\r
116         | otherwise -> TyConApp tc [opt_co1,opt_co2]\r
117 \r
118       CoSym   -> opt_co env (not sym) co1\r
119       CoLeft  -> opt_lr fst\r
120       CoRight -> opt_lr snd\r
121       CoCsel1 -> opt_csel fstOf3\r
122       CoCsel2 -> opt_csel sndOf3\r
123       CoCselR -> opt_csel thirdOf3\r
124 \r
125       CoInst        -- See if the first arg is already a forall\r
126                     -- ...then we can just extend the current substitution\r
127         | Just (tv, co1_body) <- splitForAllTy_maybe co1\r
128         -> opt_co (extendTvSubst env tv ty') sym co1_body\r
129 \r
130                     -- See if is *now* a forall\r
131         | Just (tv, opt_co1_body) <- splitForAllTy_maybe opt_co1\r
132         -> substTyWith [tv] [ty'] opt_co1_body  -- An inefficient one-variable substitution\r
133 \r
134         | otherwise\r
135         -> TyConApp tc [opt_co1, ty']\r
136         where\r
137           ty' = substTy env co2\r
138 \r
139   where\r
140     (co1 : cos1) = cos\r
141     (co2 : _)    = cos1\r
142 \r
143         -- These opt_cos have the sym pushed into them\r
144     opt_co1 = opt_co env sym co1\r
145     opt_co2 = opt_co env sym co2\r
146 \r
147     the_unary_opt_co = TyConApp tc [opt_co1]\r
148 \r
149     opt_lr   sel = case splitAppTy_maybe opt_co1 of\r
150                      Nothing -> the_unary_opt_co \r
151                      Just lr -> sel lr\r
152     opt_csel sel = case splitCoPredTy_maybe opt_co1 of\r
153                      Nothing -> the_unary_opt_co \r
154                      Just lr -> sel lr\r
155 \r
156 -------------\r
157 opt_transL :: [NormalCo] -> [NormalCo] -> [NormalCo]\r
158 opt_transL = zipWith opt_trans\r
159 \r
160 opt_trans :: NormalCo -> NormalCo -> NormalCo\r
161 opt_trans co1 co2\r
162   | isIdNormCo co1 = co2\r
163   | otherwise      = opt_trans1 co1 co2\r
164 \r
165 opt_trans1 :: NormalNonIdCo -> NormalCo -> NormalCo\r
166 -- First arg is not the identity\r
167 opt_trans1 co1 co2\r
168   | isIdNormCo co2 = co1\r
169   | otherwise      = opt_trans2 co1 co2\r
170 \r
171 opt_trans2 :: NormalNonIdCo -> NormalNonIdCo -> NormalCo\r
172 -- Neither arg is the identity\r
173 opt_trans2 (TyConApp tc [co1a,co1b]) co2\r
174   | tc `hasKey` transCoercionTyConKey\r
175   = opt_trans1 co1a (opt_trans2 co1b co2)\r
176 \r
177 opt_trans2 co1 co2 \r
178   | Just co <- opt_trans_rule co1 co2\r
179   = co\r
180 \r
181 opt_trans2 co1 (TyConApp tc [co2a,co2b])\r
182   | tc `hasKey` transCoercionTyConKey\r
183   , Just co1_2a <- opt_trans_rule co1 co2a\r
184   = if isIdNormCo co1_2a\r
185     then co2b\r
186     else opt_trans2 co1_2a co2b\r
187 \r
188 opt_trans2 co1 co2\r
189   = mkTransCoercion co1 co2\r
190 \r
191 ------\r
192 opt_trans_rule :: NormalNonIdCo -> NormalNonIdCo -> Maybe NormalCo\r
193 opt_trans_rule (TyConApp tc1 args1) (TyConApp tc2 args2)\r
194   | tc1 == tc2\r
195   = case isCoercionTyCon_maybe tc1 of\r
196       Nothing \r
197         -> Just (TyConApp tc1 (opt_transL args1 args2))\r
198       Just (arity, desc) \r
199         | arity == length args1\r
200         -> opt_trans_rule_equal_tc desc args1 args2\r
201         | otherwise\r
202         -> case opt_trans_rule_equal_tc desc \r
203                          (take arity args1) \r
204                          (take arity args2) of\r
205               Just co -> Just $ mkAppTys co $ \r
206                          opt_transL (drop arity args1) (drop arity args2)\r
207               Nothing -> Nothing \r
208  \r
209 -- Push transitivity inside apply\r
210 opt_trans_rule co1 co2\r
211   | Just (co1a, co1b) <- splitAppTy_maybe co1\r
212   , Just (co2a, co2b) <- etaApp_maybe co2\r
213   = Just (mkAppTy (opt_trans co1a co2a) (opt_trans co1b co2b))\r
214 \r
215   | Just (co2a, co2b) <- splitAppTy_maybe co2\r
216   , Just (co1a, co1b) <- etaApp_maybe co1\r
217   = Just (mkAppTy (opt_trans co1a co2a) (opt_trans co1b co2b))\r
218 \r
219 -- Push transitivity inside (s~t)=>r\r
220 opt_trans_rule co1 co2\r
221   | Just (s1,t1,r1) <- splitCoPredTy_maybe co1\r
222   , Just (s2,t2,r2) <- etaCoPred_maybe co2\r
223   = Just (mkCoPredTy (opt_trans s1 s2) (opt_trans t1 t2) (opt_trans r1 r2))\r
224 \r
225   | Just (s2,t2,r2) <- splitCoPredTy_maybe co2\r
226   , Just (s1,t1,r1) <- etaCoPred_maybe co1\r
227   = Just (mkCoPredTy (opt_trans s1 s2) (opt_trans t1 t2) (opt_trans r1 r2))\r
228 \r
229 -- Push transitivity inside forall\r
230 opt_trans_rule co1 co2\r
231   | Just (tv1,r1) <- splitTypeForAll_maybe co1\r
232   , Just (tv2,r2) <- etaForAll_maybe co2\r
233   , let r2' = substTyWith [tv2] [TyVarTy tv1] r2\r
234   = Just (ForAllTy tv1 (opt_trans2 r1 r2'))\r
235 \r
236   | Just (tv2,r2) <- splitTypeForAll_maybe co2\r
237   , Just (tv1,r1) <- etaForAll_maybe co1\r
238   , let r1' = substTyWith [tv1] [TyVarTy tv2] r1\r
239   = Just (ForAllTy tv1 (opt_trans2 r1' r2))\r
240 \r
241 opt_trans_rule co1 co2\r
242 {-      Omitting for now, because unsound\r
243   | Just (sym1, (ax_tc1, ax1_args, ax_tvs, ax_lhs, ax_rhs)) <- co1_is_axiom_maybe\r
244   , Just (sym2, (ax_tc2, ax2_args, _, _, _)) <- co2_is_axiom_maybe\r
245   , ax_tc1 == ax_tc2\r
246   , sym1 /= sym2\r
247   = Just $\r
248     if sym1 \r
249     then substTyWith ax_tvs (opt_transL (map mkSymCoercion ax1_args) ax2_args) ax_rhs\r
250     else substTyWith ax_tvs (opt_transL ax1_args (map mkSymCoercion ax2_args)) ax_lhs\r
251 -}\r
252 \r
253   | Just (sym, (ax_tc, ax_args, ax_tvs, ax_lhs, _)) <- co1_is_axiom_maybe\r
254   , Just cos <- matchesAxiomLhs ax_tvs ax_lhs co2\r
255   = Just $ \r
256     if sym \r
257     then mkSymCoercion $ TyConApp ax_tc (opt_transL (map mkSymCoercion cos) ax_args)\r
258     else                 TyConApp ax_tc (opt_transL ax_args cos)\r
259 \r
260   | Just (sym, (ax_tc, ax_args, ax_tvs, ax_lhs, _)) <- isAxiom_maybe co2\r
261   , Just cos <- matchesAxiomLhs ax_tvs ax_lhs co1\r
262   = Just $ \r
263     if sym \r
264     then mkSymCoercion $ TyConApp ax_tc (opt_transL ax_args (map mkSymCoercion cos))\r
265     else                 TyConApp ax_tc (opt_transL cos ax_args)\r
266   where\r
267     co1_is_axiom_maybe = isAxiom_maybe co1\r
268     co2_is_axiom_maybe = isAxiom_maybe co2\r
269 \r
270 opt_trans_rule co1 co2  -- Identity rule\r
271   | (ty1,_) <- coercionKind co1\r
272   , (_,ty2) <- coercionKind co2\r
273   , ty1 `coreEqType` ty2\r
274   = Just ty2\r
275 \r
276 opt_trans_rule _ _ = Nothing\r
277 \r
278 -----------  \r
279 isAxiom_maybe :: Coercion -> Maybe (Bool, (TyCon, [Coercion], [TyVar], Type, Type))\r
280 isAxiom_maybe co\r
281   | Just (tc, args) <- splitTyConApp_maybe co\r
282   , Just (_, desc)  <- isCoercionTyCon_maybe tc\r
283   = case desc of\r
284       CoAxiom { co_ax_tvs = tvs, co_ax_lhs = lhs, co_ax_rhs = rhs } \r
285             -> Just (False, (tc, args, tvs, lhs, rhs))\r
286       CoSym | (arg1:_) <- args  \r
287             -> case isAxiom_maybe arg1 of\r
288                  Nothing           -> Nothing\r
289                  Just (sym, stuff) -> Just (not sym, stuff)\r
290       _ -> Nothing\r
291   | otherwise\r
292   = Nothing\r
293 \r
294 matchesAxiomLhs :: [TyVar] -> Type -> Type -> Maybe [Type]\r
295 matchesAxiomLhs tvs ty_tmpl ty \r
296   = case tcMatchTy (mkVarSet tvs) ty_tmpl ty of\r
297       Nothing    -> Nothing\r
298       Just subst -> Just (map (substTyVar subst) tvs)\r
299 \r
300 -----------  \r
301 opt_trans_rule_equal_tc :: CoTyConDesc -> [Coercion] -> [Coercion] -> Maybe Coercion\r
302 -- Rules for Coercion TyCons only\r
303 \r
304 -- Push transitivity inside instantiation\r
305 opt_trans_rule_equal_tc desc [co1,ty1] [co2,ty2]\r
306   | CoInst <- desc\r
307   , ty1 `coreEqType` ty2\r
308   , co1 `compatible_co` co2\r
309   = Just (mkInstCoercion (opt_trans2 co1 co2) ty1) \r
310 \r
311 opt_trans_rule_equal_tc desc [co1] [co2]\r
312   | CoLeft  <- desc, is_compat = Just (mkLeftCoercion res_co)\r
313   | CoRight <- desc, is_compat = Just (mkRightCoercion res_co)\r
314   | CoCsel1 <- desc, is_compat = Just (mkCsel1Coercion res_co)\r
315   | CoCsel2 <- desc, is_compat = Just (mkCsel2Coercion res_co)\r
316   | CoCselR <- desc, is_compat = Just (mkCselRCoercion res_co)\r
317   where\r
318     is_compat = co1 `compatible_co` co2\r
319     res_co    = opt_trans2 co1 co2\r
320 \r
321 opt_trans_rule_equal_tc _ _ _ = Nothing\r
322 \r
323 -------------\r
324 compatible_co :: Coercion -> Coercion -> Bool\r
325 -- Check whether (co1 . co2) will be well-kinded\r
326 compatible_co co1 co2\r
327   = x1 `coreEqType` x2          \r
328   where\r
329     (_,x1) = coercionKind co1\r
330     (x2,_) = coercionKind co2\r
331 \r
332 -------------\r
333 etaForAll_maybe :: Coercion -> Maybe (TyVar, Coercion)\r
334 -- Try to make the coercion be of form (forall tv. co)\r
335 etaForAll_maybe co\r
336   | Just (tv, r) <- splitForAllTy_maybe co\r
337   , not (isCoVar tv)    -- Check it is a *type* forall, not a (t1~t2)=>co\r
338   = Just (tv, r)\r
339 \r
340   | (ty1,ty2) <- coercionKind co\r
341   , Just (tv1, _) <- splitTypeForAll_maybe ty1\r
342   , Just (tv2, _) <- splitTypeForAll_maybe ty2\r
343   , tyVarKind tv1 `eqKind` tyVarKind tv2\r
344   = Just (tv1, mkInstCoercion co (mkTyVarTy tv1))\r
345 \r
346   | otherwise\r
347   = Nothing\r
348 \r
349 etaCoPred_maybe :: Coercion -> Maybe (Coercion, Coercion, Coercion)\r
350 etaCoPred_maybe co \r
351   | Just (s,t,r) <- splitCoPredTy_maybe co\r
352   = Just (s,t,r)\r
353   \r
354   --  co :: (s1~t1)=>r1 ~ (s2~t2)=>r2\r
355   | (ty1,ty2) <- coercionKind co        -- We know ty1,ty2 have same kind\r
356   , Just (s1,_,_) <- splitCoPredTy_maybe ty1\r
357   , Just (s2,_,_) <- splitCoPredTy_maybe ty2\r
358   , typeKind s1 `eqKind` typeKind s2    -- t1,t2 have same kinds\r
359   = Just (mkCsel1Coercion co, mkCsel2Coercion co, mkCselRCoercion co)\r
360   \r
361   | otherwise\r
362   = Nothing\r
363 \r
364 etaApp_maybe :: Coercion -> Maybe (Coercion, Coercion)\r
365 etaApp_maybe co\r
366   | Just (co1, co2) <- splitAppTy_maybe co\r
367   = Just (co1, co2)\r
368 \r
369   | (ty1,ty2) <- coercionKind co\r
370   , Just (ty1a, _) <- splitAppTy_maybe ty1\r
371   , Just (ty2a, _) <- splitAppTy_maybe ty2\r
372   , typeKind ty1a `eqKind` typeKind ty2a\r
373   = Just (mkLeftCoercion co, mkRightCoercion co)\r
374 \r
375   | otherwise\r
376   = Nothing\r
377 \r
378 -------------\r
379 splitTypeForAll_maybe :: Type -> Maybe (TyVar, Type)\r
380 -- Returns Just only for a *type* forall, not a (t1~t2)=>co\r
381 splitTypeForAll_maybe ty\r
382   | Just (tv, rty) <- splitForAllTy_maybe ty\r
383   , not (isCoVar tv)\r
384   = Just (tv, rty)\r
385 \r
386   | otherwise\r
387   = Nothing\r
388 \r
389 -------------\r
390 isIdNormCo :: NormalCo -> Bool\r
391 -- Cheap identity test: look for coercions with no coercion variables at all\r
392 -- So it'll return False for (sym g `trans` g)\r
393 isIdNormCo ty = go ty\r
394   where\r
395     go (TyVarTy tv)            = not (isCoVar tv)\r
396     go (AppTy t1 t2)           = go t1 && go t2\r
397     go (FunTy t1 t2)           = go t1 && go t2\r
398     go (ForAllTy tv ty)        = go (tyVarKind tv) && go ty\r
399     go (TyConApp tc tys)       = not (isCoercionTyCon tc) && all go tys\r
400     go (PredTy (IParam _ ty))  = go ty\r
401     go (PredTy (ClassP _ tys)) = all go tys\r
402     go (PredTy (EqPred t1 t2)) = go t1 && go t2\r
403 \end{code}  \r