src/ata.ml

   1 (***********************************************************************)
   2 (*                                                                     *)
   3 (*                               TAToo                                 *)
   4 (*                                                                     *)
   5 (*                     Kim Nguyen, LRI UMR8623                         *)
   6 (*                   Université Paris-Sud & CNRS                       *)
   7 (*                                                                     *)
   8 (*  Copyright 2010-2013 Université Paris-Sud and Centre National de la *)
   9 (*  Recherche Scientifique. All rights reserved.  This file is         *)
  10 (*  distributed under the terms of the GNU Lesser General Public       *)
  11 (*  License, with the special exception on linking described in file   *)
  12 (*  ../LICENSE.                                                        *)
  13 (*                                                                     *)
  14 (***********************************************************************)
  15
  16 INCLUDE "utils.ml"
  17 open Format
  18 open Misc
  19 type move = [ `First_child
  20             | `Next_sibling
  21             | `Parent
  22             | `Previous_sibling
  23             | `Stay ]
  24
  25 type predicate = Move of move * State.t
  26                  | Is_first_child
  27                  | Is_next_sibling
  28                  | Is of Tree.NodeKind.t
  29                  | Has_first_child
  30                  | Has_next_sibling
  31
  32 module Atom =
  33 struct
  34
  35   module Node =
  36   struct
  37     type t = predicate
  38     let equal n1 n2 = n1 = n2
  39     let hash n = Hashtbl.hash n
  40   end
  41
  42   include Hcons.Make(Node)
  43
  44   let print ppf a =
  45     match a.node with
  46     | Move (m, q) -> begin
  47       match m with
  48         `First_child -> fprintf ppf "%s" Pretty.down_arrow
  49       | `Next_sibling -> fprintf ppf "%s" Pretty.right_arrow
  50       | `Parent -> fprintf ppf "%s" Pretty.up_arrow
  51       | `Previous_sibling -> fprintf ppf "%s" Pretty.left_arrow
  52       | `Stay -> fprintf ppf "%s" Pretty.bullet
  53     end;
  54         fprintf ppf "%a" State.print q
  55     | Is_first_child -> fprintf ppf "%s?" Pretty.up_arrow
  56     | Is_next_sibling -> fprintf ppf "%s?" Pretty.left_arrow
  57     | Is k -> fprintf ppf "is-%a?" Tree.NodeKind.print k
  58     | Has_first_child -> fprintf ppf "%s?" Pretty.down_arrow
  59     | Has_next_sibling -> fprintf ppf "%s?" Pretty.right_arrow
  60
  61 end
  62
  63
  64 module Formula =
  65 struct
  66   include Boolean.Make(Atom)
  67   open Tree.NodeKind
  68   let mk_atom a = atom_ (Atom.make a)
  69   let is k = mk_atom (Is k)
  70
  71   let has_first_child = mk_atom Has_first_child
  72
  73   let has_next_sibling = mk_atom Has_next_sibling
  74
  75   let is_first_child = mk_atom Is_first_child
  76
  77   let is_next_sibling = mk_atom Is_next_sibling
  78
  79   let is_attribute = mk_atom (Is Attribute)
  80
  81   let is_element = mk_atom (Is Element)
  82
  83   let is_processing_instruction = mk_atom (Is ProcessingInstruction)
  84
  85   let is_comment = mk_atom (Is Comment)
  86
  87   let mk_move m q = mk_atom (Move(m,q))
  88   let first_child q =
  89     and_
  90       (mk_move `First_child q)
  91       has_first_child
  92
  93   let next_sibling q =
  94   and_
  95     (mk_move `Next_sibling q)
  96     has_next_sibling
  97
  98   let parent q =
  99   and_
 100     (mk_move `Parent  q)
 101     is_first_child
 102
 103   let previous_sibling q =
 104   and_
 105     (mk_move `Previous_sibling q)
 106     is_next_sibling
 107
 108   let stay q = mk_move `Stay q
 109
 110   let get_states phi =
 111     fold (fun phi acc ->
 112       match expr phi with
 113       | Boolean.Atom ({ Atom.node = Move(_,q) ; _ }, _) ->  StateSet.add q acc
 114       | _ -> acc
 115     ) phi StateSet.empty
 116
 117 end
 118
 119 module Transition =
 120   struct
 121     include Hcons.Make (struct
 122   type t = State.t * QNameSet.t * Formula.t
 123   let equal (a, b, c) (d, e, f) =
 124     a == d && b == e && c == f
 125   let hash (a, b, c) =
 126     HASHINT4 (PRIME1, a, ((QNameSet.uid b) :> int), ((Formula.uid c) :> int))
 127 end)
 128     let print ppf t =
 129       let q, l, f = t.node in
 130       fprintf ppf "%a, %a %s %a"
 131         State.print q
 132         QNameSet.print l
 133         Pretty.double_right_arrow
 134         Formula.print f
 135   end
 136
 137
 138 module TransList : sig
 139   include Hlist.S with type elt = Transition.t
 140   val print : Format.formatter -> ?sep:string -> t -> unit
 141 end =
 142   struct
 143     include Hlist.Make(Transition)
 144     let print ppf ?(sep="\n") l =
 145       iter (fun t ->
 146         let q, lab, f = Transition.node t in
 147         fprintf ppf "%a, %a -> %a%s" State.print q QNameSet.print lab Formula.print f sep) l
 148   end
 149
 150
 151
 152 type t = {
 153   id : Uid.t;
 154   mutable states : StateSet.t;
 155   mutable starting_states : StateSet.t;
 156   mutable selecting_states: StateSet.t;
 157   transitions: (State.t, (QNameSet.t*Formula.t) list) Hashtbl.t;
 158 }
 159
 160 let uid t = t.id
 161
 162 let get_states a = a.states
 163 let get_starting_states a = a.starting_states
 164 let get_selecting_states a = a.selecting_states
 165
 166
 167 let _pr_buff = Buffer.create 50
 168 let _str_fmt = formatter_of_buffer _pr_buff
 169 let _flush_str_fmt () = pp_print_flush _str_fmt ();
 170   let s = Buffer.contents _pr_buff in
 171   Buffer.clear _pr_buff; s
 172
 173 let print fmt a =
 174   let _ = _flush_str_fmt() in
 175   fprintf fmt
 176     "Internal UID: %i@\n\
 177      States: %a@\n\
 178      Starting states: %a@\n\
 179      Selection states: %a@\n\
 180      Alternating transitions:@\n"
 181     (a.id :> int)
 182     StateSet.print a.states
 183     StateSet.print a.starting_states
 184     StateSet.print a.selecting_states;
 185   let trs =
 186     Hashtbl.fold
 187       (fun q t acc -> List.fold_left (fun acc (s , f) -> (q,s,f)::acc) acc t)
 188       a.transitions
 189       []
 190   in
 191   let sorted_trs = List.stable_sort (fun (q1, s1, _) (q2, s2, _) ->
 192     let c = State.compare q1 q2 in - (if c == 0 then QNameSet.compare s1 s2 else c))
 193     trs
 194   in
 195   let _ = _flush_str_fmt () in
 196   let strs_strings, max_pre, max_all = List.fold_left (fun (accl, accp, acca) (q, s, f) ->
 197     let s1 = State.print _str_fmt q; _flush_str_fmt () in
 198     let s2 = QNameSet.print _str_fmt s;  _flush_str_fmt () in
 199     let s3 = Formula.print _str_fmt f;  _flush_str_fmt () in
 200     let pre = Pretty.length s1 + Pretty.length s2 in
 201     let all = Pretty.length s3 in
 202     ( (q, s1, s2, s3) :: accl, max accp pre, max acca all)
 203   ) ([], 0, 0) sorted_trs
 204   in
 205   let line = Pretty.line (max_all + max_pre + 6) in
 206   let prev_q = ref State.dummy in
 207   fprintf fmt "%s@\n" line;
 208   List.iter (fun (q, s1, s2, s3) ->
 209     if !prev_q != q && !prev_q != State.dummy then fprintf fmt "%s@\n"  line;
 210     prev_q := q;
 211     fprintf fmt "%s, %s" s1 s2;
 212     fprintf fmt "%s" (Pretty.padding (max_pre - Pretty.length s1 - Pretty.length s2));
 213     fprintf fmt " %s  %s@\n" Pretty.right_arrow s3;
 214   ) strs_strings;
 215   fprintf fmt "%s@\n" line
 216
 217
 218 let get_trans a tag states =
 219   StateSet.fold (fun q acc0 ->
 220     try
 221       let trs = Hashtbl.find a.transitions q in
 222       List.fold_left (fun acc1 (labs, phi) ->
 223         if QNameSet.mem tag labs then
 224           TransList.cons (Transition.make (q, labs, phi)) acc1
 225         else acc1) acc0 trs
 226     with Not_found -> acc0
 227   ) states TransList.nil
 228
 229
 230
 231
 232 (*
 233   [complete transitions a] ensures that for each state q
 234   and each symbols s in the alphabet, a transition q, s exists.
 235   (adding q, s -> F when necessary).
 236 *)
 237
 238 let complete_transitions a =
 239   StateSet.iter (fun q ->
 240     if StateSet.mem q a.starting_states then ()
 241     else
 242       let qtrans = Hashtbl.find a.transitions q in
 243       let rem =
 244         List.fold_left (fun rem (labels, _) ->
 245           QNameSet.diff rem labels) QNameSet.any qtrans
 246       in
 247       let nqtrans =
 248         if QNameSet.is_empty rem then qtrans
 249         else
 250           (rem, Formula.false_) :: qtrans
 251       in
 252       Hashtbl.replace a.transitions q nqtrans
 253   ) a.states
 254
 255 (* [cleanup_states] remove states that do not lead to a
 256    selecting states *)
 257
 258 let cleanup_states a =
 259   let memo = ref StateSet.empty in
 260   let rec loop q =
 261     if not (StateSet.mem q !memo) then begin
 262       memo := StateSet.add q !memo;
 263       let trs = try Hashtbl.find a.transitions q with Not_found -> [] in
 264       List.iter (fun (_, phi) ->
 265         StateSet.iter loop (Formula.get_states phi)) trs
 266     end
 267   in
 268   StateSet.iter loop a.selecting_states;
 269   let unused = StateSet.diff a.states !memo in
 270   StateSet.iter (fun q -> Hashtbl.remove a.transitions q) unused;
 271   a.states <- !memo
 272
 273 (* [normalize_negations a] removes negative atoms in the formula
 274    complementing the sub-automaton in the negative states.
 275    [TODO check the meaning of negative upward arrows]
 276 *)
 277
 278 let normalize_negations auto =
 279   let memo_state = Hashtbl.create 17 in
 280   let todo = Queue.create () in
 281   let rec flip b f =
 282     match Formula.expr f with
 283       Boolean.True | Boolean.False -> if b then f else Formula.not_ f
 284     | Boolean.Or(f1, f2) -> (if b then Formula.or_ else Formula.and_)(flip b f1) (flip b f2)
 285     | Boolean.And(f1, f2) -> (if b then Formula.and_ else Formula.or_)(flip b f1) (flip b f2)
 286     | Boolean.Atom(a, b') -> begin
 287       match a.Atom.node with
 288       | Move (m,  q) ->
 289           if b == b' then begin
 290           (* a appears positively, either no negation or double negation *)
 291             if not (Hashtbl.mem memo_state (q,b)) then Queue.add (q,true) todo;
 292             Formula.mk_atom (Move(m, q))
 293           end else begin
 294         (* need to reverse the atom
 295            either we have a positive state deep below a negation
 296            or we have a negative state in a positive formula
 297            b' = sign of the state
 298            b = sign of the enclosing formula
 299         *)
 300             let not_q =
 301               try
 302             (* does the inverted state of q exist ? *)
 303                 Hashtbl.find memo_state (q, false)
 304               with
 305                 Not_found ->
 306               (* create a new state and add it to the todo queue *)
 307                   let nq = State.make () in
 308                   auto.states <- StateSet.add nq auto.states;
 309                   Hashtbl.add memo_state (q, false) nq;
 310                   Queue.add (q, false) todo; nq
 311             in
 312             Formula.mk_atom (Move (m,not_q))
 313           end
 314       | _ -> if b then f else Formula.not_ f
 315     end
 316   in
 317   (* states that are not reachable from a selection stat are not interesting *)
 318   StateSet.iter (fun q -> Queue.add (q, true) todo) auto.selecting_states;
 319
 320   while not (Queue.is_empty todo) do
 321     let (q, b) as key = Queue.pop todo in
 322     let q' =
 323       try
 324         Hashtbl.find memo_state key
 325       with
 326         Not_found ->
 327           let nq = if b then q else
 328               let nq = State.make () in
 329               auto.states <- StateSet.add nq auto.states;
 330               nq
 331           in
 332           Hashtbl.add memo_state key nq; nq
 333     in
 334     let trans = try Hashtbl.find auto.transitions q with Not_found -> [] in
 335     let trans' = List.map (fun (lab, f) -> lab, flip b f) trans in
 336     Hashtbl.replace auto.transitions q' trans';
 337   done;
 338   cleanup_states auto
 339
 340
 341
 342
 343
 344 module Builder =
 345   struct
 346     type auto = t
 347     type t = auto
 348     let next = Uid.make_maker ()
 349
 350     let make () =
 351       let auto =
 352         {
 353           id = next ();
 354           states = StateSet.empty;
 355           starting_states = StateSet.empty;
 356           selecting_states = StateSet.empty;
 357           transitions = Hashtbl.create MED_H_SIZE;
 358         }
 359       in
 360       (*
 361       at_exit (fun () ->
 362         let n4 = ref 0 in
 363         let n2 = ref 0 in
 364         Cache.N2.iteri (fun _ _ _ b -> if b then incr n2) auto.cache2;
 365         Cache.N4.iteri (fun _ _ _ _ _ b -> if b then incr n4) auto.cache4;
 366         Logger.msg `STATS "automaton %i, cache2: %i entries, cache6: %i entries"
 367           (auto.id :> int) !n2 !n4;
 368         let c2l, c2u = Cache.N2.stats auto.cache2 in
 369         let c4l, c4u = Cache.N4.stats auto.cache4 in
 370         Logger.msg `STATS
 371           "cache2: length: %i, used: %i, occupation: %f"
 372           c2l c2u (float c2u /. float c2l);
 373         Logger.msg `STATS
 374           "cache4: length: %i, used: %i, occupation: %f"
 375           c4l c4u (float c4u /. float c4l)
 376
 377       ); *)
 378       auto
 379
 380     let add_state a ?(starting=false) ?(selecting=false) q =
 381       a.states <- StateSet.add q a.states;
 382       if starting then a.starting_states <- StateSet.add q a.starting_states;
 383       if selecting then a.selecting_states <- StateSet.add q a.selecting_states
 384
 385     let add_trans a q s f =
 386       if not (StateSet.mem q a.states) then add_state a q;
 387       let trs = try Hashtbl.find a.transitions q with Not_found -> [] in
 388       let cup, ntrs =
 389         List.fold_left (fun (acup, atrs) (labs, phi) ->
 390           let lab1 = QNameSet.inter labs s in
 391           let lab2 = QNameSet.diff labs s in
 392           let tr1 =
 393             if QNameSet.is_empty lab1 then []
 394             else [ (lab1, Formula.or_ phi f) ]
 395           in
 396           let tr2 =
 397             if QNameSet.is_empty lab2 then []
 398             else [ (lab2, Formula.or_ phi f) ]
 399           in
 400           (QNameSet.union acup labs, tr1@ tr2 @ atrs)
 401         ) (QNameSet.empty, []) trs
 402       in
 403       let rem = QNameSet.diff s cup in
 404       let ntrs = if QNameSet.is_empty rem then ntrs
 405         else (rem, f) :: ntrs
 406       in
 407       Hashtbl.replace a.transitions q ntrs
 408
 409     let finalize a =
 410       complete_transitions a;
 411       normalize_negations a;
 412       a
 413   end
 414
 415
 416 let map_set f s =
 417   StateSet.fold (fun q a -> StateSet.add (f q) a) s StateSet.empty
 418
 419 let map_hash fk fv h =
 420   let h' = Hashtbl.create (Hashtbl.length h) in
 421   let () = Hashtbl.iter (fun k v -> Hashtbl.add h' (fk k) (fv v)) h in
 422   h'
 423
 424 let rec map_form f phi =
 425   match Formula.expr phi with
 426   | Boolean.Or(phi1, phi2) -> Formula.or_ (map_form f phi1) (map_form f phi2)
 427   | Boolean.And(phi1, phi2) -> Formula.and_ (map_form f phi1) (map_form f phi2)
 428   | Boolean.Atom({ Atom.node = Move(m,q); _}, b) ->
 429       let a = Formula.mk_atom (Move (m,f q)) in
 430       if b then a else Formula.not_ a
 431   | _ -> phi
 432
 433 let rename_states mapper a =
 434   let rename q = try Hashtbl.find mapper q with Not_found -> q in
 435   { Builder.make () with
 436     states = map_set rename a.states;
 437     starting_states = map_set rename a.starting_states;
 438     selecting_states = map_set rename a.selecting_states;
 439     transitions =
 440       map_hash
 441         rename
 442         (fun l ->
 443           (List.map (fun (labels, form) -> (labels, map_form rename form)) l))
 444         a.transitions;
 445   }
 446
 447 let copy a =
 448   let mapper = Hashtbl.create MED_H_SIZE in
 449   let () =
 450     StateSet.iter (fun q -> Hashtbl.add mapper q (State.make())) a.states
 451   in
 452   rename_states mapper a
 453
 454
 455 let concat a1 a2 =
 456   let a1 = copy a1 in
 457   let a2 = copy a2 in
 458   let link_phi =
 459     StateSet.fold
 460       (fun q phi -> Formula.(or_ (stay q) phi))
 461       a1.selecting_states Formula.false_
 462   in
 463   Hashtbl.iter (fun q trs -> Hashtbl.add a1.transitions q trs)
 464     a2.transitions;
 465   StateSet.iter
 466     (fun q ->
 467       Hashtbl.replace a1.transitions q [(QNameSet.any, link_phi)])
 468     a2.starting_states;
 469   { a1 with
 470     states = StateSet.union a1.states a2.states;
 471     selecting_states = a2.selecting_states;
 472     transitions = a1.transitions;
 473   }
 474
 475 let merge a1 a2 =
 476   let a1 = copy a1 in
 477   let a2 = copy a2 in
 478   { a1 with
 479     states = StateSet.union a1.states a2.states;
 480     selecting_states = StateSet.union a1.selecting_states a2.selecting_states;
 481     starting_states = StateSet.union a1.starting_states a2.starting_states;
 482     transitions =
 483       let () =
 484         Hashtbl.iter (fun k v -> Hashtbl.add a1.transitions k v) a2.transitions
 485       in
 486       a1.transitions
 487   }