de.lmu.ifi.dbs.elki.math.statistics.dependence

Class JensenShannonEquiwidthDependenceMeasure

java.lang.Object

de.lmu.ifi.dbs.elki.math.statistics.dependence.AbstractDependenceMeasure

de.lmu.ifi.dbs.elki.math.statistics.dependence.JensenShannonEquiwidthDependenceMeasure

All Implemented Interfaces:

DependenceMeasure

public class JensenShannonEquiwidthDependenceMeasure
extends AbstractDependenceMeasure

Jensen-Shannon Divergence is closely related to mutual information. The output value is normalized, such that an evenly distributed and identical distribution will yield a value of 1. Independent distributions may still yield values close to .25, though. TODO: Offer normalized and non-normalized variants?

Since:

0.7.0

Author:

Erich Schubert

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JensenShannonEquiwidthDependenceMeasure.Parameterizer Parameterization class.

Field Summary

Fields

Modifier and Type	Field and Description
static JensenShannonEquiwidthDependenceMeasure	STATIC Static instance.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JensenShannonEquiwidthDependenceMeasure() Constructor - use STATIC instance.

Method Summary

Modifier and Type	Method and Description
<A,B> double	dependence(NumberArrayAdapter<?,A> adapter1, A data1, NumberArrayAdapter<?,B> adapter2, B data2) Measure the dependence of two variables.

Methods inherited from class de.lmu.ifi.dbs.elki.math.statistics.dependence.AbstractDependenceMeasure

clamp, computeNormalizedRanks, discretize, index, ranks, ranks, size, size, sortedIndex

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface de.lmu.ifi.dbs.elki.math.statistics.dependence.DependenceMeasure

dependence, dependence, dependence

Field Detail

STATIC

public static final JensenShannonEquiwidthDependenceMeasure STATIC

Static instance.

Constructor Detail

JensenShannonEquiwidthDependenceMeasure

protected JensenShannonEquiwidthDependenceMeasure()

Constructor - use STATIC instance.

Method Detail

dependence

public <A,B> double dependence(NumberArrayAdapter<?,A> adapter1,
                               A data1,
                               NumberArrayAdapter<?,B> adapter2,
                               B data2)

Description copied from interface: DependenceMeasure

Measure the dependence of two variables. This is the more flexible API, which allows using different internal data representations.

Type Parameters:

A - First array type

B - Second array type

Parameters:

adapter1 - First data adapter

data1 - First data set

adapter2 - Second data adapter

data2 - Second data set

Returns:

Dependence measure