1 % (c) 2009-2025 Lehrstuhl fuer Softwaretechnik und Programmiersprachen,
2 % Heinrich Heine Universitaet Duesseldorf
3 % This software is licenced under EPL 1.0 (http://www.eclipse.org/org/documents/epl-v10.html)
4
5
6 :- module(memoization,[store_memo_expansion/3,
7 get_stored_memo_expansion/3,
8 compute_memo_hash/2,
9 store_memo_computation_time/2, % for profiling
10
11 register_memoization_function/6,
12 get_registered_function/2, get_registered_function/3,
13 get_registered_function_name/2,
14 is_registered_function_name/1, is_registered_function_name/2,
15 is_memoization_closure/2, is_memoization_closure/4,
16 get_memoization_closure_value/4,
17 %expand_memoize_stored_function_reference/2,
18 store_memo_result/6,
19 get_stored_memo_result/4,
20 apply_to_memoize/8,
21 get_complete_memoization_expansion/6,
22 element_of_memoization_closure/6,
23 not_element_of_memoization_closure/6,
24 is_lambda_value_domain_memoization_closure/5,
25
26 export_memo_state/1,
27 import_memo_state/1,
28
29 tcltk_get_memo_profile_table/1,
30 print_memo_profile/0,
31 reset_memo_table/0,
32 reset_memo_with_statistics/0]).
33
34 :- use_module(error_manager).
35 :- use_module(debug).
36
37 :- use_module(module_information,[module_info/2]).
38 :- module_info(group,kernel).
39 :- module_info(description,'This module provides memoization features (for closure expansion, closure1,...).').
40 % used when use_closure_expansion_memoization is true
41
42 :- use_module(probsrc(closures),[is_symbolic_closure/3]).
43 :- use_module(probsrc(kernel_waitflags),[add_error_wf/5, add_message_wf/5, add_warning_wf/5]).
44
45 :- use_module(extension('counter/counter'),[counter_init/0, reset_counter/1,
46 new_counter/1, inc_counter/2, set_counter/2,
47 get_counter/2]).
48
49
50 :- use_module(eventhandling,[register_event_listener/3]).
51 :- register_event_listener(startup_prob,init_memo_table,
52 'Initialise Preferences').
53 :- register_event_listener(clear_specification,reset_memo_table,
54 'Reset Temporary Preferences.').
55
56
57
58 % ---------------- Memoization for set comprehension / lambda / closure1 expansion:
59
60 get_stored_memo_expansion(Hash,Term,Result) :-
61 stored_memo_expansion(Hash,Term,Result),
62 inc_counter(memoization_reuse_counter,_).
63
64 :- dynamic stored_memo_expansion/3.
65
66 store_memo_expansion(Hash,LookupTerm,StoredResult) :-
67 assertz(stored_memo_expansion(Hash,LookupTerm,StoredResult)).
68
69 :- if(current_prolog_flag(dialect, sicstus)).
70 :- use_module(library(terms),[term_hash/3]).
71 compute_memo_hash(LookupTerm,Hash) :-
72 inc_counter(memoization_hash_counter,_),
73 term_hash(LookupTerm,
74 [range(smallint),algorithm(sdbm), depth(infinite),if_var(ignore)],Hash).
75 %hashing:my_term_hash(closure(Parameters,ParameterTypes,ClosureBody),Hash),
76 %inc(Hash), %
77 :- else.
78 :- use_module(hashing,[my_term_hash/2]).
79 compute_memo_hash(LookupTerm,Hash) :-
80 inc_counter(memoization_hash_counter,_),
81 my_term_hash(LookupTerm,Hash).
82 :- endif.
83
84 % ---------------- Memoization for function application
85
86 :- dynamic registered_value_packed/3, registered_value_name/2, memoization_expansion_completed/1.
87
88 % we register the functions to be memoized
89 get_registered_function(Id,Val) :- registered_value(Id,_,Val).
90 get_registered_function(Id,Name,Val) :- registered_value(Id,Name,Val).
91 get_registered_function_name(Id,Name) :- registered_value_name(Id,Name).
92 is_registered_function_name(Name) :- registered_value_name(_,Name).
93 is_registered_function_name(Name,Expanded) :- registered_value_name(ID,Name),
94 (memoization_expansion_completed(ID) -> Expanded=true ; Expanded=false).
95
96 :- use_module(tools,[remove_variables/3]).
97 :- use_module(kernel_tools,[ground_value_check/2, value_variables/2]).
98 % register a (usually symbolic closure) value as a function
99 % ElType is the type of the elements of the function and MemoResultClosure is a closure that
100 % can and should be used instead of BValue to ensure memoization works
101 register_memoization_function(Name,BValue,ElType,RecursionInfo,MemoID,MemoResultClosure) :-
102 value_variables(BValue,Vars),
103 %print(vars(Name,Vars,LHSValue)),nl, print(bvalue(BValue)),nl,
104 (RecursionInfo='$recursion_value'(RecValue)
105 -> remove_variables(Vars,[RecValue],WVars), % do not wait on RecValue; it will be set by registering MEMOID
106 RecValue = MemoResultClosure,
107 InnerMemoID=MemoID % already instantiate MemoID before asserting closure; cyclic use
108 ; WVars=Vars
109 ),
110 ground_value_check(WVars,Ground),
111 %print(register(Name,MemoID,Ground,BValue)),nl,nl,
112 construct_memoization_closure(MemoID,BValue,ElType,MemoResultClosure),
113 register_memoization_function_aux(Ground,Name,BValue,InnerMemoID,MemoID).
114
115 :- block register_memoization_function_aux(-,?,?,?,?).
116 register_memoization_function_aux(_,Name,BValue,InnerMemoID,MemoID) :-
117 inc_counter(memoization_function_counter,InnerMemoID),
118 formatsilent('Registering function ~w for memoization: ~w~n',[InnerMemoID,Name]),
119 (ground_value(BValue) -> true ; add_internal_error('Non ground memo closure: ',InnerMemoID:BValue)),
120 %(BValue=closure(_,_,BB) -> bsyntaxtree:check_used_ids_in_ast(BB) ; true),
121 compile_value(BValue,InnerMemoID),
122 assertz(registered_value_name(InnerMemoID,Name)),
123 assert_registered_value(InnerMemoID,Name,BValue),
124 %if(MemoID=InnerMemoID, format('Finish ~w~n',[MemoID]),format('FAILURE ~w~n',[InnerMemoID])).
125 MemoID=InnerMemoID. % only unify after assertz; in case co-routines are triggered which call get_registered_function
126
127 :- use_module(state_packing,[pack_value/2,unpack_value/2]).
128 assert_registered_value(InnerMemoID,Name,BValue) :-
129 pack_value(BValue,PValue),
130 % mainly useful when COMPRESSION preference is full or
131 % when force_state_packing_for_closures is true so that closure bodies packed
132 assertz(registered_value_packed(InnerMemoID,Name,PValue)).
133
134 registered_value(InnerMemoID,Name,BValue) :-
135 registered_value_packed(InnerMemoID,Name,PValue),
136 unpack_value(PValue,BValue).
137
138 :- load_files(library(system), [when(compile_time), imports([environ/2])]).
139 :- if(environ(cogen,true)).
140 compile_value(closure(Paras,Ty,Body),InnerMemoID) :-
141 compile_closure(Paras,Ty,Body,InnerMemoID),!.
142 compile_value(_,_).
143 :- use_module(b_cogen).
144 :- else.
145 compile_value(_,_).
146 reset_cogen.
147 :- endif.
148
149 construct_memoization_closure(MemoID,BValue,ElType,Result) :-
150 get_infos(BValue,BInfos),
151 XFC = b(external_function_call('MEMOIZE_STORED_FUNCTION',[b(value(int(MemoID)),integer,[])]),set(ElType),[]),
152 TID = b(identifier('_zzzz_unary'),ElType,[]),
153 Body = b(member(TID,XFC),pred,[prob_annotation('MEMOIZE'(MemoID))|BInfos]),
154 %bsyntaxtree:check_used_ids_in_ast(Body),
155 Result = closure(['_zzzz_unary'],[ElType], Body).
156
157 :- use_module(bsyntaxtree,[get_texpr_info/2, extract_info_wo_used_ids/2, extract_pos_infos/2]). % extract_info_wo_used_ids
158 % extract important infos,
159 get_infos(Var,Res) :- var(Var),!,Res=[].
160 get_infos(closure(_,_,B),Res) :- extract_info_wo_used_ids(B,Infos),!,
161 get_texpr_info(B,AllInfos),extract_pos_infos(AllInfos,Pos),
162 append(Pos,Infos,Res).
163 get_infos(_,[]). % :- print(no_infos(A)),nl.
164
165 is_memoization_closure(closure(Ids,T,Body),MemoID) :-
166 is_memoization_closure(Ids,T,Body,MemoID).
167
168 :- use_module(bsyntaxtree, [get_texpr_id/2]).
169 is_memoization_closure([ID],_T,b(Body,_,INFO),MemoID) :-
170 ? member(prob_annotation('MEMOIZE'(MemoID)),INFO),
171 % check Body has not been rewritten:
172 Body = member(TID,b(RHS,_,_)),
173 get_texpr_id(TID,ID),
174 is_memoize_stored_function_reference(RHS,MemoID),
175 (var(MemoID) -> add_error(memoization,'Memoized function ID not ground: ',MemoID)
176 ; registered_value_name(MemoID,_) -> true ;
177 add_error(memoization,'Memoized function ID not registered: ',MemoID),
178 fail).
179
180 is_memoize_stored_function_reference(external_function_call('MEMOIZE_STORED_FUNCTION',[Arg]),MemoID) :-
181 Arg=b(value(int(MemoID)),_,_).
182
183 % check if we have a memoization closure and get its stored value
184 get_memoization_closure_value(P,T,B,Value) :-
185 is_memoization_closure(P,T,B,MemoID),
186 number(MemoID),
187 registered_value(MemoID,_,Value).
188
189 % expand an (untyped) expression term referring to a stored function into full value:
190 %expand_memoize_stored_function_reference(Expr,Value) :-
191 % is_memoize_stored_function_reference(Expr,MemoID),
192 % number(MemoID), % in case this is called before function registered
193 % registered_value(MemoID,_,Value).
194
195 :- use_module(probsrc(closures),[is_lambda_value_domain_normal_closure/5]).
196 :- dynamic stored_lambda_value_domain/3.
197 % Note: the caller must check that DomainValue, Expr are not equal to fail
198 is_lambda_value_domain_memoization_closure(P,T,Pred, DomainValue,Expr) :-
199 ? is_memoization_closure(P,T,Pred,MemoID),
200 number(MemoID),
201 (stored_lambda_value_domain(MemoID,DV,E)
202 -> true %print(get_domain(MemoID)),nl
203 ; registered_value(MemoID,_,closure(P2,T2,Pred2)),
204 %print(storing(lambda_domain(MemoID))),nl,
205 (is_lambda_value_domain_normal_closure(P2,T2,Pred2, DV,E)
206 -> assertz(stored_lambda_value_domain(MemoID,DV,E))
207 ; assertz(stored_lambda_value_domain(MemoID,fail,fail)),
208 fail
209 )
210 ),
211 DomainValue=DV, Expr = E.
212
213
214 % ----------------------------------------------
215 % providing stored_memo_result_id/4 fact interface
216 % some MemoID are stored in separate table
217 :- dynamic stored_memo_result1/3, stored_memo_result2/3,
218 stored_memo_result3/3, stored_memo_result4/3,
219 stored_memo_result5/3, stored_memo_result6/3,
220 stored_memo_result7/3, stored_memo_result8/3,
221 stored_memo_result/4.
222 stored_memo_result_id(1,ArgHash,Argument,StoredResult) :- !,
223 ? stored_memo_result1(ArgHash,Argument,StoredResult).
224 stored_memo_result_id(2,ArgHash,Argument,StoredResult) :- !,
225 stored_memo_result2(ArgHash,Argument,StoredResult).
226 stored_memo_result_id(3,ArgHash,Argument,StoredResult) :- !,
227 stored_memo_result3(ArgHash,Argument,StoredResult).
228 stored_memo_result_id(4,ArgHash,Argument,StoredResult) :- !,
229 stored_memo_result4(ArgHash,Argument,StoredResult).
230 stored_memo_result_id(5,ArgHash,Argument,StoredResult) :- !,
231 ? stored_memo_result5(ArgHash,Argument,StoredResult).
232 stored_memo_result_id(6,ArgHash,Argument,StoredResult) :- !,
233 ? stored_memo_result6(ArgHash,Argument,StoredResult).
234 stored_memo_result_id(7,ArgHash,Argument,StoredResult) :- !,
235 ? stored_memo_result7(ArgHash,Argument,StoredResult).
236 stored_memo_result_id(8,ArgHash,Argument,StoredResult) :- !,
237 ? stored_memo_result8(ArgHash,Argument,StoredResult).
238 stored_memo_result_id(MemoID,ArgHash,Argument,StoredResult) :-
239 ? stored_memo_result(ArgHash,MemoID,Argument,StoredResult).
240
241 assert_stored_memo_result_id(1,ArgHash,Argument,StoredResult) :- !,
242 assertz(stored_memo_result1(ArgHash,Argument,StoredResult)).
243 assert_stored_memo_result_id(2,ArgHash,Argument,StoredResult) :- !,
244 assertz(stored_memo_result2(ArgHash,Argument,StoredResult)).
245 assert_stored_memo_result_id(3,ArgHash,Argument,StoredResult) :- !,
246 assertz(stored_memo_result3(ArgHash,Argument,StoredResult)).
247 assert_stored_memo_result_id(4,ArgHash,Argument,StoredResult) :- !,
248 assertz(stored_memo_result4(ArgHash,Argument,StoredResult)).
249 assert_stored_memo_result_id(5,ArgHash,Argument,StoredResult) :- !,
250 assertz(stored_memo_result5(ArgHash,Argument,StoredResult)).
251 assert_stored_memo_result_id(6,ArgHash,Argument,StoredResult) :- !,
252 assertz(stored_memo_result6(ArgHash,Argument,StoredResult)).
253 assert_stored_memo_result_id(7,ArgHash,Argument,StoredResult) :- !,
254 assertz(stored_memo_result7(ArgHash,Argument,StoredResult)).
255 assert_stored_memo_result_id(8,ArgHash,Argument,StoredResult) :- !,
256 assertz(stored_memo_result8(ArgHash,Argument,StoredResult)).
257 assert_stored_memo_result_id(MemoID,ArgHash,Argument,StoredResult) :-
258 assertz(stored_memo_result(ArgHash,MemoID,Argument,StoredResult)).
259
260 retractall_stored_memo_result :-
261 retractall(stored_memo_result1(_,_,_)),
262 retractall(stored_memo_result2(_,_,_)),
263 retractall(stored_memo_result3(_,_,_)),
264 retractall(stored_memo_result4(_,_,_)),
265 retractall(stored_memo_result5(_,_,_)),
266 retractall(stored_memo_result6(_,_,_)),
267 retractall(stored_memo_result7(_,_,_)),
268 retractall(stored_memo_result8(_,_,_)),
269 retractall(stored_memo_result(_,_,_,_)).
270
271 % this clause is only ok if we have just a single function; otherwise we get collisions between different functions
272 compute_funcall_memo_hash(int(X),MemoID,R) :- MemoID <9, !,
273 R=X. % avoid computing hash for simple integer values; only drawback: indexing not good for too large integers
274 % TO DO: we could register with each registered_value fact also a dynamic table_memo fact
275 % then we can avoid clashes between different memoized functions
276 compute_funcall_memo_hash(X,MemoID,ArgHash) :-
277 compute_memo_hash((MemoID,X),ArgHash).
278
279
280 % --------------------------------------------
281
282 % last argument should be left free when calling
283 get_stored_memo_result(MemoID,Argument,ArgHash,StoredResult) :-
284 stored_memo_result_id(MemoID,ArgHash,Argument,StoredResult),
285 %print(get_stored(MemoID,ArgHash,StoredResult)),nl,
286 count_reuse(MemoID).
287
288
289 :- use_module(kernel_waitflags,[add_wd_error_span/4]).
290 :- use_module(tools_strings,[ajoin/2]).
291 :- use_module(store,[normalise_value_for_var/3]).
292 store_memo_result(MemoID,Argument,ArgHash,Result,Span,WF) :-
293 normalise_value_for_var(MemoID,Result,NormResult),
294 store_norm_memo_result(MemoID,Argument,ArgHash,NormResult,Span,WF).
295
296 :- use_module(kernel_objects,[equal_object/2]).
297 store_norm_memo_result(MemoID,Argument,ArgHash,Result,Span,WF) :-
298 stored_memo_result_id(MemoID,ArgHash,Argument,StoredResult),
299 !,
300 (Result=StoredResult -> true
301 ; equal_object(Result,StoredResult) -> format('Two representations for memoized function (~w) result.~n',[MemoID])
302 ; ajoin(['Memoized function ',MemoID,' has multiple results for: '],Msg),
303 Relation = [(Argument,StoredResult),(Argument,Result)],
304 add_wd_error_span(Msg,'@fun'(Argument,Relation),Span,WF)
305 %,print('stored: '),translate:print_bvalue(StoredResult),nl,print('new: '),translate:print_bvalue(Result),nl
306 ).
307 store_norm_memo_result(MemoID,Argument,ArgHash,Result,_,_) :-
308 %format('Storing memo result for ~w, argument =',[MemoID]),
309 %translate:print_bvalue(Argument),nl, translate:print_bvalue(Result),nl,
310 assert_stored_memo_result_id(MemoID,ArgHash,Argument,Result).
311 %assertz(stored_memo_result(ArgHash,MemoID,Argument,Result)).
312 %print(stored_memo_result(ArgHash,MemoID,Argument,Result)),nl.
313
314
315 % function application for memoized function:
316 apply_to_memoize(MemoID,P,T,B,X,Y,Span,WF) :-
317 ground_value_check(X,XV),
318 ? block_apply_closure_memo_groundx(XV,MemoID,X,Y,P,T,B,raise_wd,Span,WF).
319
320 :- use_module(kernel_tools,[ground_value/1]).
321 :- use_module(kernel_objects,[equal_object_wf/3]).
322
323 :- block block_apply_closure_memo_groundx(-,?, ?,?, ?,?,?, ?,?,?),
324 block_apply_closure_memo_groundx(?,-, ?,?, ?,?,?, ?,?,?).
325
326
327 block_apply_closure_memo_groundx(_,MemoID, X,Y, P,T,B, RaiseWD, Span,WF) :-
328 % MemoID is ground, meaning body B is ground as well
329 % TODO: obtain stored value directly
330 compute_funcall_memo_hash(X,MemoID,ArgHash),
331 if(get_stored_memo_result(MemoID,X,ArgHash,StoredResult),
332 ? equal_object_wf(Y,StoredResult,WF),
333 (start_profile_function_application(MemoID,Timer),
334 ? if(check_element_of_function_closure_nowf(MemoID,X,ComputedResult,P,T,B,Span,WF),
335 % ground WF to compute ground value for ComputedResult
336 (stop_profile_function_application(MemoID,X,Timer,WF),
337 (ground_value(ComputedResult)
338 -> store_memo_result(MemoID,X,ArgHash,ComputedResult,Span,WF)
339 ; add_error_wf(memoization,'Could not compute ground value for function application',MemoID,Span,WF),
340 print('Argument: '),translate:print_bvalue(X),nl,
341 print('Result: '), print(ComputedResult),nl,
342 print('Function: '),registered_value(MemoID,_Name,FunValue), translate:print_bvalue(FunValue),nl,nl
343 ),
344 % To do: check if we compute two or more solutions for f(X) and add WD error
345 equal_object_wf(Y,ComputedResult,WF)
346 ),
347 (RaiseWD=raise_wd,
348 add_wd_error_span('function applied outside of domain (#8-Memo): ', '@fun'(X,closure(P,T,B)),Span,WF)
349 )
350 )
351 )
352 ).
353
354 :- use_module(kernel_waitflags, [init_wait_flags/2, init_wait_flags_and_push_call_stack/3,ground_wait_flags/1]).
355 :- use_module(custom_explicit_sets,[check_element_of_function_closure/6]).
356 check_element_of_function_closure_nowf(MemoID,X,ComputedResult,_,_,_,Span,OuterWF) :-
357 registered_value(MemoID,Name,closure(P,T,B)),!, % can be expensive if closure contains large values
358 init_wait_flags_and_push_call_stack(OuterWF,function_call(Name,X,Span),WF), % slows down test 1968 with recursion
359 check_element_of_function_closure(X,ComputedResult,P,T,B,WF),
360 ? ground_wait_flags(WF).
361 check_element_of_function_closure_nowf(_,X,ComputedResult,P,T,B,_Span,_OuterWF) :-
362 init_wait_flags(WF,[check_element_of_function_closure_nowf]),
363 check_element_of_function_closure(X,ComputedResult,P,T,B,WF),
364 ground_wait_flags(WF).
365
366 :- use_module(library(avl),[avl_domain/2]).
367 :- use_module(library(lists),[maplist/2]).
368
369 % store the complete expansion of a memoized function for later re-use
370 % and also passes result and done flag to an outer call
371 :- block store_memoization_closure_expansion(?,-,?,?,?,?,?).
372 store_memoization_closure_expansion(MemoID,_,Res,OuterDone,OuterRes,Span,WF) :-
373 my_avl_domain(Res,List),
374 !,
375 debug_println(19,storing_expansion_of_memoized_function(MemoID)),
376 (maplist(store_function_result(MemoID,Span,WF),List)
377 -> assertz(memoization_expansion_completed(MemoID))
378 ; add_internal_error(memoization,'Error storing expansion for memoized function:',MemoID,Span)),
379 equal_object_wf(Res,OuterRes,WF), OuterDone=true.
380 store_memoization_closure_expansion(MemoID,_,R,OuterDone,OuterRes,Span,WF) :-
381 add_warning_wf(memoization,'Cannot store expansion for memoized function:',MemoID:R,Span,WF),
382 equal_object_wf(R,OuterRes,WF), OuterDone=true.
383
384 my_avl_domain(avl_set(A),List) :- avl_domain(A,List).
385 my_avl_domain([],[]).
386
387 store_function_result(MemoID,Span,WF,(X,ComputedResult)) :-
388 compute_funcall_memo_hash(X,MemoID,ArgHash),
389 store_memo_result(MemoID,X,ArgHash,ComputedResult,Span,WF). % TO DO: we could use special version that also allows relations
390
391 :- use_module(kernel_objects,[equal_object_optimized_wf/4]).
392 % succeeds if function has been completely memoized and returns expansion
393 try_get_complete_memoization_expansion(MemoID,Result,WF) :-
394 memoization_expansion_completed(MemoID),
395 debug_println(19,recovering_full_value_for_memoized_function(MemoID)),
396 findall((X,Y),stored_memo_result_id(MemoID,_,X,Y),List), % probably not sorted !
397 equal_object_optimized_wf(List,Result,expand_normal_closure_memo,WF).
398
399 % always succeeds to obtain the full expansion; also stores it for reuse
400 :- block get_complete_memoization_expansion(-,?,?,?,?,?).
401 get_complete_memoization_expansion(MemoID,Result,Done,_,_PP,WF) :-
402 try_get_complete_memoization_expansion(MemoID,Cached,WF),
403 !,
404 Result=Cached, Done=true.
405 get_complete_memoization_expansion(MemoID,Result,Done,Span,PP,WF) :-
406 registered_value(MemoID,Name,Val), nonvar(Val),
407 !,
408 get_complete_memoization_expansion_aux(Val,MemoID,Name,Result,Done,Span,PP,WF).
409 get_complete_memoization_expansion(MemoID,_,_,Span,PP,WF) :-
410 add_error_wf(get_complete_memoization_expansion,'Memoized function ID not registered:',MemoID:PP,Span,WF),
411 fail.
412
413
414 get_complete_memoization_expansion_aux(Val,_MemoID,_,Result,Done,_Span,_PP,_WF) :- expanded_value(Val), !,
415 Result=Val,Done=true.
416 get_complete_memoization_expansion_aux(closure(P,T,B),MemoID,Name,Result,Done,Span,PP,WF) :- !,
417 debug_println(19,expanding_memoized_function(MemoID,PP)),
418 (custom_explicit_sets:is_infinite_or_very_large_closure(P,T,B,200000)
419 -> add_warning_wf(PP,'Expanding infinite or very large memoized function: ',Name,B,WF)
420 ? ; is_symbolic_closure(P,T,B)
421 -> add_message_wf(PP,'Fully expanding symbolic memoized function: ',Name,B,WF)
422 ; true),
423 % bsyntaxtree:check_used_ids_in_ast(B),
424 custom_explicit_sets:expand_normal_closure_direct(P,T,B,Expansion,DoneExp,WF),
425 store_memoization_closure_expansion(MemoID,DoneExp,Expansion,Done,Result,Span,WF).
426 get_complete_memoization_expansion_aux(Val,MemoID,Name,_,_,Span,PP,WF) :-
427 add_error_wf(memoization(PP),'Illegal value stored for memoized function:',MemoID:Name,Span,WF),
428 print(Val),nl,
429 fail.
430
431 expanded_value(avl_set(_)).
432 expanded_value(global_set(_)).
433 expanded_value([]).
434 expanded_value([_|_]).
435
436 :- use_module(kernel_tools,[ground_value/1]).
437 :- use_module(kernel_objects,[check_element_of_wf/3]).
438 % special treatment for element of memoization closure; possibly not a function call
439 element_of_memoization_closure(MemoID,Element,WF,P,T,B) :-
440 nonvar(Element), Element = (X,Y),
441 % we can do a function application; we assume that we only store functions
442 ground_value_check(X,GrX),
443 !, %print(fun_apply_reuse(MemoID,Element)),nl,
444 Span=B,
445 % do_not_raise_wd: do not raise outside of domain errors
446 block_apply_closure_memo_groundx(GrX,MemoID, X,Y, P,T,B, do_not_raise_wd, Span,WF).
447 element_of_memoization_closure(MemoID,Element,WF,_,_,B) :-
448 % TO DO: delay before computing complete memoization
449 get_complete_memoization_expansion(MemoID,Set,_Done,B,element_of_memoization_closure,WF),
450 !, %print(el_of(MemoID,Element)),nl,
451 check_element_of_wf(Element,Set,WF).
452
453 :- use_module(kernel_objects,[not_equal_object_wf/3]).
454 :- use_module(kernel_objects,[not_element_of_wf/3]).
455
456 not_element_of_memoization_closure(MemoID,Element,WF,P,T,B) :-
457 nonvar(Element), Element = (X,Y),
458 % we can do a function application; we assume that we only store functions
459 ground_value_check(X,GrX),
460 !,
461 block_not_apply_closure_memo_groundx(GrX,MemoID, X,Y, P,T,B, do_not_raise_wd, B,WF).
462 not_element_of_memoization_closure(MemoID,Element,WF,_,_,B) :-
463 % TO DO: delay before computing complete memoization
464 get_complete_memoization_expansion(MemoID,Set,_Done,B,not_element_of_memoization_closure,WF),
465 !,
466 not_element_of_wf(Element,Set,WF).
467
468
469 :- block block_not_apply_closure_memo_groundx(-,?, ?,?, ?,?,?, ?,?,?).
470
471 block_not_apply_closure_memo_groundx(GrX,MemoID, X,Y, P,T,B, RaiseWD, Span,WF) :-
472 if(block_apply_closure_memo_groundx(GrX,MemoID, X,YRes, P,T,B, RaiseWD, Span,WF),
473 not_equal_object_wf(Y,YRes,wf),
474 true).
475
476 % -------------------------------
477
478 :- dynamic function_application_time/2.
479 :- use_module(preferences,[preference/2,get_preference/2]).
480 :- load_files(library(system), [when(compile_time), imports([environ/2])]).
481 :- if(\+ environ(prob_profile,false)).
482 %:- print('Profiling Memoizations'),nl.
483 count_reuse(MemoID) :-
484 my_bb_get_reuse_counter(MemoID,Cnt), C1 is Cnt+1, bb_put(MemoID,C1),
485 inc_counter(memoization_function_reuse_counter,_).
486 my_bb_get_reuse_counter(Key,Val) :- (bb_get(Key,V) -> V=Val ; Val=0).
487 bb_reset_reuse_counter(Key) :- bb_put(Key,0).
488 start_profile_function_application(_,Walltime) :- preference(prob_profiling_on,false),!, Walltime=0.
489 start_profile_function_application(_,Walltime) :- statistics(walltime,[Walltime,_]).
490 :- use_module(probsrc(performance_messages),[perf_format_wf/3]).
491 stop_profile_function_application(_,_,_,_) :- preference(prob_profiling_on,false),!.
492 stop_profile_function_application(MemoID,X,Walltime1,WF) :- statistics(walltime,[Walltime2,_]),
493 Delta is Walltime2-Walltime1,
494 (Delta>0 ->
495 (Delta > 1000
496 -> perf_format_wf('Long /* @memo ~w */ function application : ~w ms : arg: ~w~n',[MemoID,Delta,X],WF) ; true),
497 (retract(function_application_time(MemoID,Old))
498 -> New is Old+Delta ; New = Delta),
499 assertz(function_application_time(MemoID,New))
500 ; true
501 ).
502 function_application_time_available :- get_preference(prob_profiling_on,true).
503 :- else.
504 count_reuse(_MemoID) :-
505 inc_counter(memoization_function_reuse_counter,_).
506 my_bb_get_reuse_counter(_,'?').
507 bb_reset_reuse_counter(_).
508 start_profile_function_application(_,0).
509 stop_profile_function_application(_,_,_,_).
510 function_application_time_available :- fail.
511 :- endif.
512
513 % -------------------------------
514 % utilities to profile expansions
515 :- public inc/1.
516 :- dynamic hash_count/2.
517 inc(Hash) :- (retract(hash_count(Hash,Nr)) -> N1 is Nr+1 ; N1 = 1), assertz(hash_count(Hash,N1)).
518 :- dynamic hash_time/2.
519 store_memo_computation_time(Hash,Time) :- % for closure expansions, not for funct. applications
520 retractall(hash_time(Hash,_)), assertz(hash_time(Hash,Time)).
521
522 % reused and walltime info requires prob_profile flag
523 tcltk_get_memo_profile_table(list([Header|Entries])) :-
524 Header = list(['ID','Name','Fully','Stored Values','Reused','Walltime (ms)']),
525 findall(Entry,get_memo_entry_info(Entry),Entries).
526
527 get_memo_entry_info(list([MemoID,Name,Complete,NrStored,ReuseCnt,Walltime])) :-
528 registered_value(MemoID,Name,_FunValue),
529 (memoization_expansion_completed(MemoID) -> Complete='true' ; Complete = 'false'),
530 get_memo_profile_info(MemoID,NrStored,Walltime,ReuseCnt).
531
532 % get some profile info about a MemoID
533 get_memo_profile_info(MemoID,NrStored,Walltime,ReuseCnt) :-
534 my_bb_get_reuse_counter(MemoID,ReuseCnt),
535 findall(1,stored_memo_result_id(MemoID,_Hash,_,_),Stored), length(Stored,NrStored),
536 (\+ function_application_time_available -> Walltime='?'
537 ; function_application_time(MemoID,Walltime) -> true ; Walltime=0).
538
539
540 print_memo_profile :-
541 ((stored_memo_expansion(_,_,_) ; registered_value_packed(_,_,_))
542 -> print('MEMO Table:'),nl,
543 print_memo_table
544 ; true).
545
546 :- use_module(library(terms), [term_size/2]).
547 % memoization:print_memo.
548 print_memo_table :-
549 stored_memo_expansion(Hash,LookupTerm,PackedValue),
550 (hash_count(Hash,Count) -> print(Count), print(' : ') ; true),
551 (hash_time(Hash,Time) -> print(Time),print(' --> ') ; true),
552 print_memo_entry(LookupTerm),
553 nl, print(' : '),translate:print_bvalue(PackedValue),nl,fail.
554 print_memo_table :-
555 debug_mode(on),
556 registered_value(MemoID,Name,FunValue),
557 (memoization_expansion_completed(MemoID)
558 -> Compl=' (completely evaluated)' ; Compl=''),
559 format('MemoID ~w stored FUNCTION ~w~w ',[MemoID,Name,Compl]),
560 nl, print(' : '),translate:print_bvalue(FunValue),nl,fail.
561 print_memo_table :-
562 debug_mode(on),
563 registered_value_name(MemoID,Name),
564 stored_memo_result_id(MemoID,_Hash,LookupTerm,PackedValue),
565 term_size(LookupTerm,LSz),
566 format('MemoID ~w (~w) result for argument (size=~w) ',[MemoID,Name,LSz]),
567 print_memo_entry(LookupTerm),
568 term_size(PackedValue,PSz),
569 format('~n : (size=~w) ',[PSz]),translate:print_bvalue(PackedValue),nl,fail.
570 print_memo_table :-
571 stored_memo_result(Hash,MemoID1,T1,_),
572 stored_memo_result(Hash,MemoID2,T2,_),
573 dif((MemoID1,T1),(MemoID2,T2)),
574 format('Hash COLLISION ~w, ~w:~w vs ~w:~w~n',[Hash,MemoID1,T1,MemoID2,T2]),
575 fail.
576 print_memo_table :- format('Summary of reuse per memoization ID:~n',[]),
577 registered_value_name(MemoID,Name),
578 get_memo_profile_info(MemoID,NrStored,Walltime,ReuseCnt),
579 format('MemoID ~w (~w) : Values Stored: ~w (~w ms to compute), Reused ~w~n',[MemoID,Name,NrStored,Walltime,ReuseCnt]),
580 fail.
581 print_memo_table :- get_counter(memoization_hash_counter,Hash),
582 get_counter(memoization_reuse_counter,RHit),
583 format('Hashes computed: ~w, expansions reused: ~w~n',[Hash,RHit]),
584 get_counter(memoization_function_counter,F),
585 get_counter(memoization_function_reuse_counter,FR),
586 format('Memoization functions registered: ~w, results reused: ~w~n',[F,FR]).
587
588 print_memo_entry(closure(Parameters,ParameterTypes,ClosureBody)) :- !,
589 translate:print_bvalue(closure(Parameters,ParameterTypes,ClosureBody)).
590 print_memo_entry(closure1_for_explicit_set(A)) :- !,
591 print('closure1('),translate:print_bvalue(avl_set(A)), print(')').
592 print_memo_entry(A) :- translate:print_bvalue(A).
593
594 init_memo_table :-
595 counter_init,
596 new_counter(memoization_reuse_counter), new_counter(memoization_hash_counter),
597 new_counter(memoization_function_counter), new_counter(memoization_function_reuse_counter),
598 reset_memo_table.
599
600 reset_memo_table :-
601 ? retract(registered_value_packed(MemoID,_,_)),
602 bb_reset_reuse_counter(MemoID),
603 retract(registered_value_name(MemoID,_)),
604 fail.
605 reset_memo_table :-
606 reset_counter(memoization_reuse_counter),
607 reset_counter(memoization_hash_counter),
608 reset_counter(memoization_function_counter),
609 reset_counter(memoization_function_reuse_counter),
610 ? (stored_memo_expansion(_,_,_) -> debug_println(19,'Resetting MEMO table') ; true),
611 retractall(hash_count(_,_)),
612 retractall(hash_time(_,_)),
613 retractall(stored_memo_expansion(_,_,_)),
614 retractall(registered_value_packed(_,_,_)),
615 retractall(registered_value_name(_,_)),
616 retractall(function_application_time(_,_)),
617 retractall(memoization_expansion_completed(_)),
618 retractall(stored_lambda_value_domain(_,_,_)),
619 retractall_stored_memo_result,
620 reset_cogen.
621
622 :- use_module(probsrc(tools),[retract_with_statistics/2]).
623 reset_memo_with_statistics :-
624 ? retract_with_statistics(memoization,
625 [stored_memo_expansion(_,_,_),
626 registered_value_packed(_,_,_),registered_value_name(_,_),
627 memoization_expansion_completed(_),
628 stored_lambda_value_domain(_,_,_),
629 stored_memo_result1(_,_,_), stored_memo_result2(_,_,_),
630 stored_memo_result3(_,_,_), stored_memo_result4(_,_,_),
631 stored_memo_result5(_,_,_), stored_memo_result6(_,_,_),
632 stored_memo_result7(_,_,_), stored_memo_result8(_,_,_),
633 stored_memo_result(_,_,_,_)]),
634 reset_memo_table.
635
636 % export the currently registered functions into a list of terms, which can be re-imported later
637 export_memo_state(memo_export(1,List,[use_state_packing/SP])) :-
638 get_preference(use_state_packing,SP),
639 findall(registered_value_packed(InnerMemoID,Name,PValue),
640 (registered_value_packed(InnerMemoID,Name,PValue),
641 formatsilent('value caching: exporting memoized function ~w : ~w~n',[InnerMemoID,Name])), List).
642
643 % import registered functions from a list of terms
644 import_memo_state(memo_export(_,[],_)) :- !. % nothing to import
645 import_memo_state(memo_export(_,_,_)) :-
646 findall(Name,registered_value_name(_,Name),Ls),
647 Ls \= [],
648 add_warning(memoization,'Memo table not empty for import: ',Ls),
649 reset_memo_table,
650 fail.
651 import_memo_state(memo_export(1,List,Par)) :-
652 get_preference(use_state_packing,SP),
653 member(use_state_packing/SP,Par),!,
654 import_memo_values(List,0).
655 import_memo_state(memo_export(Vers,_,Paras)) :- !,
656 add_error(memoization,'Version or COMPRESSION setting has changed from: ',Vers:Paras).
657 import_memo_state(Term) :-
658 add_error(memoization,'Illegal memo export term: ',Term).
659
660 import_memo_values([],Nr) :-
661 set_counter(memoization_function_counter,Nr).
662 import_memo_values([registered_value_packed(InnerMemoID,Name,PValue) | T],Count) :-
663 assertz(registered_value_name(InnerMemoID,Name)),
664 assertz(registered_value_packed(InnerMemoID,Name,PValue)),
665 formatsilent('value caching: imported memoized function ~w : ~w~n',[InnerMemoID,Name]),
666 C1 is Count+1,
667 import_memo_values(T,C1).
668