|
ContactCenters V. 0.9.9. |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectumontreal.iro.lecuyer.contactcenters.app.AbstractContactCenterInfo
umontreal.iro.lecuyer.contactcenters.app.AbstractContactCenterEval
umontreal.iro.lecuyer.contactcenters.app.AbstractContactCenterSim
public abstract class AbstractContactCenterSim
Helper class to implement a contact center simulator.
Field Summary | |
---|---|
protected boolean |
autoResetStartStream
Determines if random streams are automatically reset. |
protected boolean |
seqSampEachEval
|
Constructor Summary | |
---|---|
AbstractContactCenterSim()
|
Method Summary | |
---|---|
String |
formatStatistics()
Formats information about every performance measure after ContactCenterEval.eval() is called. |
boolean |
formatStatisticsExcel(WritableWorkbook wb)
Constructs and returns an JExcel API workbook containing the results of the evaluation, and appends the contents of the generated report to the workbook wb. |
String |
formatStatisticsLaTeX()
Formats and returns a statistical report that can be included into a LATEX document. |
boolean |
getAutoResetStartStream()
Determines if the random streams are automatically reset at the end of each evaluation. |
static DoubleMatrix2D[] |
getConfidenceInterval(MatrixOfStatProbes<?> sm,
double level)
|
DoubleMatrix2D[] |
getConfidenceInterval(PerformanceMeasureType m,
double level)
Returns confidence intervals on the means or ratios of means, for the group of performance measures m, with confidence level level. |
MatrixOfFunctionOfMultipleMeansTallies<?> |
getMatrixOfFunctionOfMultipleMeansTallies(PerformanceMeasureType m)
Returns the matrix of function of multiple means tallies used to manage observations for estimating the performance measures in group m. |
MatrixOfTallies<?> |
getMatrixOfTallies(PerformanceMeasureType m)
Returns the matrix of tallies used to manage observations for estimating the performance measures in group m. |
DoubleMatrix2D |
getMax(PerformanceMeasureType m)
Returns a matrix of maximum values for the performance measure m. |
DoubleMatrix2D |
getMin(PerformanceMeasureType m)
Returns a matrix of minimum values for the group of performance measures m. |
protected boolean |
getOneSimDone()
|
DoubleMatrix2D |
getPerformanceMeasure(PerformanceMeasureType m)
Returns the matrix of values corresponding to the group of performance measures m estimated by the last call to ContactCenterEval.eval() . |
boolean |
getSeqSampEachEval()
Determines if sequential sampling is done upon each call on ContactCenterSim.eval() . |
DoubleMatrix2D |
getVariance(PerformanceMeasureType m)
Returns a matrix of sample variances for the group of performance measures m. |
boolean |
hasPerformanceMeasure(PerformanceMeasureType m)
Calls ContactCenterEval.getPerformanceMeasures() and searches for m in the
returned array. |
void |
setAutoResetStartStream(boolean r)
Sets the automatic reset start stream indicator to r. |
protected void |
setOneSimDone(boolean oneSimDone)
|
void |
setSeqSampEachEval(boolean seqSampEachEval)
Sets the indicator for sequential sampling on each eval to seqSamp. |
Methods inherited from class umontreal.iro.lecuyer.contactcenters.app.AbstractContactCenterEval |
---|
getEvalInfo, getReportParams, isVerbose, setReportParams, setVerbose |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface umontreal.iro.lecuyer.contactcenters.app.ContactCenterSim |
---|
eval, getCompletedSteps, getConfidenceLevel, getMatrixOfStatProbes, newSeeds, resetNextSubstream, resetStartStream, resetStartSubstream, setConfidenceLevel |
Methods inherited from interface umontreal.iro.lecuyer.contactcenters.app.ContactCenterEval |
---|
getEvalInfo, getEvalOption, getEvalOptions, getPerformanceMeasures, getReportParams, hasEvalOption, isVerbose, reset, seemsUnstable, setEvalOption, setReportParams, setVerbose |
Field Detail |
---|
protected boolean autoResetStartStream
protected boolean seqSampEachEval
Constructor Detail |
---|
public AbstractContactCenterSim()
Method Detail |
---|
protected boolean getOneSimDone()
protected void setOneSimDone(boolean oneSimDone)
public boolean getAutoResetStartStream()
ContactCenterSim
RandomStream.resetStartStream()
on each RandomStream
object he has created for
ContactCenterSim.eval()
to use the same seeds if called multiple times.
If this option is set to false,
the streams are not reset automatically, and
ContactCenterSim.eval()
always returns different results when called
multiple times.
However, RandomStream.resetNextSubstream()
should still be called for all random streams after
each replication.
getAutoResetStartStream
in interface ContactCenterSim
public void setAutoResetStartStream(boolean r)
ContactCenterSim
setAutoResetStartStream
in interface ContactCenterSim
r
- the new value of the indicator.ContactCenterSim.getAutoResetStartStream()
public boolean getSeqSampEachEval()
ContactCenterSim
ContactCenterSim.eval()
.
If the implemented simulator uses sequential sampling,
the number of steps (replications or batches) simulated
is random. By default, the first call to
ContactCenterSim.eval()
determines the number of simulated
steps while each subsequent call to
ContactCenterSim.eval()
simulates the exact same
number of steps, without reapplying
sequential sampling.
Turning this flag on changes this behavior,
forcing the simulator to perform
sequential sampling upon every call to
ContactCenterSim.eval()
.
getSeqSampEachEval
in interface ContactCenterSim
public void setSeqSampEachEval(boolean seqSampEachEval)
ContactCenterSim
setSeqSampEachEval
in interface ContactCenterSim
seqSampEachEval
- the new value of the indicator.public boolean hasPerformanceMeasure(PerformanceMeasureType m)
ContactCenterEval.getPerformanceMeasures()
and searches for m in the
returned array.
hasPerformanceMeasure
in interface ContactCenterEval
m
- the performance measure being tested.
NullPointerException
- if m is null.public MatrixOfTallies<?> getMatrixOfTallies(PerformanceMeasureType m)
ContactCenterSim
getMatrixOfTallies
in interface ContactCenterSim
m
- the group of performance measures of interest.
public MatrixOfFunctionOfMultipleMeansTallies<?> getMatrixOfFunctionOfMultipleMeansTallies(PerformanceMeasureType m)
ContactCenterSim
getMatrixOfFunctionOfMultipleMeansTallies
in interface ContactCenterSim
m
- the group of performance measures of interest.
public DoubleMatrix2D getPerformanceMeasure(PerformanceMeasureType m)
ContactCenterEval
ContactCenterEval.eval()
. The dimensions
of the matrix and the role of its elements depend on the
queried group of performance
measures, and the capabilities of the implementing
evaluation system. See the PerformanceMeasureType
class for more information about the defined performance
measures.
If the queried measure is not supported by this evaluation object, this throws a
NoSuchElementException
. If the values of
the measures are not available, e.g., the ContactCenterEval.eval()
method was never called after the last call to ContactCenterEval.reset()
,
this throws an IllegalStateException
.
getPerformanceMeasure
in interface ContactCenterEval
m
- the queried group of performance measures.
public DoubleMatrix2D getVariance(PerformanceMeasureType m)
ContactCenterSim
NoSuchElementException
.
getVariance
in interface ContactCenterSim
m
- the queried group of performance measures.
public DoubleMatrix2D getMin(PerformanceMeasureType m)
ContactCenterSim
NoSuchElementException
.
getMin
in interface ContactCenterSim
m
- the queried group of performance measures.
public DoubleMatrix2D getMax(PerformanceMeasureType m)
ContactCenterSim
NoSuchElementException
.
getMax
in interface ContactCenterSim
m
- the queried group of performance measures.
public DoubleMatrix2D[] getConfidenceInterval(PerformanceMeasureType m, double level)
ContactCenterSim
getConfidenceInterval
in interface ContactCenterSim
m
- the queried group of performance measures.level
- desired probability that, for a given performance measure,
the (random) confidence interval covers the true mean (a constant).
public static DoubleMatrix2D[] getConfidenceInterval(MatrixOfStatProbes<?> sm, double level)
public String formatStatistics()
ContactCenterEval
ContactCenterEval.eval()
is called.
It can be simulation statistics, information
about the steps of an approximation algorithm,
or simply the values of all performance measures.
This method should call ContactCenterEval.getEvalInfo()
to obtain general information about the evaluation
and incorporate the information into the
returned string.
For each entry in the map, the method
should add a key: value line
in the string.
Then, the method appends the performance measures
to the returned string.
The PerformanceMeasureFormatText
class
can be used to convert matrices of performance measures
into strings.
If the evaluation was not triggered by
calling ContactCenterEval.eval()
before this method is called,
an IllegalStateException
is thrown.
If no statistical information is available even
after the evaluation, this method should return
an empty string instead of throwing an exception.
formatStatistics
in interface ContactCenterEval
formatStatistics
in class AbstractContactCenterEval
public String formatStatisticsLaTeX()
ContactCenterEval
ContactCenterEval.formatStatistics()
,
except the generated report is in LATEX rather than
plain text.
formatStatisticsLaTeX
in interface ContactCenterEval
formatStatisticsLaTeX
in class AbstractContactCenterEval
public boolean formatStatisticsExcel(WritableWorkbook wb)
ContactCenterEval
ContactCenterEval.getEvalInfo()
to a sheet in the
workbook.
This method returns true if and only if the given
workbook was modified.
One can then customize the returned workbook as needed.
The method WritableWorkbook.write()
can
be used to export the workbook to an output
stream.
This can be used to create files that can be opened
directly by Microsoft Excel for
results analysis and reporting.
Excel documents can also be opened by
open source software such as OpenOffice.org,
KOffice, etc.
formatStatisticsExcel
in interface ContactCenterEval
formatStatisticsExcel
in class AbstractContactCenterEval
wb
- the workbook to append report to.
|
ContactCenters V. 0.9.9. |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |