|
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.ContactCenterEvalResults
umontreal.iro.lecuyer.contactcenters.app.ContactCenterSimResults
public class ContactCenterSimResults
Extends ContactCenterEvalResults
to store
additional information related to the simulation of a call
center.
Constructor Summary | |
---|---|
ContactCenterSimResults(ContactCenterSim sim)
Constructs a new contact center results container by getting simulation results from the simulator sim, and compoting confidence intervals with level level. |
|
ContactCenterSimResults(ContactCenterSimResultsParams ccp)
Constructs a new object containing results read from the parameter object ccp. |
Method Summary | |
---|---|
void |
check()
|
ContactCenterSimResultsParams |
createParams()
Creates a parameter object that can be marshalled using JAXB from this object, and copies its evaluation results.. |
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. |
int |
getCompletedSteps()
Returns the number of completed steps for the simulation. |
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. |
double |
getConfidenceLevel()
Returns the confidence level of the intervals output by ContactCenterEval.formatStatistics() . |
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. |
MatrixOfStatProbes<?> |
getMatrixOfStatProbes(PerformanceMeasureType m)
Returns the matrix of statistical probes 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. |
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. |
void |
newSeeds()
Changes the seeds of the random number generators used during the simulation. |
void |
resetNextSubstream()
Calls RandomStream.resetNextSubstream()
for all random streams used by the simulator. |
void |
resetStartStream()
Calls RandomStream.resetStartStream()
for all random streams used by the simulator. |
void |
resetStartSubstream()
Calls RandomStream.resetStartSubstream()
for all random streams used by the simulator. |
void |
setAutoResetStartStream(boolean r)
Sets the automatic reset start stream indicator to r. |
void |
setConfidenceLevel(double level)
Sets the level of confidence for the intervals output by ContactCenterEval.formatStatistics()
to level. |
void |
setSeqSampEachEval(boolean seqSamp)
Sets the indicator for sequential sampling on each eval to seqSamp. |
void |
writeParams(ContactCenterEvalResultsParams ccp)
Fills ccp with parameters stored in this object. |
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 |
Methods inherited from interface umontreal.iro.lecuyer.contactcenters.app.ContactCenterEval |
---|
getEvalInfo, getEvalOption, getEvalOptions, getPerformanceMeasure, getPerformanceMeasures, getReportParams, hasEvalOption, hasPerformanceMeasure, isVerbose, reset, seemsUnstable, setEvalOption, setReportParams, setVerbose |
Constructor Detail |
---|
public ContactCenterSimResults(ContactCenterSimResultsParams ccp)
ContactCenterEvalResults.createFromParams(ContactCenterEvalResultsParams)
method to create instances of this class.
ccp
- the contact centers results.public ContactCenterSimResults(ContactCenterSim sim)
sim
- the contact center simulator.Method Detail |
---|
public void writeParams(ContactCenterEvalResultsParams ccp)
ContactCenterEvalResults
ContactCenterEvalResults.createParams()
instead.
writeParams
in class ContactCenterEvalResults
ccp
- the output parameter object.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 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 seqSamp)
ContactCenterSim
setSeqSampEachEval
in interface ContactCenterSim
seqSamp
- the new value of the indicator.public int getCompletedSteps()
ContactCenterSim
getCompletedSteps
in interface ContactCenterSim
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 MatrixOfStatProbes<?> getMatrixOfStatProbes(PerformanceMeasureType m)
ContactCenterSim
MatrixOfTallies
object.
For functions of multiple averages, e.g., ratios of averages,
this must return a MatrixOfFunctionOfMultipleMeansTallies
.
getMatrixOfStatProbes
in interface ContactCenterSim
m
- the group of performance measures of interest.
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 getMax(PerformanceMeasureType m)
ContactCenterSim
NoSuchElementException
.
getMax
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 getVariance(PerformanceMeasureType m)
ContactCenterSim
NoSuchElementException
.
getVariance
in interface ContactCenterSim
m
- the queried group of performance measures.
public void newSeeds()
ContactCenterSim
ContactCenterSim.eval()
multiple times to perform
a simulation, the results should be identical for the same
values of parameters. If one requires the simulation to
be performed with new random seeds, the random streams
need to be reset.
This can be done by calling RandomStream.resetNextSubstream()
method on each RandomStream
object associated with the simulator,
or by creating new random streams.
newSeeds
in interface ContactCenterSim
public void resetNextSubstream()
ContactCenterSim
RandomStream.resetNextSubstream()
for all random streams used by the simulator.
resetNextSubstream
in interface ContactCenterSim
public void resetStartStream()
ContactCenterSim
RandomStream.resetStartStream()
for all random streams used by the simulator.
resetStartStream
in interface ContactCenterSim
public void resetStartSubstream()
ContactCenterSim
RandomStream.resetStartSubstream()
for all random streams used by the simulator.
resetStartSubstream
in interface ContactCenterSim
public void setAutoResetStartStream(boolean r)
ContactCenterSim
setAutoResetStartStream
in interface ContactCenterSim
r
- the new value of the indicator.ContactCenterSim.getAutoResetStartStream()
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 ContactCenterEvalResults
public String formatStatisticsLaTeX()
ContactCenterEval
ContactCenterEval.formatStatistics()
,
except the generated report is in LATEX rather than
plain text.
formatStatisticsLaTeX
in interface ContactCenterEval
formatStatisticsLaTeX
in class ContactCenterEvalResults
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 ContactCenterEvalResults
wb
- the workbook to append report to.
public void check()
check
in class ContactCenterEvalResults
public double getConfidenceLevel()
ContactCenterSim
ContactCenterEval.formatStatistics()
.
The initial confidence level is
implementation-specific, and
usually set by a
constructor.
getConfidenceLevel
in interface ContactCenterSim
public void setConfidenceLevel(double level)
ContactCenterSim
ContactCenterEval.formatStatistics()
to level.
setConfidenceLevel
in interface ContactCenterSim
level
- the level of confidence of the intervals.public ContactCenterSimResultsParams createParams()
ContactCenterEvalResults
createParams
in class ContactCenterEvalResults
|
ContactCenters V. 0.9.9. |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |