CB.StartMultiSimul

This subroutine enables you to use resources more effectively when running multiple simulations using CB.Simulation. It calls CheckData on the first simulation and then increments the iterations counter at the start of each simulation.

If you call CB.StartMultiSimul before multiple simulations, then call CB.StopMultiSimul after the simulations are run.

Table 188. CB.StartMultiSimul Parameters

Parameter

VBA Data Type

Value

Description

Rescan (Optional)

Boolean

True or False

Indicates whether to rescan the workbook for each simulation call within a multiple simulation. The default is False, which eliminates rescans for faster processing.

This optional parameter only works in Extreme Speed.

SaveAssumValues (Optional)

Boolean

True or False

If set to True, saves assumption values from multiple simulations for use in sensitivity analysis and other analyses. The default is False.

MultiAutoDownshift (Optional)

Boolean

True or False

With CB.AutoDownshift set to True, if MultiAutoDownshift is set to True, Crystal Ball automatically downshifts to Normal speed when Extreme speed incompatibilities occur. No dialog appears. The default is False.

This optional parameter only works in Extreme Speed.

Note:

If a non-decision variable cell referenced in a forecast formula (a forecast precedent) is changed between simulations, there might be slight differences in results depending on whether Rescan is set to True or False. If custom code is created where precedent values are changed manually between simulations, these models need to call StartMultiSimul with Rescan set to True. This change might also be true for some models running in Extreme Speed.