jsat.datatransform.visualization

Interface VisualizationTransform

All Superinterfaces:

Cloneable, Serializable

All Known Implementing Classes:

Isomap, LargeViz, MDS, TSNE

public interface VisualizationTransform
extends Cloneable, Serializable

Visualization Transform is similar to the DataTransform interface, except it can not necessarily be applied to new datapoints. Classes implementing this interface are intended to create 2D or 3D versions of a dataset that can be visualized easily.

By default, all implementations will create a 2D projection of the data if supported.

Author:

Edward Raff

Method Summary

Modifier and Type	Method and Description
int	getTargetDimension()
boolean	setTargetDimension(int target) Sets the target dimension to embed new dataset to.
<Type extends DataSet> Type	transform(DataSet<Type> d) Transforms the given data set, returning a dataset of the same type.
<Type extends DataSet> Type	transform(DataSet<Type> d, ExecutorService ex) Transforms the given data set, returning a dataset of the same type.

Method Detail

getTargetDimension

int getTargetDimension()

Returns:

the number of dimensions that a dataset will be embedded down to

setTargetDimension

boolean setTargetDimension(int target)

Sets the target dimension to embed new dataset to. Many visualization methods may only support a target of 2 or 3 dimensions, or only one of those options. For that reason a boolean value will be returned indicating if the target size was acceptable. If not, no change to the object will occur.

Parameters:

target - the new target dimension size when transform(jsat.DataSet) is called.

Returns:

true if this transform supports that dimension and it was set, false if the target dimension is unsupported and the previous value will be used instead.

transform

<Type extends DataSet> Type transform(DataSet<Type> d)

Transforms the given data set, returning a dataset of the same type.

Type Parameters:

Type - the dataset type

Parameters:

d - the data set to transform

Returns:

the lower dimension dataset for visualization.

transform

<Type extends DataSet> Type transform(DataSet<Type> d,
                                      ExecutorService ex)

Transforms the given data set, returning a dataset of the same type.

Type Parameters:

Type - the dataset type

Parameters:

d - the data set to transform

ex - the source of threads for parallel computation

Returns:

the lower dimension dataset for visualization.