PsiConverged ()

PsiConverged (output_cell, [simulation])

PsiConverged returns True if an adequate number of trials have been performed in order for the uncertain function to converge.  Otherwise, this statistic returns False.  Convergence monitoring is performed using the mean (PsiMean).

PsiConverged is a statistic to PsiOutput (only).  The output_cell must be defined explicitly though PsiOutput. The parameters for the statistic are obtained when the property PsiConvergence is used in conjunction with PsiOutput(). See example below. See the definition for PsiConvergence for more information on PsiConvergence parameters.

The required argument, output_cell, must be a valid Excel cell containing an uncertain function defined explicitly though PsiOutput(), which must contain the PsiConvergence property. (See example below.) If the PsiConvergence property is missing from the PsiOutput() function in output_cell, PsiConverged will return #N/A.

The optional argument, simulation, must be an integer from 1 to the Number of Simulations as set in the Platform tab of the Analytic Solver Taskpane.  If the Number of Simulations is set to 5, then simulation can be 1,2,3,4 or 5. The default setting is 1.

Note: 

• If, after a simulation has been successfully completed, all PsiConverged functions return True, then you might consider lowering the Number of Iterations on the Platform tab of the Analytic Solver Task pane, since all output functions converged to the desired mean threshold.  Conversely, if some or all PsiConverged functions are returning False, then you might consider increasing the number of iterations in order to attain convergence for all output functions in the model. 

Example: 

A1=PsiNormal(5,6)+PsiOutput("Test",1,PsiConvergence(0.01,2))

A2 = PsiConverged(A1,2)

Output for A2 will be either True, indicating that the mean (PsiMean) of the output function in A1 has converged to within 1% (.01) of its true value in the 2nd simulation.  If not, this function will return False.