/usr/share/octave/site/m/sundialsTB/cvodes/function_types/CVMonitorFnB.m is in octave-sundials 2.5.0-3+b1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 | %CVMonitorFnB - type of user provided monitoring function for backward problems.
%
% The function MONFUNB must be defined as
% FUNCTION [] = MONFUNB(CALL, IDXB, T, Y, YQ)
% It is called after every internal CVodeB step and can be used to
% monitor the progress of the solver. MONFUNB is called with CALL=0
% from CVodeInitB at which time it should initialize itself and it
% is called with CALL=2 from CVodeFree. Otherwise, CALL=1.
%
% It receives as arguments the index of the backward problem (as
% returned by CVodeInitB), the current time T, solution vector Y,
% and, if it was computed, the quadrature vector YQ. If quadratures
% were not computed for this backward problem, YQ is empty here.
%
% If additional data is needed inside MONFUNB, it must be defined
% as
% FUNCTION NEW_MONDATA = MONFUNB(CALL, IDXB, T, Y, YQ, MONDATA)
% If the local modifications to the user data structure need to be
% saved (e.g. for future calls to MONFUNB), then MONFUNB must set
% NEW_MONDATA. Otherwise, it should set NEW_MONDATA=[]
% (do not set NEW_MONDATA = DATA as it would lead to unnecessary copying).
%
% A sample monitoring function, CVodeMonitorB, is provided with CVODES.
%
% See also CVodeSetOptions, CVodeMonitorB
%
% NOTES:
%
% MONFUNB is specified through the MonitorFn property in CVodeSetOptions.
% If this property is not set, or if it is empty, MONFUNB is not used.
% MONDATA is specified through the MonitorData property in CVodeSetOptions.
%
% See CVodeMonitorB for an implementation example.
% Radu Serban <radu@llnl.gov>
% Copyright (c) 2005, The Regents of the University of California.
% $Revision: 1.1 $Date: 2007/05/11 18:51:33 $
|