oracle.dmt.odm.result
Class LiftResultElement

java.lang.Object
  |
  +--oracle.dmt.odm.MiningObject
        |
        +--oracle.dmt.odm.result.LiftResultElement

All Implemented Interfaces:

java.io.Serializable

public class LiftResultElement

extends MiningObject

An instance of LiftResultElement contains information on the lift result for a specific quantile of data.

Lift is calculated as follows. For a binary classification model, with a designated positive and negative value, test cases are sorted according to how confidently they are predicted to be positive instances (most confidently positive first, most confidently negative last). With regard to that ordering, they are partitioned into quantiles. Then:

• Target Densitity of a quantile is the number of actually positive instances in that quantile divided by the total number of instances in the quantile.
• Lift of a quantile is the ratio of TargetDensity to the target density over all the test data.
• PercentageOfRecordsCumulative for a given quantile is the percentage of all test cases represented by the first n quantiles, starting at the most-confidently-positive end, up to and including the given quantile.
• NumberOfTargetsCumulative for a given quantile is the number of actually positive instances in the first n quantiles (defined as above).
• NumberOfNonTargetsCumulative is the same, but for actually negative instances.
• LiftCumulative for a given quantile is the ratio of the cumulative target density (which is like TargetDensity, but computed over the first n quantiles, defined as above, instead of just the current quantile) to the target density over all the test data.
• Targets Cumulative for a given quantile is the ratio of cumulative positive instances in that quantile and the total number of positive instances of all quantiles. It measures the percentage of positive instances captured "so far".
  This can be calculated for a quantile as follows:
  
  float targetCumulative = liftQuantile*percentageOfRecordsCumulative;

Since:

ODM 9.0.1

See Also:

Serialized Form

Constructor Summary

LiftResultElement()

Method Summary

float	getLiftCumulative() Returns the cumulative lift.
float	getLiftQuantile() Retruns the value of lift for this quantile.
int	getNumberOfNonTargetsCumulative() Returns the cumulative number of nontargets.
int	getNumberOfTargetsCumulative() Returns the cumulative number of targets.
float	getPercentageOfRecordsCumulative() Returns cumulative percentage of records.
float	getPercentageTargetCumulative() Returns the percentage target cumulative
float	getTargetDensity() Returns the target density.
float	getTargetDensityCumulative() Returns the cumulative target density.
java.lang.String	showScientific(float coefficient)
java.lang.String	toString() Returns a formatted string representation of the lift element for the convenience of display.
java.lang.String	toStringSN() Returns a formatted string representation of the lift element in scientific notation for the convenience of display.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

LiftResultElement

public LiftResultElement()

Method Detail

showScientific

public java.lang.String showScientific(float coefficient)

getPercentageOfRecordsCumulative

public float getPercentageOfRecordsCumulative()

Returns cumulative percentage of records.

Returns:

percentage Of records cumulative

getLiftQuantile

public float getLiftQuantile()

Retruns the value of lift for this quantile.

Returns:

lift value

getLiftCumulative

public float getLiftCumulative()

Returns the cumulative lift.

Returns:

lift cumulative

getNumberOfTargetsCumulative

public int getNumberOfTargetsCumulative()

Returns the cumulative number of targets.

Returns:

number of targets cumulative

getNumberOfNonTargetsCumulative

public int getNumberOfNonTargetsCumulative()

Returns the cumulative number of nontargets.

Returns:

number of non targets cumulative

getTargetDensity

public float getTargetDensity()

Returns the target density.

Returns:

target density

getTargetDensityCumulative

public float getTargetDensityCumulative()

Returns the cumulative target density.

Returns:

cumulative target density

getPercentageTargetCumulative

public float getPercentageTargetCumulative()

Returns the percentage target cumulative

Returns:

percentage target cumulative

Since:

10.1.0

toString

public java.lang.String toString()

Returns a formatted string representation of the lift element for the convenience of display.

Overrides:

toString in class java.lang.Object

Returns:

A formatted string of the lift element

toStringSN

public java.lang.String toStringSN()

Returns a formatted string representation of the lift element in scientific notation for the convenience of display.

Returns:

A formatted string of the lift element