complexType "ccapp:SequentialSamplingParams"

Namespace: | http://www.iro.umontreal.ca/lecuyer/contactcenters/app
Content: | empty, 4 attributes
Defined: | globally in ccapp.xsd, see XML source
Includes: | definitions of 4 attributes
Used: | at 1 location

XML Representation Summary
<...
| confidenceLevel | = | xsd:double
| globalOnly | = | xsd:boolean : "false"
| measure | = | xsd:string
| targetError | = | xsd:double
/>

All Direct / Indirect Based Elements (1):

  sequentialSampling (type ccapp:SequentialSamplingParams) |

Known Usage Locations

- As direct type of elements (1):

  sequentialSampling (type ccapp:SequentialSamplingParams) |

Annotation
Determines parameters for sequential sampling based on some type of performance measure. When using sequential sampling, the number of replications or batches is increased until the relative error on some performance measures falls below a given threshold. An element of this type is used to set this threshold for a specific type of performance measure.

By default, a constant number of observations, specified in the parameter file of the experiment, is obtained by simulation. Depending on the type of experiment, observations correspond to replications, or batches. The minimal number of observations is given by the `minReplications` or `minBatches` attributes, in experiment parameters.

However, if a target relative error is given for a set of performance measures selected using `sequentialSampling` elements in experiment parameters, the number of observations becomes random: after a minimum of n 0 observations are obtained, the simulator computes the estimates for the selected measures and their associated confidence intervals. Let X be an estimator for one of the selected performance measures, and let the confidence interval on the true performance measure be [ [X - D, X + D] with confidence level set by the attribute `confidenceLevel.` For each checked performance measure, the relative error D / X must be smaller than or equal to the threshold E selected by the `targetError` attribute. If this condition is violated for at least one checked performance measure, a new target number of observations is determined by rounding n 0 * (D / (E * |X|))^2 to the nearest integer, and additional observations are collected. In other words, the sample size increases until the required precision is attained. The process is repeated until the target relative error is reached, or a maximal number of observations given in experiment parameters is reached.

The `measure` attribute is used to determine the type of performance measures on which sequential sampling is performed. By default, the procedure is applied on each performance measure of the selected type, and the number of additional observations is the maximum of the numbers obtained for each measure. However, if the `globalOnly` attribute is set to `true,` only the performance measure for all contact types, agent groups, and periods, is checked.

If d performance measures are considered by the sequential sampling, with individual confidence levels 1-a 1 , ..., 1-a d , the overall confidence level for all the estimates to have a relative error smaller than the targets is 1-a 1 *...*a d .

XML Source (w/o annotations (5); see schema source)

<xsd:complexType name="SequentialSamplingParams"> <xsd:attribute name="measure" type="xsd:string" use="required"> </xsd:attribute> <xsd:attribute name="targetError" type="ssj:nonNegativeDouble" use="required"> </xsd:attribute> <xsd:attribute name="confidenceLevel" type="ssj:double01" use="required"> </xsd:attribute> <xsd:attribute default="false" name="globalOnly" type="xsd:boolean"> </xsd:attribute> </xsd:complexType>

Attribute Detail
confidenceLevel

  Determines the desired level of confidence used to compute relative errors.

  Type: | ssj:double01
  Use: | required
  Defined: | locally, within (this) ccapp:SequentialSamplingParams complexType

  XML Source (w/o annotations (1); see schema source)

  <xsd:attribute name="confidenceLevel" type="ssj:double01" use="required"> </xsd:attribute>

globalOnly

  Determines if the error check is performed on the global measure only. If this attribute is set to `true,` the check is made on the global performance measure of the type specified by the `measure` attribute. Otherwise, the check is made over all performance measures of that type.

  Type: | xsd:boolean
  Use: | optional
  Default: | "false"
  Defined: | locally, within (this) ccapp:SequentialSamplingParams complexType

  XML Source (w/o annotations (1); see schema source)

  <xsd:attribute default="false" name="globalOnly" type="xsd:boolean"> </xsd:attribute>

measure

  Gives the name of the type of performance measure affected by this set of parameters. This can correspond to any enum constant in Java class `PerformanceMeasureType` from package `umontreal.iro.lecuyer.contactcenters.app.`

  Type: | xsd:string
  Use: | required
  Defined: | locally, within (this) ccapp:SequentialSamplingParams complexType

  XML Source (w/o annotations (1); see schema source)

  <xsd:attribute name="measure" type="xsd:string" use="required"> </xsd:attribute>

targetError

  Determines the target relative error for sequential sampling. The relative error is estimated by dividing the half-width of the confidence interval by the average. By default, the relative error of all the performance measures of type referred by the `measure` attribute needs to be less than or equal to the target error for the simulation to stop.

  Type: | ssj:nonNegativeDouble
  Use: | required
  Defined: | locally, within (this) ccapp:SequentialSamplingParams complexType

  XML Source (w/o annotations (1); see schema source)

  <xsd:attribute name="targetError" type="ssj:nonNegativeDouble" use="required"> </xsd:attribute>

XML Schema documentation generated with DocFlex/XML (Kit) v1.6.8 DocFlex/XML (Kit) is a freeware edition of DocFlex/XML, which is a powerful template-driven documentation and report generator from any data stored in XML files. Based on an innovative technology developed by FILIGRIS WORKS, this new tool offers virtuoso data querying and formatting capabilities not found in anything else! Need to convert your XML data into a clear nice-looking documentation or reports? Web-ready hypertext HTML or printable MS Word / OpenOffice.org friendly RTF? DocFlex/XML may be a cheap, quick and effective solution exactly for this task! Have questions? Not sure how to use it? Just send us e-mail to contact@filigris.com and we are always happy to help you! See also our services at www.filigris.com