averagingresultproducer.html

< 数据挖掘--实用机器学习技术及java实现> 一书结合数据挖掘和机器学习的知识,作者陈述了自动挖掘模式的基础理论,并且以java语言实现了具有代表性的各类数据挖掘方法.例如:class

<!-- ============ FIELD DETAIL =========== -->

<A NAME="field_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Field Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="m_Instances"><!-- --></A><H3>
m_Instances</H3>
<PRE>
protected <A HREF="../../weka/core/Instances.html">Instances</A> <B>m_Instances</B></PRE>
<DL>
<DD>The dataset of interest</DL>
<HR>

<A NAME="m_ResultListener"><!-- --></A><H3>
m_ResultListener</H3>
<PRE>
protected <A HREF="../../weka/experiment/ResultListener.html">ResultListener</A> <B>m_ResultListener</B></PRE>
<DL>
<DD>The ResultListener to send results to</DL>
<HR>

<A NAME="m_ResultProducer"><!-- --></A><H3>
m_ResultProducer</H3>
<PRE>
protected <A HREF="../../weka/experiment/ResultProducer.html">ResultProducer</A> <B>m_ResultProducer</B></PRE>
<DL>
<DD>The ResultProducer used to generate results</DL>
<HR>

<A NAME="m_AdditionalMeasures"><!-- --></A><H3>
m_AdditionalMeasures</H3>
<PRE>
protected java.lang.String[] <B>m_AdditionalMeasures</B></PRE>
<DL>
<DD>The names of any additional measures to look for in SplitEvaluators</DL>
<HR>

<A NAME="m_ExpectedResultsPerAverage"><!-- --></A><H3>
m_ExpectedResultsPerAverage</H3>
<PRE>
protected int <B>m_ExpectedResultsPerAverage</B></PRE>
<DL>
<DD>The number of results expected to average over for each run</DL>
<HR>

<A NAME="m_CalculateStdDevs"><!-- --></A><H3>
m_CalculateStdDevs</H3>
<PRE>
protected boolean <B>m_CalculateStdDevs</B></PRE>
<DL>
<DD>True if standard deviation fields should be produced</DL>
<HR>

<A NAME="m_CountFieldName"><!-- --></A><H3>
m_CountFieldName</H3>
<PRE>
protected java.lang.String <B>m_CountFieldName</B></PRE>
<DL>
<DD>The name of the field that will contain the number of results
 averaged over.</DL>
<HR>

<A NAME="m_KeyFieldName"><!-- --></A><H3>
m_KeyFieldName</H3>
<PRE>
protected java.lang.String <B>m_KeyFieldName</B></PRE>
<DL>
<DD>The name of the key field to average over</DL>
<HR>

<A NAME="m_KeyIndex"><!-- --></A><H3>
m_KeyIndex</H3>
<PRE>
protected int <B>m_KeyIndex</B></PRE>
<DL>
<DD>The index of the field to average over in the resultproducers key</DL>
<HR>

<A NAME="m_Keys"><!-- --></A><H3>
m_Keys</H3>
<PRE>
protected <A HREF="../../weka/core/FastVector.html">FastVector</A> <B>m_Keys</B></PRE>
<DL>
<DD>Collects the keys from a single run</DL>
<HR>

<A NAME="m_Results"><!-- --></A><H3>
m_Results</H3>
<PRE>
protected <A HREF="../../weka/core/FastVector.html">FastVector</A> <B>m_Results</B></PRE>
<DL>
<DD>Collects the results from a single run</DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="AveragingResultProducer()"><!-- --></A><H3>
AveragingResultProducer</H3>
<PRE>
public <B>AveragingResultProducer</B>()</PRE>
<DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="globalInfo()"><!-- --></A><H3>
globalInfo</H3>
<PRE>
public java.lang.String <B>globalInfo</B>()</PRE>
<DL>
<DD>Returns a string describing this result producer<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>a description of the result producer suitable for
 displaying in the explorer/experimenter gui</DL>
</DD>
</DL>
<HR>

<A NAME="findKeyIndex()"><!-- --></A><H3>
findKeyIndex</H3>
<PRE>
protected int <B>findKeyIndex</B>()</PRE>
<DL>
<DD>Scans through the key field names of the result producer to find
 the index of the key field to average over. Sets the value of
 m_KeyIndex to the index, or -1 if no matching key field was found.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the index of the key field to average over</DL>
</DD>
</DL>
<HR>

<A NAME="determineColumnConstraints(weka.experiment.ResultProducer)"><!-- --></A><H3>
determineColumnConstraints</H3>
<PRE>
public java.lang.String[] <B>determineColumnConstraints</B>(<A HREF="../../weka/experiment/ResultProducer.html">ResultProducer</A>&nbsp;rp)
                                              throws java.lang.Exception</PRE>
<DL>
<DD>Determines if there are any constraints (imposed by the
 destination) on the result columns to be produced by
 resultProducers. Null should be returned if there are NO
 constraints, otherwise a list of column names should be
 returned as an array of Strings.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../weka/experiment/ResultListener.html#determineColumnConstraints(weka.experiment.ResultProducer)">determineColumnConstraints</A></CODE> in interface <CODE><A HREF="../../weka/experiment/ResultListener.html">ResultListener</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>rp</CODE> - the ResultProducer to which the constraints will apply<DT><B>Returns:</B><DD>an array of column names to which resutltProducer's
 results will be restricted.<DT><B>Throws:</B><DD><CODE>java.lang.Exception</CODE> - if constraints can't be determined</DL>
</DD>
</DL>
<HR>

<A NAME="determineTemplate(int)"><!-- --></A><H3>
determineTemplate</H3>
<PRE>
protected java.lang.Object[] <B>determineTemplate</B>(int&nbsp;run)
                                        throws java.lang.Exception</PRE>
<DL>
<DD>Simulates a run to collect the keys the sub-resultproducer could
 generate. Does some checking on the keys and determines the 
 template key.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>run</CODE> - the run number<DT><B>Returns:</B><DD>a template key (null for the field being averaged)<DT><B>Throws:</B><DD><CODE>java.lang.Exception</CODE> - if an error occurs</DL>
</DD>
</DL>
<HR>

<A NAME="doRunKeys(int)"><!-- --></A><H3>
doRunKeys</H3>
<PRE>
public void <B>doRunKeys</B>(int&nbsp;run)
               throws java.lang.Exception</PRE>
<DL>
<DD>Gets the keys for a specified run number. Different run
 numbers correspond to different randomizations of the data. Keys
 produced should be sent to the current ResultListener<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../weka/experiment/ResultProducer.html#doRunKeys(int)">doRunKeys</A></CODE> in interface <CODE><A HREF="../../weka/experiment/ResultProducer.html">ResultProducer</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>run</CODE> - the run number to get keys for.<DT><B>Throws:</B><DD><CODE>java.lang.Exception</CODE> - if a problem occurs while getting the keys</DL>
</DD>
</DL>
<HR>

<A NAME="doRun(int)"><!-- --></A><H3>
doRun</H3>
<PRE>
public void <B>doRun</B>(int&nbsp;run)
           throws java.lang.Exception</PRE>
<DL>
<DD>Gets the results for a specified run number. Different run
 numbers correspond to different randomizations of the data. Results
 produced should be sent to the current ResultListener<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../weka/experiment/ResultProducer.html#doRun(int)">doRun</A></CODE> in interface <CODE><A HREF="../../weka/experiment/ResultProducer.html">ResultProducer</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>run</CODE> - the run number to get results for.<DT><B>Throws:</B><DD><CODE>java.lang.Exception</CODE> - if a problem occurs while getting the results</DL>
</DD>
</DL>
<HR>

<A NAME="matchesTemplate(java.lang.Object[], java.lang.Object[])"><!-- --></A><H3>
matchesTemplate</H3>
<PRE>
protected boolean <B>matchesTemplate</B>(java.lang.Object[]&nbsp;template,
                                  java.lang.Object[]&nbsp;test)</PRE>
<DL>
<DD>Compares a key to a template to see whether they match. Null
 fields in the template are ignored in the matching.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>template</CODE> - the template to match against<DD><CODE>test</CODE> - the key to test<DT><B>Returns:</B><DD>true if the test key matches the template on all non-null template
 fields</DL>
</DD>
</DL>
<HR>

<A NAME="doAverageResult(java.lang.Object[])"><!-- --></A><H3>
doAverageResult</H3>
<PRE>
protected void <B>doAverageResult</B>(java.lang.Object[]&nbsp;template)
                        throws java.lang.Exception</PRE>
<DL>
<DD>Asks the resultlistener whether an average result is required, and
 if so, calculates it.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>template</CODE> - the template to match keys against when calculating the
 average<DT><B>Throws:</B><DD><CODE>java.lang.Exception</CODE> - if an error occurs</DL>
</DD>
</DL>
<HR>

<A NAME="checkForDuplicateKeys(java.lang.Object[])"><!-- --></A><H3>
checkForDuplicateKeys</H3>
<PRE>
protected void <B>checkForDuplicateKeys</B>(java.lang.Object[]&nbsp;template)
                              throws java.lang.Exception</PRE>
<DL>
<DD>Checks whether any duplicate results (with respect to a key template)
 were received.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>template</CODE> - the template key.<DT><B>Throws:</B><DD><CODE>java.lang.Exception</CODE> - if duplicate results are detected</DL>
</DD>
</DL>
<HR>

<A NAME="checkForMultipleDifferences()"><!-- --></A><H3>
checkForMultipleDifferences</H3>
<PRE>
protected void <B>checkForMultipleDifferences</B>()
                                    throws java.lang.Exception</PRE>
<DL>
<DD>Checks that the keys for a run only differ in one key field. If they
 differ in more than one field, a more sophisticated averager will submit
 multiple results - for now an exception is thrown. Currently assumes that
 the most differences will be shown between the first and last