Integrator Limit Functions

Integrator Limit Functions

Table 12 lists the integrator limit functions. These functions set limits on how far the integration will be allowed to proceed to prevent a runaway condition should an error occur or if the ODE is ill conditioned.

Table 12 Integrator Limit Functions.

Usage

pInteg->SetMaxSteps();

pInteg->SetMaxSteps(iMaxSteps);

Arguments

Return Value

None.

Notes

This function limits the number of integration steps the integrator is allowed to take. This is to keep the integrator from taking too many steps because the step size becomes so small that it essentially takes forever to complete integration. This value can be set arbitrarily large for fixed step size methods or if the variable-step method is expected to be benign.

Usage

pInteg->SetMaxRejectedSteps();

pInteg->SetMaxRejectedSteps(iMaxReject);

Arguments

Return Value

None.

Notes

This function limits the number of times the integrator can reject the step size selection for a given integration step. When using a variable step size method, the step size for the next step is chosen based on the error tolerance of the step. Occasionally, especially near discontinuities, the step size may have to be drastically reduced to meet the error requirements on the current step. If the function is too ill behaved, a large number of steps are rejected.