weightedperformancemeasures.html

来自「数据挖掘方面最新软件」· HTML 代码 · 共 631 行 · 第 1/2 页

<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TH>
</TR>
</TABLE>

<A NAME="WeightedPerformanceMeasures(com.rapidminer.example.ExampleSet)"><!-- --></A><H3>
WeightedPerformanceMeasures</H3>
<PRE>
public <B>WeightedPerformanceMeasures</B>(<A HREF="../../../../../com/rapidminer/example/ExampleSet.html" title="interface in com.rapidminer.example">ExampleSet</A>&nbsp;exampleSet)
                            throws <A HREF="../../../../../com/rapidminer/operator/OperatorException.html" title="class in com.rapidminer.operator">OperatorException</A></PRE>
<DL>
<DD>Constructor. Reads an example set, calculates its weighted performance
 values and caches them internally for later requests.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>exampleSet</CODE> - the <code>ExampleSet</code> this object shall hold the
            performance measures for
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../com/rapidminer/operator/OperatorException.html" title="class in com.rapidminer.operator">OperatorException</A></CODE></DL>
</DL>

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

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

<A NAME="getCoveredExamplesNumForPred(int)"><!-- --></A><H3>
getCoveredExamplesNumForPred</H3>
<PRE>
public int[] <B>getCoveredExamplesNumForPred</B>(int&nbsp;prediction)</PRE>
<DL>
<DD>Method to query for the unweighted absolute number of covered examples of
 each class, given a specific prediction
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>prediction</CODE> - the value predicted by the model (internal index number)
<DT><B>Returns:</B><DD>an <code>int[]</code> array with the number of examples of
         class <code>i</code> (internal index number) stored at index
         <code>i</code>.</DL>
</DD>
</DL>
<HR>

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

<DT><B>Returns:</B><DD>the number of classes, namely different values of this object's
         example set's label attribute</DL>
</DD>
</DL>
<HR>

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

<DT><B>Returns:</B><DD>number of predictions or nominal classes predicted by the
         embedded learner. Not necessarily the same as the number of class
         labels.</DL>
</DD>
</DL>
<HR>

<A NAME="getProbability(int, int)"><!-- --></A><H3>
getProbability</H3>
<PRE>
public double <B>getProbability</B>(int&nbsp;label,
                             int&nbsp;prediction)</PRE>
<DL>
<DD>Method to query for the probability of one of the prediction/label
 subsets
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>label</CODE> - the (correct) class label of the example as it comes from the
            internal index<DD><CODE>prediction</CODE> - the boolean value predicted by the model (premise) (internal
            index number)
<DT><B>Returns:</B><DD>the joint probability of label and prediction</DL>
</DD>
</DL>
<HR>

<A NAME="getProbabilityLabel(int)"><!-- --></A><H3>
getProbabilityLabel</H3>
<PRE>
public double <B>getProbabilityLabel</B>(int&nbsp;label)</PRE>
<DL>
<DD>Method to query for the &quot;prior&quot; probability of one of the
 labels.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>label</CODE> - the nominal class label
<DT><B>Returns:</B><DD>the probability of seeing an example with this label</DL>
</DD>
</DL>
<HR>

<A NAME="getProbabilityPrediction(int)"><!-- --></A><H3>
getProbabilityPrediction</H3>
<PRE>
public double <B>getProbabilityPrediction</B>(int&nbsp;premise)</PRE>
<DL>
<DD>Method to query for the &quot;prior&quot; probability of one of the
 predictions.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>premise</CODE> - the prediction of a model
<DT><B>Returns:</B><DD>the probability of drawing an example so that the model makes
         this prediction</DL>
</DD>
</DL>
<HR>

<A NAME="getLift(int, int)"><!-- --></A><H3>
getLift</H3>
<PRE>
public double <B>getLift</B>(int&nbsp;label,
                      int&nbsp;prediction)</PRE>
<DL>
<DD>The lift of the rule specified by the nominal variable's indices.
 <code>RULE_DOES_NOT_APPLY</code> is returned to indicate that no such
 example has ever been observed, <code>Double.POSITIVE_INFINITY</code>
 is returned if the class membership can deterministically be concluded
 from the prediction.
 
 Important: In the multi-class case some of the classes might not be
 observed at all when a specific rule applies, but still the rule does not
 necessarily have a deterministic part. In this case the remaining number
 of classes is considered to be the complete set of classes when
 calculating the default values and lifts! This does not affect the
 prediction of the most likely class label, because the classes not
 observed have a probability of one, the other estimates increase
 proportionally. However, to calculate probabilities it is necessary to
 normalize the estimates in the class <code>BayBoostModel</code>.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>label</CODE> - the true label<DD><CODE>prediction</CODE> - the predicted label
<DT><B>Returns:</B><DD>the LIFT, which is a value >= 0, positive infinity if all
         examples with this prediction belong to that class (deterministic
         rule), or <code>RULE_DOES_NOT_APPLY</code> if no prediction can
         be made.</DL>
</DD>
</DL>
<HR>

<A NAME="getPnRatios(int)"><!-- --></A><H3>
getPnRatios</H3>
<PRE>
public double[] <B>getPnRatios</B>(int&nbsp;prediction)</PRE>
<DL>
<DD>The factor to be applied (pn-ratio) for each label if the model yields
 the specific prediction.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>prediction</CODE> - the predicted class
<DT><B>Returns:</B><DD>a <code>double[]</code> array containing one factor for each
         class. The result should either consist of well defined 
         lifts >= 0, or all fields should mutually contain the constant
         <code>RULE_DOES_NOT_APPLY</code>.</DL>
</DD>
</DL>
<HR>

<A NAME="createLiftRatioMatrix()"><!-- --></A><H3>
createLiftRatioMatrix</H3>
<PRE>
public double[][] <B>createLiftRatioMatrix</B>()</PRE>
<DL>
<DD><DL>

<DT><B>Returns:</B><DD>a matrix with one pn-factor per prediction/label combination, or
         the priors of predictions for the case of soft base classifiers.</DL>
</DD>
</DL>
<HR>

<A NAME="getLabelPriors()"><!-- --></A><H3>
getLabelPriors</H3>
<PRE>
public double[] <B>getLabelPriors</B>()</PRE>
<DL>
<DD><DL>

<DT><B>Returns:</B><DD>a <code>double[]</code> with the prior probabilities of all
         class labels.</DL>
</DD>
</DL>
<HR>

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

<DT><B>Returns:</B><DD>the number of classes with strictly positive weight</DL>
</DD>
</DL>
<HR>

<A NAME="getContingencyMatrix()"><!-- --></A><H3>
getContingencyMatrix</H3>
<PRE>
public <A HREF="../../../../../com/rapidminer/operator/learner/meta/ContingencyMatrix.html" title="class in com.rapidminer.operator.learner.meta">ContingencyMatrix</A> <B>getContingencyMatrix</B>()</PRE>
<DL>
<DD>converts the deprecated representation into the new form
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="reweightExamples(com.rapidminer.example.ExampleSet, com.rapidminer.operator.learner.meta.ContingencyMatrix, boolean)"><!-- --></A><H3>
reweightExamples</H3>
<PRE>
public static double <B>reweightExamples</B>(<A HREF="../../../../../com/rapidminer/example/ExampleSet.html" title="interface in com.rapidminer.example">ExampleSet</A>&nbsp;exampleSet,
                                      <A HREF="../../../../../com/rapidminer/operator/learner/meta/ContingencyMatrix.html" title="class in com.rapidminer.operator.learner.meta">ContingencyMatrix</A>&nbsp;cm,
                                      boolean&nbsp;allowMarginalSkews)
                               throws <A HREF="../../../../../com/rapidminer/operator/OperatorException.html" title="class in com.rapidminer.operator">OperatorException</A></PRE>
<DL>
<DD>Helper method of the <code>BayesianBoosting</code> operator
 
 This method reweights the example set with respect to the
 <code>WeightedPerformanceMeasures</code> object. Please note that the
 weights will not be reset at any time, because they continuously change
 from one iteration to the next. This method does not change the priors of
 the classes.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>exampleSet</CODE> - <code>ExampleSet</code> to be reweighted<DD><CODE>cm</CODE> - the <code>ContingencyMatrix</code> as e.g. returned by
            <code>WeightedPerformanceMeasures</code><DD><CODE>allowMarginalSkews</CODE> - indicates whether the weight of covered and uncovered subsets
            are allowed to change.
<DT><B>Returns:</B><DD>the total weight
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../com/rapidminer/operator/OperatorException.html" title="class in com.rapidminer.operator">OperatorException</A></CODE></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/WeightedPerformanceMeasures.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<a href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=114160&amp;type=2" width="125" height="37" border="0" alt="SourceForge.net Logo" /></a></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../../com/rapidminer/operator/learner/meta/Vote.html" title="class in com.rapidminer.operator.learner.meta"><B>PREV CLASS</B></A>&nbsp;
&nbsp;NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../../../index.html?com/rapidminer/operator/learner/meta/WeightedPerformanceMeasures.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="WeightedPerformanceMeasures.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<i>Copyright &#169; 2001-2008 by <a href="http://rapid-i.com" target="_blank">Rapid-I</a></i>
</BODY>
</HTML>