nl.liacs.timeseries.kernel

Class Binarise

java.lang.Object

nl.liacs.timeseries.kernel.AbstractKernel

nl.liacs.timeseries.kernel.DiscreteKernel

nl.liacs.timeseries.kernel.BasicKernel

nl.liacs.timeseries.kernel.Binarise

public class Binarise
extends BasicKernel

Binarise kernel: not a convolution kernel.

This type of Kernel sets values in the output array to either 0 or 1, based on whether the corresponding values in the input array are above or below a user-defined threshold.

Note: running Binarise(1) on the result of Uniform(n).applyTo() yields the same result as Binarise(n).applyTo().

Author:

Marvin Meeng Last updated 11.07.2012

See Also:

Binarise.TestPolicy

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Binarise.TestPolicy TestPolicy controls the kind of test the Kernel performs on the threshold.

Field Summary

Fields

Modifier and Type	Field and Description
static double	DEFAULT_THRESHOLD
static java.lang.String	GUI_NAME
static boolean	HAS_DELAY
static boolean	HAS_OOBP
static boolean	HAS_WIDTH
static int	NR_EXTRA_FIELDS
static java.lang.String	SHORT_NAME

Fields inherited from class nl.liacs.timeseries.kernel.DiscreteKernel

DEFAULT_OOB_POLICY, DEFAULT_WIDTH

Constructor Summary

Constructors

Constructor and Description
Binarise(int theWidth) Constructs a Binarise Kernel.

Method Summary

Methods

Modifier and Type	Method and Description
double[]	applyTo(double[] theInput) Deprecated.
double[]	applyTo(double[] theInput, int theDelay) Apply the kernel to the specified array, with the specified delay.
java.lang.String	getGuiText() Deprecated.
boolean	getHasDelay() Deprecated.
boolean	getHasOOBP() Deprecated.
boolean	getHasWidth() Deprecated.
int	getNrExtraFields() Deprecated.
java.lang.String	getShortText() Deprecated.
Binarise	setTestPolicy(Binarise.TestPolicy theTestPolicy) Sets the TestPolicy to be used by this Kernel.
Binarise	setThreshold(double theThreshold) Sets the threshold used by this Kernel to determine whether a value is set to either 0 or 1, based on the TestPolicy.
java.lang.String	toString() Returns the String representation of this Kernel.

Methods inherited from class nl.liacs.timeseries.kernel.BasicKernel

getInfo, getKernel, isValidWidth, setOutOfBoundsPolicy, setWidth

Methods inherited from class java.lang.Object

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

Field Detail

GUI_NAME

public static final java.lang.String GUI_NAME

SHORT_NAME

public static final java.lang.String SHORT_NAME

See Also:

Constant Field Values

HAS_WIDTH

public static final boolean HAS_WIDTH

See Also:

Constant Field Values

HAS_OOBP

public static final boolean HAS_OOBP

See Also:

Constant Field Values

HAS_DELAY

public static final boolean HAS_DELAY

See Also:

Constant Field Values

NR_EXTRA_FIELDS

public static final int NR_EXTRA_FIELDS

See Also:

Constant Field Values

DEFAULT_THRESHOLD

public static final double DEFAULT_THRESHOLD

See Also:

Constant Field Values

Constructor Detail

Binarise

public Binarise(int theWidth)

Constructs a Binarise Kernel.

Parameters:

theWidth - The width of the Kernel.

See Also:

setThreshold(double), Binarise.TestPolicy

Method Detail

setThreshold

public Binarise setThreshold(double theThreshold)

Sets the threshold used by this Kernel to determine whether a value is set to either 0 or 1, based on the TestPolicy.

Parameters:

theThreshold - The threshold to use.

Returns:

This Kernel.

See Also:

Binarise.TestPolicy

setTestPolicy

public Binarise setTestPolicy(Binarise.TestPolicy theTestPolicy)

Sets the TestPolicy to be used by this Kernel.

Parameters:

theTestPolicy - The new TestPolicy to use.

Returns:

This Kernel.

See Also:

Binarise.TestPolicy

applyTo

@Deprecated
public double[] applyTo(double[] theInput)

Deprecated.

Description copied from class: BasicKernel

Apply the Kernel to some input array. Values for which it is not possible to apply the whole Kernel are set based on the OutOfBoundsPolicy. Note: this method assumes the Kernel has a positive odd width.

Overrides:

applyTo in class BasicKernel

Parameters:

theInput - The array on which to apply the Kernel.

Returns:

An array of the same size as theInput, containing the result of applying the Kernel to theInput, or an empty array if theInput is null.

See Also:

OutOfBoundsPolicy, BasicKernel.setWidth(int)

applyTo

public double[] applyTo(double[] theInput,
               int theDelay)

Description copied from class: AbstractKernel

Apply the kernel to the specified array, with the specified delay.

The delay may be 0, positive or negative. For a delay of 0 the values in the return array map directly to the input array. For a positive delay of n the values in the input array are 'shifted' n indices to the right. For a negative delay this 'shift' is to the left.

In general, for kernels for which AbstractKernel.getHasWidth() returns true, the application of the kernel to the head and tail of the input array is undefined. This method will fill in the values for which this condition applies by using the OutOfBoundsPolicy set for the kernel.

Overrides:

applyTo in class BasicKernel

Parameters:

theInput - The array to apply the kernel to.

theDelay - The delay to use.

Returns:

A new double[] with the result.

getGuiText

@Deprecated
public java.lang.String getGuiText()

Deprecated.

Description copied from class: AbstractKernel

Returns the GUI friendly text for the kernel.

For most kernels this method returns the same result as a call to kernel.class.getSimpleName(). For some, the returned String will include some white spaces that beak up the various words, such that it forms regular text.

Overrides:

getGuiText in class BasicKernel

Returns:

A GUI friendly String.

getShortText

@Deprecated
public java.lang.String getShortText()

Deprecated.

Description copied from class: AbstractKernel

Returns the short text for the kernel.

Overrides:

getShortText in class BasicKernel

Returns:

A short String indicative of the class name.

getHasWidth

@Deprecated
public boolean getHasWidth()

Deprecated.

Description copied from class: AbstractKernel

Returns whether the kernel has a width.

This is true for a DiscreteKernel, and false for a ContinuousKernel.

Overrides:

getHasWidth in class BasicKernel

Returns:

true iff the kernel has a width, false otherwise.

See Also:

ContinuousKernel, DiscreteKernel

getHasOOBP

@Deprecated
public boolean getHasOOBP()

Deprecated.

Description copied from class: AbstractKernel

Returns whether the kernel has an OutOfBoundsPolicy.

This is true for a DiscreteKernel, and false for a ContinuousKernel.

Overrides:

getHasOOBP in class BasicKernel

Returns:

true iff the kernel has an out of bounds policy, false otherwise.

See Also:

OutOfBoundsPolicy, ContinuousKernel, DiscreteKernel

getHasDelay

@Deprecated
public boolean getHasDelay()

Deprecated.

Description copied from class: AbstractKernel

Returns whether a delay can be set for the kernel.

This is true for almost all kernels, but not for MovingAverage.

Overrides:

getHasDelay in class BasicKernel

Returns:

true iff a delay can be set for the kernel, false otherwise.

getNrExtraFields

@Deprecated
public int getNrExtraFields()

Deprecated.

Description copied from class: AbstractKernel

Returns the number of extra fields for the kernel.

Extra fields hold kernel specific configuration settings, not shared with other kernels.

Overrides:

getNrExtraFields in class BasicKernel

Returns:

The number of extra fields.

toString

public java.lang.String toString()

Returns the String representation of this Kernel. In order the items between the braces represent the: width, OutOfBoundsPolicy, threshold and TestPolicy used for this Kernel.

Overrides:

toString in class BasicKernel

Returns:

The String representation of the Kernel.