cleanup
[charm.git] / src / ck-ldb / LBDatabase.C
1 /**
2  * \addtogroup CkLdb
3 */
4 /*@{*/
5
6 #include "converse.h"
7
8 /*
9  * This C++ file contains the Charm stub functions
10  */
11
12 #include "LBDatabase.h"
13 #include "LBSimulation.h"
14 #include "topology.h"
15
16 #include "limits.h"
17
18 #include "NullLB.h"
19
20 #define VEC_SIZE 50
21 #define IMB_TOLERANCE 1.1
22 #define OUTOFWAY_TOLERANCE 2
23 #define UTILIZATION_THRESHOLD 0.7
24 #define NEGLECT_IDLE 2 // Should never be == 1
25 #define MIN_STATS 6
26
27 #   define DEBAD(x) /*CkPrintf x*/
28 #   define EXTRA_FEATURE 0
29
30 CkGroupID _lbdb;
31
32 CkpvDeclare(int, numLoadBalancers);  /**< num of lb created */
33 CkpvDeclare(int, hasNullLB);         /**< true if NullLB is created */
34 CkpvDeclare(int, lbdatabaseInited);  /**< true if lbdatabase is inited */
35
36 // command line options
37 CkLBArgs _lb_args;
38 int _lb_predict=0;
39 int _lb_predict_delay=10;
40 int _lb_predict_window=20;
41
42 // registry class stores all load balancers linked and created at runtime
43 class LBDBRegistry {
44 friend class LBDBInit;
45 friend class LBDatabase;
46 private:
47   // table for all available LBs linked in
48   struct LBDBEntry {
49     const char *name;
50     LBCreateFn  cfn;
51     LBAllocFn   afn;
52     const char *help;
53     int         shown;          // if 0, donot show in help page
54     LBDBEntry(): name(0), cfn(0), afn(0), help(0), shown(1) {}
55     LBDBEntry(int) {}
56     LBDBEntry(const char *n, LBCreateFn cf, LBAllocFn af,
57               const char *h, int show=1):
58       name(n), cfn(cf), afn(af), help(h), shown(show) {};
59   };
60   CkVec<LBDBEntry> lbtables;            // a list of available LBs linked
61   CkVec<const char *>   compile_lbs;    // load balancers at compile time
62   CkVec<const char *>   runtime_lbs;    // load balancers at run time
63 public:
64   LBDBRegistry() {}
65   void displayLBs()
66   {
67     CmiPrintf("\nAvailable load balancers:\n");
68     for (int i=0; i<lbtables.length(); i++) {
69       LBDBEntry &entry = lbtables[i];
70       if (entry.shown) CmiPrintf("* %s: %s\n", entry.name, entry.help);
71     }
72     CmiPrintf("\n");
73   }
74   void addEntry(const char *name, LBCreateFn fn, LBAllocFn afn, const char *help, int shown) {
75     lbtables.push_back(LBDBEntry(name, fn, afn, help, shown));
76   }
77   void addCompiletimeBalancer(const char *name) {
78     compile_lbs.push_back(name);
79   }
80   void addRuntimeBalancer(const char *name) {
81     runtime_lbs.push_back(name);
82   }
83   LBCreateFn search(const char *name) {
84     char *ptr = strpbrk((char *)name, ":,");
85     int slen = ptr!=NULL?ptr-name:strlen(name);
86     for (int i=0; i<lbtables.length(); i++)
87       if (0==strncmp(name, lbtables[i].name, slen)) return lbtables[i].cfn;
88     return NULL;
89   }
90   LBAllocFn getLBAllocFn(const char *name) {
91     char *ptr = strpbrk((char *)name, ":,");
92     int slen = ptr-name;
93     for (int i=0; i<lbtables.length(); i++)
94       if (0==strncmp(name, lbtables[i].name, slen)) return lbtables[i].afn;
95     return NULL;
96   }
97 };
98
99 static LBDBRegistry lbRegistry;
100
101 void LBDefaultCreate(const char *lbname)
102 {
103   lbRegistry.addCompiletimeBalancer(lbname);
104 }
105
106 // default is to show the helper
107 void LBRegisterBalancer(const char *name, LBCreateFn fn, LBAllocFn afn, const char *help, int shown)
108 {
109   lbRegistry.addEntry(name, fn, afn, help, shown);
110 }
111
112 LBAllocFn getLBAllocFn(char *lbname) {
113     return lbRegistry.getLBAllocFn(lbname);
114 }
115
116 LBCreateFn getLBCreateFn(const char *lbname) {
117     return lbRegistry.search(lbname);
118 }
119 // create a load balancer group using the strategy name
120 static void createLoadBalancer(const char *lbname)
121 {
122     LBCreateFn fn = lbRegistry.search(lbname);
123     if (!fn) {    // invalid lb name
124       CmiPrintf("Abort: Unknown load balancer: '%s'!\n", lbname);
125       lbRegistry.displayLBs();    // display help page
126       CkAbort("Abort");
127     }
128     // invoke function to create load balancer
129     fn();
130 }
131
132 // mainchare
133 LBDBInit::LBDBInit(CkArgMsg *m)
134 {
135 #if CMK_LBDB_ON
136   _lbdb = CProxy_LBDatabase::ckNew();
137
138   // runtime specified load balancer
139   if (lbRegistry.runtime_lbs.size() > 0) {
140     for (int i=0; i<lbRegistry.runtime_lbs.size(); i++) {
141       const char *balancer = lbRegistry.runtime_lbs[i];
142       createLoadBalancer(balancer);
143     }
144   }
145   else if (lbRegistry.compile_lbs.size() > 0) {
146     for (int i=0; i<lbRegistry.compile_lbs.size(); i++) {
147       const char* balancer = lbRegistry.compile_lbs[i];
148       createLoadBalancer(balancer);
149     }
150   }
151   else {
152     // NullLB is the default when none of above lb created
153     // note user may create his own load balancer in his code manually like
154     // in NAMD, but never mind NullLB can disable itself if there is
155     // a non NULL LB.
156     createLoadBalancer("NullLB");
157   }
158
159   // simulation mode
160   if (LBSimulation::doSimulation) {
161     CmiPrintf("Charm++> Entering Load Balancer Simulation Mode ... \n");
162     CProxy_LBDatabase(_lbdb).ckLocalBranch()->StartLB();
163   }
164 #endif
165   delete m;
166 }
167
168 // called from init.C
169 void _loadbalancerInit()
170 {
171   CkPrintf("loadbalancerInit\n");
172   CkpvInitialize(int, lbdatabaseInited);
173   CkpvAccess(lbdatabaseInited) = 0;
174   CkpvInitialize(int, numLoadBalancers);
175   CkpvAccess(numLoadBalancers) = 0;
176   CkpvInitialize(int, hasNullLB);
177   CkpvAccess(hasNullLB) = 0;
178
179   char **argv = CkGetArgv();
180   char *balancer = NULL;
181   CmiArgGroup("Charm++","Load Balancer");
182   while (CmiGetArgStringDesc(argv, "+balancer", &balancer, "Use this load balancer")) {
183     if (CkMyRank() == 0)
184       lbRegistry.addRuntimeBalancer(balancer);   /* lbRegistry is a static */
185   }
186
187   // set up init value for LBPeriod time in seconds
188   // it can also be set by calling LDSetLBPeriod()
189   CmiGetArgDoubleDesc(argv,"+LBPeriod", &_lb_args.lbperiod(),"the minimum time period in seconds allowed for two consecutive automatic load balancing");
190   _lb_args.loop() = CmiGetArgFlagDesc(argv, "+LBLoop", "Use multiple load balancing strategies in loop");
191
192   // now called in cldb.c: CldModuleGeneralInit()
193   // registerLBTopos();
194   CmiGetArgStringDesc(argv, "+LBTopo", &_lbtopo, "define load balancing topology");
195   //Read the K parameter for RefineKLB
196   CmiGetArgIntDesc(argv, "+LBNumMoves", &_lb_args.percentMovesAllowed() , "Percentage of chares to be moved (used by RefineKLB) [0-100]");
197
198   /**************** FUTURE PREDICTOR ****************/
199   _lb_predict = CmiGetArgFlagDesc(argv, "+LBPredictor", "Turn on LB future predictor");
200   CmiGetArgIntDesc(argv, "+LBPredictorDelay", &_lb_predict_delay, "Number of balance steps before learning a model");
201   CmiGetArgIntDesc(argv, "+LBPredictorWindow", &_lb_predict_window, "Number of steps to use to learn a model");
202   if (_lb_predict_window < _lb_predict_delay) {
203     CmiPrintf("LB> [%d] Argument LBPredictorWindow (%d) less than LBPredictorDelay (%d) , fixing\n", CkMyPe(), _lb_predict_window, _lb_predict_delay);
204     _lb_predict_delay = _lb_predict_window;
205   }
206
207   /******************* SIMULATION *******************/
208   // get the step number at which to dump the LB database
209   CmiGetArgIntDesc(argv, "+LBVersion", &_lb_args.lbversion(), "LB database file version number");
210   CmiGetArgIntDesc(argv, "+LBCentPE", &_lb_args.central_pe(), "CentralLB processor");
211   int _lb_dump_activated = 0;
212   if (CmiGetArgIntDesc(argv, "+LBDump", &LBSimulation::dumpStep, "Dump the LB state from this step"))
213     _lb_dump_activated = 1;
214   if (_lb_dump_activated && LBSimulation::dumpStep < 0) {
215     CmiPrintf("LB> Argument LBDump (%d) negative, setting to 0\n",LBSimulation::dumpStep);
216     LBSimulation::dumpStep = 0;
217   }
218   CmiGetArgIntDesc(argv, "+LBDumpSteps", &LBSimulation::dumpStepSize, "Dump the LB state for this amount of steps");
219   if (LBSimulation::dumpStepSize <= 0) {
220     CmiPrintf("LB> Argument LBDumpSteps (%d) too small, setting to 1\n",LBSimulation::dumpStepSize);
221     LBSimulation::dumpStepSize = 1;
222   }
223   CmiGetArgStringDesc(argv, "+LBDumpFile", &LBSimulation::dumpFile, "Set the LB state file name");
224   // get the simulation flag and number. Now the flag can also be avoided by the presence of the number
225   LBSimulation::doSimulation = CmiGetArgIntDesc(argv, "+LBSim", &LBSimulation::simStep, "Read LB state from LBDumpFile since this step");
226   // check for stupid LBSim parameter
227   if (LBSimulation::doSimulation && LBSimulation::simStep < 0) {
228     CmiPrintf("LB> Argument LBSim (%d) invalid, should be >= 0\n");
229     CkExit();
230     return;
231   }
232   CmiGetArgIntDesc(argv, "+LBSimSteps", &LBSimulation::simStepSize, "Read LB state for this number of steps");
233   if (LBSimulation::simStepSize <= 0) {
234     CmiPrintf("LB> Argument LBSimSteps (%d) too small, setting to 1\n",LBSimulation::simStepSize);
235     LBSimulation::simStepSize = 1;
236   }
237
238
239   LBSimulation::simProcs = 0;
240   CmiGetArgIntDesc(argv, "+LBSimProcs", &LBSimulation::simProcs, "Number of target processors.");
241
242   LBSimulation::showDecisionsOnly =
243     CmiGetArgFlagDesc(argv, "+LBShowDecisions",
244                       "Write to File: Load Balancing Object to Processor Map decisions during LB Simulation");
245
246   // force a global barrier after migration done
247   _lb_args.syncResume() = CmiGetArgFlagDesc(argv, "+LBSyncResume",
248                   "LB performs a barrier after migration is finished");
249
250   // both +LBDebug and +LBDebug level should work
251   if (!CmiGetArgIntDesc(argv, "+LBDebug", &_lb_args.debug(),
252                                           "Turn on LB debugging printouts"))
253     _lb_args.debug() = CmiGetArgFlagDesc(argv, "+LBDebug",
254                                              "Turn on LB debugging printouts");
255
256   // getting the size of the team with +teamSize
257   if (!CmiGetArgIntDesc(argv, "+teamSize", &_lb_args.teamSize(),
258                                           "Team size"))
259     _lb_args.teamSize() = 1;
260
261   // ask to print summary/quality of load balancer
262   _lb_args.printSummary() = CmiGetArgFlagDesc(argv, "+LBPrintSummary",
263                 "Print load balancing result summary");
264
265   // to ignore baclground load
266   _lb_args.ignoreBgLoad() = CmiGetArgFlagDesc(argv, "+LBNoBackground",
267                       "Load balancer ignores the background load.");
268 #ifdef __BIGSIM__
269   _lb_args.ignoreBgLoad() = 1;
270 #endif
271   _lb_args.migObjOnly() = CmiGetArgFlagDesc(argv, "+LBObjOnly",
272                       "Only load balancing migratable objects, ignoring all others.");
273   if (_lb_args.migObjOnly()) _lb_args.ignoreBgLoad() = 1;
274
275   // assume all CPUs are identical
276   _lb_args.testPeSpeed() = CmiGetArgFlagDesc(argv, "+LBTestPESpeed",
277                       "Load balancer test all CPUs speed.");
278   _lb_args.samePeSpeed() = CmiGetArgFlagDesc(argv, "+LBSameCpus",
279                       "Load balancer assumes all CPUs are of same speed.");
280   if (!_lb_args.testPeSpeed()) _lb_args.samePeSpeed() = 1;
281
282   _lb_args.useCpuTime() = CmiGetArgFlagDesc(argv, "+LBUseCpuTime",
283                       "Load balancer uses CPU time instead of wallclock time.");
284
285   // turn instrumentation off at startup
286   _lb_args.statsOn() = !CmiGetArgFlagDesc(argv, "+LBOff",
287                         "Turn load balancer instrumentation off");
288
289   // turn instrumentation of communicatin off at startup
290   _lb_args.traceComm() = !CmiGetArgFlagDesc(argv, "+LBCommOff",
291                 "Turn load balancer instrumentation of communication off");
292
293   // set alpha and beeta
294   _lb_args.alpha() = PER_MESSAGE_SEND_OVERHEAD_DEFAULT;
295   _lb_args.beeta() = PER_BYTE_SEND_OVERHEAD_DEFAULT;
296   CmiGetArgDoubleDesc(argv,"+LBAlpha", &_lb_args.alpha(),
297                            "per message send overhead");
298   CmiGetArgDoubleDesc(argv,"+LBBeta", &_lb_args.beeta(),
299                            "per byte send overhead");
300
301   if (CkMyPe() == 0) {
302     if (_lb_args.debug()) {
303       CmiPrintf("CharmLB> Verbose level %d, load balancing period: %g seconds\n", _lb_args.debug(), _lb_args.lbperiod());
304     }
305     if (_lb_args.debug() > 1) {
306       CmiPrintf("CharmLB> Topology %s alpha: %es beta: %es.\n", _lbtopo, _lb_args.alpha(), _lb_args.beeta());
307     }
308     if (_lb_args.printSummary())
309       CmiPrintf("CharmLB> Load balancer print summary of load balancing result.\n");
310     if (_lb_args.ignoreBgLoad())
311       CmiPrintf("CharmLB> Load balancer ignores processor background load.\n");
312     if (_lb_args.samePeSpeed())
313       CmiPrintf("CharmLB> Load balancer assumes all CPUs are same.\n");
314     if (_lb_args.useCpuTime())
315       CmiPrintf("CharmLB> Load balancer uses CPU time instead of wallclock time.\n");
316     if (LBSimulation::doSimulation)
317       CmiPrintf("CharmLB> Load balancer running in simulation mode on file '%s' version %d.\n", LBSimulation::dumpFile, _lb_args.lbversion());
318     if (_lb_args.statsOn()==0)
319       CkPrintf("CharmLB> Load balancing instrumentation is off.\n");
320     if (_lb_args.traceComm()==0)
321       CkPrintf("CharmLB> Load balancing instrumentation for communication is off.\n");
322     if (_lb_args.migObjOnly())
323       CkPrintf("LB> Load balancing strategy ignores non-migratable objects.\n");
324   }
325 }
326
327 int LBDatabase::manualOn = 0;
328 char *LBDatabase::avail_vector = NULL;
329 CmiNodeLock avail_vector_lock;
330
331 static LBRealType * _expectedLoad = NULL;
332
333 void LBDatabase::initnodeFn()
334 {
335   int proc;
336   int num_proc = CkNumPes();
337   avail_vector= new char[num_proc];
338   for(proc = 0; proc < num_proc; proc++)
339       avail_vector[proc] = 1;
340   avail_vector_lock = CmiCreateLock();
341
342   _expectedLoad = new LBRealType[num_proc];
343   for (proc=0; proc<num_proc; proc++) _expectedLoad[proc]=0.0;
344
345   //CkPrintf("Total objs in %d is %d\n", CkMyPe(), getLBDB()->ObjDataCount());
346 }
347
348 // called my constructor
349 void LBDatabase::init(void)
350 {
351   //thisProxy = CProxy_LBDatabase(thisgroup);
352   myLDHandle = LDCreate();
353   mystep = 0;
354   nloadbalancers = 0;
355   new_ld_balancer = 0;
356   metabalancer = (MetaBalancer *)CkLocalBranch(_metalb);
357
358   CkpvAccess(lbdatabaseInited) = 1;
359 #if CMK_LBDB_ON
360   if (manualOn) TurnManualLBOn();
361 #endif
362
363 }
364
365 LBDatabase::LastLBInfo::LastLBInfo()
366 {
367   expectedLoad = _expectedLoad;
368 }
369
370 void LBDatabase::get_avail_vector(char * bitmap) {
371     CmiAssert(bitmap && avail_vector);
372     const int num_proc = CkNumPes();
373     for(int proc = 0; proc < num_proc; proc++){
374       bitmap[proc] = avail_vector[proc];
375     }
376 }
377
378 // new_ld == -1(default) : calcualte a new ld
379 //           -2 : ignore new ld
380 //           >=0: given a new ld
381 void LBDatabase::set_avail_vector(char * bitmap, int new_ld){
382     int assigned = 0;
383     const int num_proc = CkNumPes();
384     if (new_ld == -2) assigned = 1;
385     else if (new_ld >= 0) {
386       CmiAssert(new_ld < num_proc);
387       new_ld_balancer = new_ld;
388       assigned = 1;
389     }
390     CmiAssert(bitmap && avail_vector);
391     for(int count = 0; count < num_proc; count++){
392         avail_vector[count] = bitmap[count];
393         if((bitmap[count] == 1) && !assigned){
394             new_ld_balancer = count;
395             assigned = 1;
396         }
397     }
398 }
399
400 // called in CreateFooLB() when multiple load balancers are created
401 // on PE0, BaseLB of each load balancer applies a ticket number
402 // and broadcast the ticket number to all processors
403 int LBDatabase::getLoadbalancerTicket()  {
404   int seq = nloadbalancers;
405   nloadbalancers ++;
406   loadbalancers.resize(nloadbalancers);
407   loadbalancers[seq] = NULL;
408   return seq;
409 }
410
411 void LBDatabase::addLoadbalancer(BaseLB *lb, int seq) {
412 //  CmiPrintf("[%d] addLoadbalancer for seq %d\n", CkMyPe(), seq);
413   if (seq == -1) return;
414   if (CkMyPe() == 0) {
415     CmiAssert(seq < nloadbalancers);
416     if (loadbalancers[seq]) {
417       CmiPrintf("Duplicate load balancer created at %d\n", seq);
418       CmiAbort("LBDatabase");
419     }
420   }
421   else
422     nloadbalancers ++;
423   loadbalancers.resize(seq+1);
424   loadbalancers[seq] = lb;
425 }
426
427 // switch strategy in order
428 void LBDatabase::nextLoadbalancer(int seq) {
429   if (seq == -1) return;                // -1 means this is the only LB
430   int next = seq+1;
431   if (_lb_args.loop()) {
432     if (next == nloadbalancers) next = 0;
433   }
434   else {
435     if (next == nloadbalancers) next --;  // keep using the last one
436   }
437   if (seq != next) {
438     loadbalancers[seq]->turnOff();
439     CmiAssert(loadbalancers[next]);
440     loadbalancers[next]->turnOn();
441   }
442 }
443
444 // return the seq-th load balancer string name of
445 // it can be specified in either compile time or runtime
446 // runtime has higher priority
447 const char *LBDatabase::loadbalancer(int seq) {
448   if (lbRegistry.runtime_lbs.length()) {
449     CmiAssert(seq < lbRegistry.runtime_lbs.length());
450     return lbRegistry.runtime_lbs[seq];
451   }
452   else {
453     CmiAssert(seq < lbRegistry.compile_lbs.length());
454     return lbRegistry.compile_lbs[seq];
455   }
456 }
457
458 void LBDatabase::pup(PUP::er& p)
459 {
460   // NOTE if unpacking set metabalancer using the id
461         IrrGroup::pup(p);
462         // the memory should be already allocated
463         int np;
464         if (!p.isUnpacking()) np = CkNumPes();
465         p|np;
466         CmiAssert(avail_vector);
467         // in case number of processors changes
468         if (p.isUnpacking() && np > CkNumPes()) {
469                 CmiLock(avail_vector_lock);
470                 delete [] avail_vector;
471                 avail_vector = new char[np];
472                 for (int i=0; i<np; i++) avail_vector[i] = 1;
473                 CmiUnlock(avail_vector_lock);
474         }
475         p(avail_vector, np);
476         p|mystep;
477         if(p.isUnpacking()) {
478     nloadbalancers = 0;
479     metabalancer = (MetaBalancer*)CkLocalBranch(_metalb);
480   }
481 }
482
483
484 void LBDatabase::EstObjLoad(const LDObjHandle &_h, double cputime)
485 {
486 #if CMK_LBDB_ON
487   LBDB *const db = (LBDB*)(_h.omhandle.ldb.handle);
488   LBObj *const obj = db->LbObj(_h);
489
490   CmiAssert(obj != NULL);
491   obj->setTiming(cputime);
492 #endif
493 }
494
495 void LBDatabase::ResumeClients() {
496 #if CMK_LBDB_ON
497   if (metabalancer == NULL) {
498     metabalancer = CProxy_MetaBalancer(_metalb).ckLocalBranch();
499   }
500   if (metabalancer != NULL) {
501     metabalancer->ResumeClients();
502   }
503 #endif
504   LDResumeClients(myLDHandle);
505 }
506
507 void LBDatabase::SetMigrationCost(double cost) {
508   if (metabalancer == NULL) {
509     metabalancer = (MetaBalancer *)CkLocalBranch(_metalb);
510   }
511   if (metabalancer != NULL)  {
512     metabalancer->SetMigrationCost(cost);
513   }
514 }
515
516 void LBDatabase::SetStrategyCost(double cost) {
517   if (metabalancer == NULL) {
518     metabalancer = (MetaBalancer *)CkLocalBranch(_metalb);
519   }
520   if (metabalancer != NULL)  {
521     metabalancer->SetStrategyCost(cost);
522   }
523 }
524
525 /*
526   callable from user's code
527 */
528 void TurnManualLBOn()
529 {
530 #if CMK_LBDB_ON
531    LBDatabase * myLbdb = LBDatabase::Object();
532    if (myLbdb) {
533      myLbdb->TurnManualLBOn();
534    }
535    else {
536      LBDatabase::manualOn = 1;
537    }
538 #endif
539 }
540
541 void TurnManualLBOff()
542 {
543 #if CMK_LBDB_ON
544    LBDatabase * myLbdb = LBDatabase::Object();
545    if (myLbdb) {
546      myLbdb->TurnManualLBOff();
547    }
548    else {
549      LBDatabase::manualOn = 0;
550    }
551 #endif
552 }
553
554 extern "C" void LBTurnInstrumentOn() {
555 #if CMK_LBDB_ON
556   if (CkpvAccess(lbdatabaseInited))
557     LBDatabase::Object()->CollectStatsOn();
558   else
559     _lb_args.statsOn() = 1;
560 #endif
561 }
562
563 extern "C" void LBTurnInstrumentOff() {
564 #if CMK_LBDB_ON
565   if (CkpvAccess(lbdatabaseInited))
566     LBDatabase::Object()->CollectStatsOff();
567   else
568     _lb_args.statsOn() = 0;
569 #endif
570 }
571 void LBClearLoads() {
572 #if CMK_LBDB_ON
573   LBDatabase::Object()->ClearLoads();
574 #endif
575 }
576
577 void LBTurnPredictorOn(LBPredictorFunction *model) {
578 #if CMK_LBDB_ON
579   LBDatabase::Object()->PredictorOn(model);
580 #endif
581 }
582
583 void LBTurnPredictorOn(LBPredictorFunction *model, int wind) {
584 #if CMK_LBDB_ON
585   LBDatabase::Object()->PredictorOn(model, wind);
586 #endif
587 }
588
589 void LBTurnPredictorOff() {
590 #if CMK_LBDB_ON
591   LBDatabase::Object()->PredictorOff();
592 #endif
593 }
594
595 void LBChangePredictor(LBPredictorFunction *model) {
596 #if CMK_LBDB_ON
597   LBDatabase::Object()->ChangePredictor(model);
598 #endif
599 }
600
601 void LBSetPeriod(double second) {
602 #if CMK_LBDB_ON
603   if (CkpvAccess(lbdatabaseInited))
604     LBDatabase::Object()->SetLBPeriod(second);
605   else
606     _lb_args.lbperiod() = second;
607 #endif
608 }
609
610 #include "LBDatabase.def.h"
611
612 /*@}*/