de.lmu.ifi.dbs.elki.data.synthetic.bymodel

Class GeneratorSingleCluster

java.lang.Object

de.lmu.ifi.dbs.elki.data.synthetic.bymodel.GeneratorSingleCluster

All Implemented Interfaces:

GeneratorInterface, GeneratorInterfaceDynamic

public class GeneratorSingleCluster
extends java.lang.Object
implements GeneratorInterfaceDynamic

Class to generate a single cluster according to a model as well as getting the density of a given model at that point (to evaluate generated points according to the same model)

Since:

0.2

Author:

Erich Schubert

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.List<Distribution>	axes The distribution generators for each axis
private double[]	clipmax Clipping vectors.
private double[]	clipmin Clipping vectors.
private double	densitycorrection Correction factor for probability computation
private int	dim The dimensionality
private int	discarded Discarded count
private java.lang.String	name Cluster name
private java.util.Random	random Random generator (used for initializing random generators)
private int	retries Retry count
private int	size Number of points in the cluster (~density)
private AffineTransformation	trans The transformation matrix

Constructor Summary

Constructors

Constructor and Description
GeneratorSingleCluster(java.lang.String name, int size, double densitycorrection, java.util.Random random) Generator (without axes)

Method Summary

Modifier and Type	Method and Description
void	addGenerator(Distribution gen) Add a new generator to the cluster.
void	addRotation(int axis1, int axis2, double angle) Apply a rotation to the generator
void	addTranslation(double[] v) Add a translation to the generator
double[]	computeMean() Get the cluster mean vector.
java.util.List<double[]>	generate(int count) Generate the given number of additional points.
double[]	getClipmax() Return a copy of the 'clipping maximum' double[]
double[]	getClipmin() Return a copy of the 'clipping minimum' double[].
double	getDensity(double[] p) Compute density for cluster model at given double[] p-
double	getDensityCorrection() Return density correction factor
int	getDim() Get the cluster dimensionality
int	getDiscarded() Get number of discarded points
Distribution	getDistribution(int i) Get distribution along (generator) axis i.
java.lang.String	getName() Get cluster name.
java.util.Random	getNewRandomGenerator() Create a new random generator (reproducible)
int	getRetries() Return number of remaining retries.
int	getSize() Return the size
AffineTransformation	getTransformation() Get transformation
void	incrementDiscarded() Increase number of discarded points
Model	makeModel() Make a cluster model for this cluster.
void	setClipping(double[] min, double[] max) Set a clipping box. min needs to be smaller than max in each component.
void	setDensityCorrection(double densitycorrection) Set density correction factor.
private boolean	testClipping(double[] p) Test if a point is to be clipped

Methods inherited from class java.lang.Object

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

Field Detail

axes

private java.util.List<Distribution> axes

The distribution generators for each axis

trans

private AffineTransformation trans

The transformation matrix

dim

private int dim

The dimensionality

clipmin

private double[] clipmin

Clipping vectors. Note: currently, either both or none have to be set!

clipmax

private double[] clipmax

Clipping vectors. Note: currently, either both or none have to be set!

densitycorrection

private double densitycorrection

Correction factor for probability computation

size

private int size

Number of points in the cluster (~density)

name

private java.lang.String name

Cluster name

retries

private int retries

Retry count

discarded

private int discarded

Discarded count

random

private java.util.Random random

Random generator (used for initializing random generators)

Constructor Detail

GeneratorSingleCluster

public GeneratorSingleCluster(java.lang.String name,
                              int size,
                              double densitycorrection,
                              java.util.Random random)

Generator (without axes)

Parameters:

name - Cluster name

size - Cluster size

densitycorrection - Density correction factor

random - Random number generator

Method Detail

addGenerator

public void addGenerator(Distribution gen)

Add a new generator to the cluster. No transformations must have been added so far!

Parameters:

gen - Distribution generator

addRotation

public void addRotation(int axis1,
                        int axis2,
                        double angle)

Apply a rotation to the generator

Parameters:

axis1 - First axis (0 <= axis1 < dim)

axis2 - Second axis (0 <= axis2 < dim)

angle - Angle in Radians

addTranslation

public void addTranslation(double[] v)

Add a translation to the generator

Parameters:

v - translation double[]

setClipping

public void setClipping(double[] min,
                        double[] max)

Set a clipping box. min needs to be smaller than max in each component. Note: Clippings are not 'modified' by translation / rotation / transformation operations.

Parameters:

min - Minimum values for clipping

max - Maximum values for clipping

getDim

public int getDim()

Get the cluster dimensionality

Specified by:

getDim in interface GeneratorInterface

Returns:

dimensionality

testClipping

private boolean testClipping(double[] p)

Test if a point is to be clipped

Parameters:

p - point

Returns:

true if the point is to be clipped

generate

public java.util.List<double[]> generate(int count)

Generate the given number of additional points.

Specified by:

generate in interface GeneratorInterface

Parameters:

count - Number of points to generate

Returns:

List of generated points

See Also:

GeneratorInterface.generate(int)

getDensity

public double getDensity(double[] p)

Compute density for cluster model at given double[] p-

Specified by:

getDensity in interface GeneratorInterface

Parameters:

p - vector

Returns:

density

See Also:

GeneratorInterface.getDensity(double[])

getTransformation

public AffineTransformation getTransformation()

Get transformation

Returns:

transformation matrix, may be null.

getClipmin

public double[] getClipmin()

Return a copy of the 'clipping minimum' double[].

Returns:

double[] with lower clipping bounds. May be null.

getClipmax

public double[] getClipmax()

Return a copy of the 'clipping maximum' double[]

Returns:

double[] with upper clipping bounds. May be null.

getSize

public int getSize()

Return the size

Specified by:

getSize in interface GeneratorInterface

Returns:

size of this cluster.

getName

public java.lang.String getName()

Get cluster name.

Specified by:

getName in interface GeneratorInterface

Returns:

name of this cluster.

getDiscarded

public int getDiscarded()

Get number of discarded points

Specified by:

getDiscarded in interface GeneratorInterfaceDynamic

Returns:

number of discarded points

incrementDiscarded

public void incrementDiscarded()

Increase number of discarded points

Specified by:

incrementDiscarded in interface GeneratorInterfaceDynamic

getRetries

public int getRetries()

Return number of remaining retries.

Specified by:

getRetries in interface GeneratorInterfaceDynamic

Returns:

Number of retries left in this cluster.

getDensityCorrection

public double getDensityCorrection()

Return density correction factor

Returns:

density correction factor

setDensityCorrection

public void setDensityCorrection(double densitycorrection)

Set density correction factor.

Parameters:

densitycorrection - new density correction factor.

getNewRandomGenerator

public java.util.Random getNewRandomGenerator()

Create a new random generator (reproducible)

Returns:

new random generator derived from cluster master random.

makeModel

public Model makeModel()

Make a cluster model for this cluster.

Specified by:

makeModel in interface GeneratorInterface

Returns:

Model

getDistribution

public Distribution getDistribution(int i)

Get distribution along (generator) axis i.

Parameters:

i - Generator axis i

Returns:

Distribution

computeMean

public double[] computeMean()

Description copied from interface: GeneratorInterface

Get the cluster mean vector.

Specified by:

computeMean in interface GeneratorInterface

Returns:

Cluster mean, or null.