Mercurial > octave-nkf
comparison src/DLD-FUNCTIONS/dasrt.cc @ 10840:89f4d7e294cc
Grammarcheck .cc files
author | Rik <octave@nomad.inbox5.com> |
---|---|
date | Sat, 31 Jul 2010 11:18:11 -0700 |
parents | 3140cb7a05a1 |
children | a4f482e66b65 |
comparison
equal
deleted
inserted
replaced
10839:65bc065bec95 | 10840:89f4d7e294cc |
---|---|
296 @example\n\ | 296 @example\n\ |
297 @var{g_out} = g (@var{x}, @var{t})\n\ | 297 @var{g_out} = g (@var{x}, @var{t})\n\ |
298 @end example\n\ | 298 @end example\n\ |
299 \n\ | 299 \n\ |
300 and return a vector of the constraint function values.\n\ | 300 and return a vector of the constraint function values.\n\ |
301 If the value of any of the constraint functions changes sign, @sc{Dasrt}\n\ | 301 If the value of any of the constraint functions changes sign, @sc{dasrt}\n\ |
302 will attempt to stop the integration at the point of the sign change.\n\ | 302 will attempt to stop the integration at the point of the sign change.\n\ |
303 \n\ | 303 \n\ |
304 If the name of the constraint function is omitted, @code{dasrt} solves\n\ | 304 If the name of the constraint function is omitted, @code{dasrt} solves\n\ |
305 the same problem as @code{daspk} or @code{dassl}.\n\ | 305 the same problem as @code{daspk} or @code{dassl}.\n\ |
306 \n\ | 306 \n\ |
307 Note that because of numerical errors in the constraint functions\n\ | 307 Note that because of numerical errors in the constraint functions\n\ |
308 due to round-off and integration error, @sc{Dasrt} may return false\n\ | 308 due to round-off and integration error, @sc{dasrt} may return false\n\ |
309 roots, or return the same root at two or more nearly equal values of\n\ | 309 roots, or return the same root at two or more nearly equal values of\n\ |
310 @var{T}. If such false roots are suspected, the user should consider\n\ | 310 @var{T}. If such false roots are suspected, the user should consider\n\ |
311 smaller error tolerances or higher precision in the evaluation of the\n\ | 311 smaller error tolerances or higher precision in the evaluation of the\n\ |
312 constraint functions.\n\ | 312 constraint functions.\n\ |
313 \n\ | 313 \n\ |
314 If a root of some constraint function defines the end of the problem,\n\ | 314 If a root of some constraint function defines the end of the problem,\n\ |
315 the input to @sc{Dasrt} should nevertheless allow integration to a\n\ | 315 the input to @sc{dasrt} should nevertheless allow integration to a\n\ |
316 point slightly past that root, so that @sc{Dasrt} can locate the root\n\ | 316 point slightly past that root, so that @sc{dasrt} can locate the root\n\ |
317 by interpolation.\n\ | 317 by interpolation.\n\ |
318 \n\ | 318 \n\ |
319 The third and fourth arguments to @code{dasrt} specify the initial\n\ | 319 The third and fourth arguments to @code{dasrt} specify the initial\n\ |
320 condition of the states and their derivatives, and the fourth argument\n\ | 320 condition of the states and their derivatives, and the fourth argument\n\ |
321 specifies a vector of output times at which the solution is desired,\n\ | 321 specifies a vector of output times at which the solution is desired,\n\ |
322 including the time corresponding to the initial condition.\n\ | 322 including the time corresponding to the initial condition.\n\ |
323 \n\ | 323 \n\ |
324 The set of initial states and derivatives are not strictly required to\n\ | 324 The set of initial states and derivatives are not strictly required to\n\ |
325 be consistent. In practice, however, @sc{Dassl} is not very good at\n\ | 325 be consistent. In practice, however, @sc{dassl} is not very good at\n\ |
326 determining a consistent set for you, so it is best if you ensure that\n\ | 326 determining a consistent set for you, so it is best if you ensure that\n\ |
327 the initial values result in the function evaluating to zero.\n\ | 327 the initial values result in the function evaluating to zero.\n\ |
328 \n\ | 328 \n\ |
329 The sixth argument is optional, and may be used to specify a set of\n\ | 329 The sixth argument is optional, and may be used to specify a set of\n\ |
330 times that the DAE solver should not integrate past. It is useful for\n\ | 330 times that the DAE solver should not integrate past. It is useful for\n\ |
331 avoiding difficulties with singularities and points where there is a\n\ | 331 avoiding difficulties with singularities and points where there is a\n\ |
332 discontinuity in the derivative.\n\ | 332 discontinuity in the derivative.\n\ |
333 \n\ | 333 \n\ |
334 After a successful computation, the value of @var{istate} will be\n\ | 334 After a successful computation, the value of @var{istate} will be\n\ |
335 greater than zero (consistent with the Fortran version of @sc{Dassl}).\n\ | 335 greater than zero (consistent with the Fortran version of @sc{dassl}).\n\ |
336 \n\ | 336 \n\ |
337 If the computation is not successful, the value of @var{istate} will be\n\ | 337 If the computation is not successful, the value of @var{istate} will be\n\ |
338 less than zero and @var{msg} will contain additional information.\n\ | 338 less than zero and @var{msg} will contain additional information.\n\ |
339 \n\ | 339 \n\ |
340 You can use the function @code{dasrt_options} to set optional\n\ | 340 You can use the function @code{dasrt_options} to set optional\n\ |