xref: /petsc/src/ts/event/tsevent.c (revision fc8a9adeb7fcdc98711d755fa2dc544ddccf0f3e)
1 #include <petsc/private/tsimpl.h> /*I  "petscts.h" I*/
2 
3 /*
4   TSEventInitialize - Initializes TSEvent for TSSolve
5 */
6 PetscErrorCode TSEventInitialize(TSEvent event,TS ts,PetscReal t,Vec U)
7 {
8   PetscErrorCode ierr;
9 
10   PetscFunctionBegin;
11   if (!event) PetscFunctionReturn(0);
12   PetscValidPointer(event,1);
13   PetscValidHeaderSpecific(ts,TS_CLASSID,2);
14   PetscValidHeaderSpecific(U,VEC_CLASSID,4);
15   event->ptime_prev = t;
16   event->iterctr = 0;
17   ierr = (*event->eventhandler)(ts,t,U,event->fvalue_prev,event->ctx);CHKERRQ(ierr);
18   PetscFunctionReturn(0);
19 }
20 
21 PetscErrorCode TSEventDestroy(TSEvent *event)
22 {
23   PetscErrorCode ierr;
24   PetscInt       i;
25 
26   PetscFunctionBegin;
27   PetscValidPointer(event,1);
28   if (!*event) PetscFunctionReturn(0);
29   if (--(*event)->refct > 0) {*event = 0; PetscFunctionReturn(0);}
30 
31   ierr = PetscFree((*event)->fvalue);CHKERRQ(ierr);
32   ierr = PetscFree((*event)->fvalue_prev);CHKERRQ(ierr);
33   ierr = PetscFree((*event)->fvalue_right);CHKERRQ(ierr);
34   ierr = PetscFree((*event)->zerocrossing);CHKERRQ(ierr);
35   ierr = PetscFree((*event)->side);CHKERRQ(ierr);
36   ierr = PetscFree((*event)->direction);CHKERRQ(ierr);
37   ierr = PetscFree((*event)->terminate);CHKERRQ(ierr);
38   ierr = PetscFree((*event)->events_zero);CHKERRQ(ierr);
39   ierr = PetscFree((*event)->vtol);CHKERRQ(ierr);
40 
41   for (i=0; i < (*event)->recsize; i++) {
42     ierr = PetscFree((*event)->recorder.eventidx[i]);CHKERRQ(ierr);
43   }
44   ierr = PetscFree((*event)->recorder.eventidx);CHKERRQ(ierr);
45   ierr = PetscFree((*event)->recorder.nevents);CHKERRQ(ierr);
46   ierr = PetscFree((*event)->recorder.stepnum);CHKERRQ(ierr);
47   ierr = PetscFree((*event)->recorder.time);CHKERRQ(ierr);
48 
49   ierr = PetscViewerDestroy(&(*event)->monitor);CHKERRQ(ierr);
50   ierr = PetscFree(*event);CHKERRQ(ierr);
51   PetscFunctionReturn(0);
52 }
53 
54 /*@
55   TSSetPostEventIntervalStep - Set the time-step used immediately following the event interval
56 
57   Logically Collective
58 
59   Input Arguments:
60 + ts - time integration context
61 - dt - post event interval step
62 
63   Options Database Keys:
64 . -ts_event_post_eventinterval_step <dt> time-step after event interval
65 
66   Notes:
67   TSSetPostEventIntervalStep allows one to set a time-step that is used immediately following an event interval.
68 
69   This function should be called from the postevent function set with TSSetEventHandler().
70 
71   The post event interval time-step should be selected based on the dynamics following the event.
72   If the dynamics are stiff, a conservative (small) step should be used.
73   If not, then a larger time-step can be used.
74 
75   Level: Advanced
76   .seealso: TS, TSEvent, TSSetEventHandler()
77 @*/
78 PetscErrorCode TSSetPostEventIntervalStep(TS ts,PetscReal dt)
79 {
80   PetscFunctionBegin;
81   ts->event->timestep_posteventinterval = dt;
82   PetscFunctionReturn(0);
83 }
84 
85 /*@
86    TSSetEventTolerances - Set tolerances for event zero crossings when using event handler
87 
88    Logically Collective
89 
90    Input Arguments:
91 +  ts - time integration context
92 .  tol - scalar tolerance, PETSC_DECIDE to leave current value
93 -  vtol - array of tolerances or NULL, used in preference to tol if present
94 
95    Options Database Keys:
96 .  -ts_event_tol <tol> tolerance for event zero crossing
97 
98    Notes:
99    Must call TSSetEventHandler() before setting the tolerances.
100 
101    The size of vtol is equal to the number of events.
102 
103    Level: beginner
104 
105 .seealso: TS, TSEvent, TSSetEventHandler()
106 @*/
107 PetscErrorCode TSSetEventTolerances(TS ts,PetscReal tol,PetscReal vtol[])
108 {
109   TSEvent        event;
110   PetscInt       i;
111 
112   PetscFunctionBegin;
113   PetscValidHeaderSpecific(ts,TS_CLASSID,1);
114   if (vtol) PetscValidRealPointer(vtol,3);
115   if (!ts->event) SETERRQ(PetscObjectComm((PetscObject)ts),PETSC_ERR_USER,"Must set the events first by calling TSSetEventHandler()");
116 
117   event = ts->event;
118   if (vtol) {
119     for (i=0; i < event->nevents; i++) event->vtol[i] = vtol[i];
120   } else {
121     if (tol != PETSC_DECIDE || tol != PETSC_DEFAULT) {
122       for (i=0; i < event->nevents; i++) event->vtol[i] = tol;
123     }
124   }
125   PetscFunctionReturn(0);
126 }
127 
128 /*@C
129    TSSetEventHandler - Sets a function used for detecting events
130 
131    Logically Collective on TS
132 
133    Input Parameters:
134 +  ts - the TS context obtained from TSCreate()
135 .  nevents - number of local events
136 .  direction - direction of zero crossing to be detected. -1 => Zero crossing in negative direction,
137                +1 => Zero crossing in positive direction, 0 => both ways (one for each event)
138 .  terminate - flag to indicate whether time stepping should be terminated after
139                event is detected (one for each event)
140 .  eventhandler - event monitoring routine
141 .  postevent - [optional] post-event function
142 -  ctx       - [optional] user-defined context for private data for the
143                event monitor and post event routine (use NULL if no
144                context is desired)
145 
146    Calling sequence of eventhandler:
147    PetscErrorCode PetscEventHandler(TS ts,PetscReal t,Vec U,PetscScalar fvalue[],void* ctx)
148 
149    Input Parameters:
150 +  ts  - the TS context
151 .  t   - current time
152 .  U   - current iterate
153 -  ctx - [optional] context passed with eventhandler
154 
155    Output parameters:
156 .  fvalue    - function value of events at time t
157 
158    Calling sequence of postevent:
159    PetscErrorCode PostEvent(TS ts,PetscInt nevents_zero,PetscInt events_zero[],PetscReal t,Vec U,PetscBool forwardsolve,void* ctx)
160 
161    Input Parameters:
162 +  ts - the TS context
163 .  nevents_zero - number of local events whose event function is zero
164 .  events_zero  - indices of local events which have reached zero
165 .  t            - current time
166 .  U            - current solution
167 .  forwardsolve - Flag to indicate whether TS is doing a forward solve (1) or adjoint solve (0)
168 -  ctx          - the context passed with eventhandler
169 
170    Level: intermediate
171 
172 .keywords: TS, event, set
173 
174 .seealso: TSCreate(), TSSetTimeStep(), TSSetConvergedReason()
175 @*/
176 PetscErrorCode TSSetEventHandler(TS ts,PetscInt nevents,PetscInt direction[],PetscBool terminate[],PetscErrorCode (*eventhandler)(TS,PetscReal,Vec,PetscScalar[],void*),PetscErrorCode (*postevent)(TS,PetscInt,PetscInt[],PetscReal,Vec,PetscBool,void*),void *ctx)
177 {
178   PetscErrorCode ierr;
179   TSEvent        event;
180   PetscInt       i;
181   PetscBool      flg;
182 #if defined PETSC_USE_REAL_SINGLE
183   PetscReal      tol=1e-4;
184 #else
185   PetscReal      tol=1e-6;
186 #endif
187 
188   PetscFunctionBegin;
189   PetscValidHeaderSpecific(ts,TS_CLASSID,1);
190   if (nevents) {
191     PetscValidIntPointer(direction,2);
192     PetscValidIntPointer(terminate,3);
193   }
194 
195   ierr = PetscNewLog(ts,&event);CHKERRQ(ierr);
196   ierr = PetscMalloc1(nevents,&event->fvalue);CHKERRQ(ierr);
197   ierr = PetscMalloc1(nevents,&event->fvalue_prev);CHKERRQ(ierr);
198   ierr = PetscMalloc1(nevents,&event->fvalue_right);CHKERRQ(ierr);
199   ierr = PetscMalloc1(nevents,&event->zerocrossing);CHKERRQ(ierr);
200   ierr = PetscMalloc1(nevents,&event->side);CHKERRQ(ierr);
201   ierr = PetscMalloc1(nevents,&event->direction);CHKERRQ(ierr);
202   ierr = PetscMalloc1(nevents,&event->terminate);CHKERRQ(ierr);
203   ierr = PetscMalloc1(nevents,&event->vtol);CHKERRQ(ierr);
204   for (i=0; i < nevents; i++) {
205     event->direction[i] = direction[i];
206     event->terminate[i] = terminate[i];
207     event->zerocrossing[i] = PETSC_FALSE;
208     event->side[i] = 0;
209   }
210   ierr = PetscMalloc1(nevents,&event->events_zero);CHKERRQ(ierr);
211   event->nevents = nevents;
212   event->eventhandler = eventhandler;
213   event->postevent = postevent;
214   event->ctx = ctx;
215   event->timestep_posteventinterval = ts->time_step;
216 
217   event->recsize = 8;  /* Initial size of the recorder */
218   ierr = PetscOptionsBegin(((PetscObject)ts)->comm,((PetscObject)ts)->prefix,"TS Event options","TS");CHKERRQ(ierr);
219   {
220     ierr = PetscOptionsReal("-ts_event_tol","Scalar event tolerance for zero crossing check","TSSetEventTolerances",tol,&tol,NULL);CHKERRQ(ierr);
221     ierr = PetscOptionsName("-ts_event_monitor","Print choices made by event handler","",&flg);CHKERRQ(ierr);
222     ierr = PetscOptionsInt("-ts_event_recorder_initial_size","Initial size of event recorder","",event->recsize,&event->recsize,NULL);CHKERRQ(ierr);
223     ierr = PetscOptionsReal("-ts_event_post_eventinterval_step","Time step after event interval","",event->timestep_posteventinterval,&event->timestep_posteventinterval,NULL);CHKERRQ(ierr);
224   }
225   ierr = PetscOptionsEnd();CHKERRQ(ierr);
226 
227   ierr = PetscMalloc1(event->recsize,&event->recorder.time);CHKERRQ(ierr);
228   ierr = PetscMalloc1(event->recsize,&event->recorder.stepnum);CHKERRQ(ierr);
229   ierr = PetscMalloc1(event->recsize,&event->recorder.nevents);CHKERRQ(ierr);
230   ierr = PetscMalloc1(event->recsize,&event->recorder.eventidx);CHKERRQ(ierr);
231   for (i=0; i < event->recsize; i++) {
232     ierr = PetscMalloc1(event->nevents,&event->recorder.eventidx[i]);CHKERRQ(ierr);
233   }
234   /* Initialize the event recorder */
235   event->recorder.ctr = 0;
236 
237   for (i=0; i < event->nevents; i++) event->vtol[i] = tol;
238   if (flg) {ierr = PetscViewerASCIIOpen(PETSC_COMM_SELF,"stdout",&event->monitor);CHKERRQ(ierr);}
239 
240   ierr = TSEventDestroy(&ts->event);CHKERRQ(ierr);
241   ts->event = event;
242   ts->event->refct = 1;
243   PetscFunctionReturn(0);
244 }
245 
246 /*
247   TSEventRecorderResize - Resizes (2X) the event recorder arrays whenever the recording limit (event->recsize)
248                           is reached.
249 */
250 static PetscErrorCode TSEventRecorderResize(TSEvent event)
251 {
252   PetscErrorCode ierr;
253   PetscReal      *time;
254   PetscInt       *stepnum;
255   PetscInt       *nevents;
256   PetscInt       **eventidx;
257   PetscInt       i,fact=2;
258 
259   PetscFunctionBegin;
260 
261   /* Create large arrays */
262   ierr = PetscMalloc1(fact*event->recsize,&time);CHKERRQ(ierr);
263   ierr = PetscMalloc1(fact*event->recsize,&stepnum);CHKERRQ(ierr);
264   ierr = PetscMalloc1(fact*event->recsize,&nevents);CHKERRQ(ierr);
265   ierr = PetscMalloc1(fact*event->recsize,&eventidx);CHKERRQ(ierr);
266   for (i=0; i < fact*event->recsize; i++) {
267     ierr = PetscMalloc1(event->nevents,&eventidx[i]);CHKERRQ(ierr);
268   }
269 
270   /* Copy over data */
271   ierr = PetscMemcpy(time,event->recorder.time,event->recsize*sizeof(PetscReal));CHKERRQ(ierr);
272   ierr = PetscMemcpy(stepnum,event->recorder.stepnum,event->recsize*sizeof(PetscInt));CHKERRQ(ierr);
273   ierr = PetscMemcpy(nevents,event->recorder.nevents,event->recsize*sizeof(PetscInt));CHKERRQ(ierr);
274   for (i=0; i < event->recsize; i++) {
275     ierr = PetscMemcpy(eventidx[i],event->recorder.eventidx[i],event->recorder.nevents[i]*sizeof(PetscInt));CHKERRQ(ierr);
276   }
277 
278   /* Destroy old arrays */
279   for (i=0; i < event->recsize; i++) {
280     ierr = PetscFree(event->recorder.eventidx[i]);CHKERRQ(ierr);
281   }
282   ierr = PetscFree(event->recorder.eventidx);CHKERRQ(ierr);
283   ierr = PetscFree(event->recorder.nevents);CHKERRQ(ierr);
284   ierr = PetscFree(event->recorder.stepnum);CHKERRQ(ierr);
285   ierr = PetscFree(event->recorder.time);CHKERRQ(ierr);
286 
287   /* Set pointers */
288   event->recorder.time = time;
289   event->recorder.stepnum = stepnum;
290   event->recorder.nevents = nevents;
291   event->recorder.eventidx = eventidx;
292 
293   /* Double size */
294   event->recsize *= fact;
295 
296   PetscFunctionReturn(0);
297 }
298 
299 /*
300    Helper routine to handle user postevents and recording
301 */
302 static PetscErrorCode TSPostEvent(TS ts,PetscReal t,Vec U)
303 {
304   PetscErrorCode ierr;
305   TSEvent        event = ts->event;
306   PetscBool      terminate = PETSC_FALSE;
307   PetscBool      restart = PETSC_FALSE;
308   PetscInt       i,ctr,stepnum;
309   PetscBool      inflag[2],outflag[2];
310   PetscBool      forwardsolve = PETSC_TRUE; /* Flag indicating that TS is doing a forward solve */
311 
312   PetscFunctionBegin;
313   if (event->postevent) {
314     PetscObjectState state_prev,state_post;
315     ierr = PetscObjectStateGet((PetscObject)U,&state_prev);CHKERRQ(ierr);
316     ierr = (*event->postevent)(ts,event->nevents_zero,event->events_zero,t,U,forwardsolve,event->ctx);CHKERRQ(ierr);
317     ierr = PetscObjectStateGet((PetscObject)U,&state_post);CHKERRQ(ierr);
318     if (state_prev != state_post) restart = PETSC_TRUE;
319   }
320 
321   /* Handle termination events and step restart */
322   for (i=0; i<event->nevents_zero; i++) if (event->terminate[event->events_zero[i]]) terminate = PETSC_TRUE;
323   inflag[0] = restart; inflag[1] = terminate;
324   ierr = MPIU_Allreduce(inflag,outflag,2,MPIU_BOOL,MPI_LOR,((PetscObject)ts)->comm);CHKERRQ(ierr);
325   restart = outflag[0]; terminate = outflag[1];
326   if (restart) {ierr = TSRestartStep(ts);CHKERRQ(ierr);}
327   if (terminate) {ierr = TSSetConvergedReason(ts,TS_CONVERGED_EVENT);CHKERRQ(ierr);}
328   event->status = terminate ? TSEVENT_NONE : TSEVENT_RESET_NEXTSTEP;
329 
330   /* Reset event residual functions as states might get changed by the postevent callback */
331   if (event->postevent) {
332     ierr = VecLockReadPush(U);CHKERRQ(ierr);
333     ierr = (*event->eventhandler)(ts,t,U,event->fvalue,event->ctx);CHKERRQ(ierr);
334     ierr = VecLockReadPop(U);CHKERRQ(ierr);
335   }
336 
337   /* Cache current time and event residual functions */
338   event->ptime_prev = t;
339   for (i=0; i<event->nevents; i++)
340     event->fvalue_prev[i] = event->fvalue[i];
341 
342   /* Record the event in the event recorder */
343   ierr = TSGetStepNumber(ts,&stepnum);CHKERRQ(ierr);
344   ctr = event->recorder.ctr;
345   if (ctr == event->recsize) {
346     ierr = TSEventRecorderResize(event);CHKERRQ(ierr);
347   }
348   event->recorder.time[ctr] = t;
349   event->recorder.stepnum[ctr] = stepnum;
350   event->recorder.nevents[ctr] = event->nevents_zero;
351   for (i=0; i<event->nevents_zero; i++) event->recorder.eventidx[ctr][i] = event->events_zero[i];
352   event->recorder.ctr++;
353   PetscFunctionReturn(0);
354 }
355 
356 /* Uses Anderson-Bjorck variant of regula falsi method */
357 PETSC_STATIC_INLINE PetscReal TSEventComputeStepSize(PetscReal tleft,PetscReal t,PetscReal tright,PetscScalar fleft,PetscScalar f,PetscScalar fright,PetscInt side,PetscReal dt)
358 {
359   PetscReal new_dt, scal = 1.0;
360   if (PetscRealPart(fleft)*PetscRealPart(f) < 0) {
361     if (side == 1) {
362       scal = (PetscRealPart(fright) - PetscRealPart(f))/PetscRealPart(fright);
363       if (scal < PETSC_SMALL) scal = 0.5;
364     }
365     new_dt = (scal*PetscRealPart(fleft)*t - PetscRealPart(f)*tleft)/(scal*PetscRealPart(fleft) - PetscRealPart(f)) - tleft;
366   } else {
367     if (side == -1) {
368       scal = (PetscRealPart(fleft) - PetscRealPart(f))/PetscRealPart(fleft);
369       if (scal < PETSC_SMALL) scal = 0.5;
370     }
371     new_dt = (PetscRealPart(f)*tright - scal*PetscRealPart(fright)*t)/(PetscRealPart(f) - scal*PetscRealPart(fright)) - t;
372   }
373   return PetscMin(dt,new_dt);
374 }
375 
376 
377 PetscErrorCode TSEventHandler(TS ts)
378 {
379   PetscErrorCode ierr;
380   TSEvent        event;
381   PetscReal      t;
382   Vec            U;
383   PetscInt       i;
384   PetscReal      dt,dt_min;
385   PetscInt       rollback=0,in[2],out[2];
386   PetscInt       fvalue_sign,fvalueprev_sign;
387 
388   PetscFunctionBegin;
389   PetscValidHeaderSpecific(ts,TS_CLASSID,1);
390   if (!ts->event) PetscFunctionReturn(0);
391   event = ts->event;
392 
393   ierr = TSGetTime(ts,&t);CHKERRQ(ierr);
394   ierr = TSGetTimeStep(ts,&dt);CHKERRQ(ierr);
395   ierr = TSGetSolution(ts,&U);CHKERRQ(ierr);
396 
397   if (event->status == TSEVENT_NONE) {
398     event->timestep_prev = dt;
399   }
400 
401   if (event->status == TSEVENT_RESET_NEXTSTEP) {
402     dt = event->timestep_posteventinterval;
403     ierr = TSSetTimeStep(ts,dt);CHKERRQ(ierr);
404     event->status = TSEVENT_NONE;
405   }
406 
407   if (event->status == TSEVENT_NONE) {
408     event->ptime_end = t;
409   }
410 
411   ierr = VecLockReadPush(U);CHKERRQ(ierr);
412   ierr = (*event->eventhandler)(ts,t,U,event->fvalue,event->ctx);CHKERRQ(ierr);
413   ierr = VecLockReadPop(U);CHKERRQ(ierr);
414 
415   for (i=0; i < event->nevents; i++) {
416     if (PetscAbsScalar(event->fvalue[i]) < event->vtol[i]) {
417       event->status = TSEVENT_ZERO;
418       event->fvalue_right[i] = event->fvalue[i];
419       continue;
420     }
421     fvalue_sign = PetscSign(PetscRealPart(event->fvalue[i]));
422     fvalueprev_sign = PetscSign(PetscRealPart(event->fvalue_prev[i]));
423     if (fvalueprev_sign != 0 && (fvalue_sign != fvalueprev_sign) && (PetscAbsScalar(event->fvalue_prev[i]) > event->vtol[i])) {
424       switch (event->direction[i]) {
425       case -1:
426         if (fvalue_sign < 0) {
427           rollback = 1;
428 
429           /* Compute new time step */
430           dt = TSEventComputeStepSize(event->ptime_prev,t,event->ptime_right,event->fvalue_prev[i],event->fvalue[i],event->fvalue_right[i],event->side[i],dt);
431 
432           if (event->monitor) {
433             ierr = PetscViewerASCIIPrintf(event->monitor,"TSEvent: iter %D - Event %D interval detected [%g - %g]\n",event->iterctr,i,(double)event->ptime_prev,(double)t);CHKERRQ(ierr);
434           }
435           event->fvalue_right[i] = event->fvalue[i];
436           event->side[i] = 1;
437 
438           if (!event->iterctr) event->zerocrossing[i] = PETSC_TRUE;
439           event->status = TSEVENT_LOCATED_INTERVAL;
440         }
441         break;
442       case 1:
443         if (fvalue_sign > 0) {
444           rollback = 1;
445 
446           /* Compute new time step */
447           dt = TSEventComputeStepSize(event->ptime_prev,t,event->ptime_right,event->fvalue_prev[i],event->fvalue[i],event->fvalue_right[i],event->side[i],dt);
448 
449           if (event->monitor) {
450             ierr = PetscViewerASCIIPrintf(event->monitor,"TSEvent: iter %D - Event %D interval detected [%g - %g]\n",event->iterctr,i,(double)event->ptime_prev,(double)t);CHKERRQ(ierr);
451           }
452           event->fvalue_right[i] = event->fvalue[i];
453           event->side[i] = 1;
454 
455           if (!event->iterctr) event->zerocrossing[i] = PETSC_TRUE;
456           event->status = TSEVENT_LOCATED_INTERVAL;
457         }
458         break;
459       case 0:
460         rollback = 1;
461 
462         /* Compute new time step */
463         dt = TSEventComputeStepSize(event->ptime_prev,t,event->ptime_right,event->fvalue_prev[i],event->fvalue[i],event->fvalue_right[i],event->side[i],dt);
464 
465         if (event->monitor) {
466           ierr = PetscViewerASCIIPrintf(event->monitor,"TSEvent: iter %D - Event %D interval detected [%g - %g]\n",event->iterctr,i,(double)event->ptime_prev,(double)t);CHKERRQ(ierr);
467         }
468         event->fvalue_right[i] = event->fvalue[i];
469         event->side[i] = 1;
470 
471         if (!event->iterctr) event->zerocrossing[i] = PETSC_TRUE;
472         event->status = TSEVENT_LOCATED_INTERVAL;
473 
474         break;
475       }
476     }
477   }
478 
479   in[0] = event->status; in[1] = rollback;
480   ierr = MPIU_Allreduce(in,out,2,MPIU_INT,MPI_MAX,PetscObjectComm((PetscObject)ts));CHKERRQ(ierr);
481   event->status = (TSEventStatus)out[0]; rollback = out[1];
482   if (rollback) event->status = TSEVENT_LOCATED_INTERVAL;
483 
484   event->nevents_zero = 0;
485   if (event->status == TSEVENT_ZERO) {
486     for (i=0; i < event->nevents; i++) {
487       if (PetscAbsScalar(event->fvalue[i]) < event->vtol[i]) {
488         event->events_zero[event->nevents_zero++] = i;
489         if (event->monitor) {
490           ierr = PetscViewerASCIIPrintf(event->monitor,"TSEvent: Event %D zero crossing at time %g located in %D iterations\n",i,(double)t,event->iterctr);CHKERRQ(ierr);
491         }
492         event->zerocrossing[i] = PETSC_FALSE;
493       }
494       event->side[i] = 0;
495     }
496     ierr = TSPostEvent(ts,t,U);CHKERRQ(ierr);
497 
498     dt = event->ptime_end - t;
499     if (PetscAbsReal(dt) < PETSC_SMALL) { /* we hit the event, continue with the candidate time step */
500       dt = event->timestep_prev;
501       event->status = TSEVENT_NONE;
502     }
503     ierr = TSSetTimeStep(ts,dt);CHKERRQ(ierr);
504     event->iterctr = 0;
505     PetscFunctionReturn(0);
506   }
507 
508   if (event->status == TSEVENT_LOCATED_INTERVAL) {
509     ierr = TSRollBack(ts);CHKERRQ(ierr);
510     ierr = TSSetConvergedReason(ts,TS_CONVERGED_ITERATING);CHKERRQ(ierr);
511     event->status = TSEVENT_PROCESSING;
512     event->ptime_right = t;
513   } else {
514     for (i=0; i < event->nevents; i++) {
515       if (event->status == TSEVENT_PROCESSING && event->zerocrossing[i]) {
516         /* Compute new time step */
517         dt = TSEventComputeStepSize(event->ptime_prev,t,event->ptime_right,event->fvalue_prev[i],event->fvalue[i],event->fvalue_right[i],event->side[i],dt);
518         event->side[i] = -1;
519       }
520       event->fvalue_prev[i] = event->fvalue[i];
521     }
522     if (event->monitor && event->status == TSEVENT_PROCESSING) {
523       ierr = PetscViewerASCIIPrintf(event->monitor,"TSEvent: iter %D - Stepping forward as no event detected in interval [%g - %g]\n",event->iterctr,(double)event->ptime_prev,(double)t);CHKERRQ(ierr);
524     }
525     event->ptime_prev = t;
526   }
527 
528   if (event->status == TSEVENT_PROCESSING) event->iterctr++;
529 
530   ierr = MPIU_Allreduce(&dt,&dt_min,1,MPIU_REAL,MPIU_MIN,PetscObjectComm((PetscObject)ts));CHKERRQ(ierr);
531   ierr = TSSetTimeStep(ts,dt_min);CHKERRQ(ierr);
532   PetscFunctionReturn(0);
533 }
534 
535 PetscErrorCode TSAdjointEventHandler(TS ts)
536 {
537   PetscErrorCode ierr;
538   TSEvent        event;
539   PetscReal      t;
540   Vec            U;
541   PetscInt       ctr;
542   PetscBool      forwardsolve=PETSC_FALSE; /* Flag indicating that TS is doing an adjoint solve */
543 
544   PetscFunctionBegin;
545   PetscValidHeaderSpecific(ts,TS_CLASSID,1);
546   if (!ts->event) PetscFunctionReturn(0);
547   event = ts->event;
548 
549   ierr = TSGetTime(ts,&t);CHKERRQ(ierr);
550   ierr = TSGetSolution(ts,&U);CHKERRQ(ierr);
551 
552   ctr = event->recorder.ctr-1;
553   if (ctr >= 0 && PetscAbsReal(t - event->recorder.time[ctr]) < PETSC_SMALL) {
554     /* Call the user postevent function */
555     if (event->postevent) {
556       ierr = (*event->postevent)(ts,event->recorder.nevents[ctr],event->recorder.eventidx[ctr],t,U,forwardsolve,event->ctx);CHKERRQ(ierr);
557       event->recorder.ctr--;
558     }
559   }
560 
561   PetscBarrier((PetscObject)ts);
562   PetscFunctionReturn(0);
563 }
564