Change Collection Mode
This operation specifies the mode and frequency with which to collect data for a statistic. The sample and bucket capture modes might reduce the amount of data collected during a simulation, which can significantly reduce the size of output files.
The available capture modes are:
- All values – collects every data point from a statistic.
- Sample – collects the data according to a user-specified time interval or sample count. For example, if the time interval is 10, data is sampled and recorded every 10th second. If the sample count is 10, every 10th data point is recorded. All other data points are discarded.
- Bucket – collects all of the points over the time interval or sample count into a “data bucket” and generates a result from each bucket. This is the default mode.
Procedure 164: Setting the Sample Frequency of a Statistic
-
Right-click a statistic name and choose Change Collection Mode from the Statistic pop-up menu.
A dialog box opens with basic statistic collection options.
-
Select a radio button for one of the sample frequency modes and enter a frequency value.
Sample-frequency options have different meanings for bucket mode (the default) or sample mode. The options for bucket mode are:
- Every n seconds – each bucket collects all values generated during n seconds of simulation time. If n equals 10, a new value is generated to the output vector after every 10 seconds of simulation time (regardless of how many values are in the bucket).
- Every n values – collects n values in each bucket. If n equals 10, a new value is generated to the output vector whenever the bucket contains 10 values (regardless of how much simulation time has elapsed).
- Total of n values – This is the default mode. The total number of buckets is fixed at n. As in “seconds” bucket mode, each bucket is defined by time: given a simulation duration time of t seconds, and a sample-frequency rate of n, each bucket is the set of all values collected during t/n seconds of simulation time. The number of values in each bucket is not fixed. The default value of n is set by the “Values per Statistic” attribute in the Configure/Run Des Dialog Box.
The options for sample mode are:
- Every n seconds – collects the statistic value at the specified time interval. If n equals 10, data is sampled and recorded every tenth second of simulation time. All other data points are discarded.
- Every n values – collects the statistic value at the specified sample count. If n equals 10, every tenth data point is recorded. All other data points are discarded.
- Total of n values – collects all data up to the specified number of values, either the default set for the statistic (usually 100) or a user-specified number of values. The default value of n is set by the “Values per Statistic” attribute in the Configure/Run DES dialog box.
-
Click OK to close the dialog box.
Procedure 165: Setting the Capture Mode of a Statistic
-
Right-click a statistic name and choose Change Collection Mode from the Statistic pop-up menu.
A dialog box opens with basic statistic collection options.
-
Select the Advanced checkbox.
Pull-down menus for Capture Mode and Bucket Mode are added to the dialog box.
-
Choose the desired capture mode from the Capture Mode pull-down menu: all values, sample, bucket (the default), or glitch removal.
-
Select a sample frequency mode and value. (See Setting the Sample Frequency of a Statistic for more information.)
- If using bucket mode (the default), you can also specify how to generate a result from each bucket of data. The options on the Bucket mode pull-down menu are:
- max value – The maximum of all the values collected for that bucket period.
- min value – The minimum of all the values collected for that bucket period.
- sum – The sum of all the values collected for that bucket period.
- count – The total number of values collected for that bucket period.
- sample mean – The average of all the values collected for that bucket period.
- time average – The average value where the values that are averaged are weighted according to their duration (where duration is the time between the current value and the next value).
- sum / time – The sum of all the values of points within a particular bucket, divided by the time duration of the bucket.
- summary – The sample mean, the minimum/maximum values, and the standard deviation. Each of these values is graphed separately.
-
In a few special cases you may want to turn off the Reset checkbox when using bucket mode. With Reset checked (the default position), the bucket value is reset to zero after generating a value and writing it to the output vector. This ensures that each bucket value reflects only the data collected for that bucket. Unchecking Reset causes the bucket value to be retained (not reset to zero) and incorporated into the next bucket. This setting can greatly affect how values are calculated: for example, it determines if the “max value” mode generates the highest value in each bucket (Reset checked) or the highest value generated up to that point (Reset unchecked).
-
Click OK to close the dialog box.