de.lmu.ifi.dbs.elki.datasource

Class GeneratorXMLDatabaseConnection

java.lang.Object

de.lmu.ifi.dbs.elki.datasource.AbstractDatabaseConnection

de.lmu.ifi.dbs.elki.datasource.GeneratorXMLDatabaseConnection

All Implemented Interfaces:

DatabaseConnection

public class GeneratorXMLDatabaseConnection
extends AbstractDatabaseConnection

Data source from an XML specification. This data source will generate random (or pseudo-random, fixed seeds are supported) data sets that satisfy a given specification file.

Author:

Erich Schubert

Nested Class Summary

Nested Classes

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

Field Summary

Fields

Modifier and Type	Field and Description
static String	ATTR_ANGLE Rotation angle
static String	ATTR_AXIS1 First axis for rotation plane
static String	ATTR_AXIS2 Second axis for rotation plane
static String	ATTR_DENSITY Density correction factor
static String	ATTR_K Gamma k
static String	ATTR_MAX Maximum value
static String	ATTR_MEAN Mean
static String	ATTR_MIN Minimum value
static String	ATTR_NAME Cluster nane
static String	ATTR_SEED Random seed
static String	ATTR_SIZE Cluster size
static String	ATTR_STDDEV Standard deviation
static String	ATTR_TEST Attribute to control model testing
static String	ATTR_THETA Gamma theta
static String	ATTR_VECTOR Vector
private Random	clusterRandom Random generator used for initializing cluster generators.
static OptionID	CONFIGFILE_ID Parameter to give the configuration file
static String	GENERATOR_SCHEMA_FILE File name of the generators XML Schema file.
private static Logging	LOG Logger
static OptionID	RANDOMSEED_ID Parameter to give the configuration file
static OptionID	SIZE_SCALE_ID Parameter to give the configuration file
(package private) double	sizescale Parameter for scaling the cluster sizes.
(package private) File	specfile The configuration file.
static String	TAG_CLIP Clipping
static String	TAG_CLUSTER Cluster tag
static String	TAG_DATASET Dataset tag
static String	TAG_GAMMA Gamma distribution
static String	TAG_HALTON Halton pseudo uniform distribution.
static String	TAG_NORMAL Normal distribution
static String	TAG_POINT Point in static cluster
static String	TAG_ROTATE Rotation
static String	TAG_STATIC Static cluster
static String	TAG_TRANSLATE Translation
static String	TAG_UNIFORM Uniform distribution
private Boolean	testAgainstModel Set testAgainstModel flag
static Pattern	WHITESPACE_PATTERN A pattern defining whitespace.

Fields inherited from class de.lmu.ifi.dbs.elki.datasource.AbstractDatabaseConnection

filters, LABEL_CONCATENATION

Constructor Summary

Constructors

Constructor and Description
GeneratorXMLDatabaseConnection(List<ObjectFilter> filters, File specfile, double sizescale, Random clusterRandom) Constructor.

Method Summary

Modifier and Type	Method and Description
protected Logging	getLogger() Get the logger for this database connection.
MultipleObjectsBundle	loadData() Returns the initial data for a database.
private GeneratorMain	loadXMLSpecification() Load the XML configuration file.
private Vector	parseVector(String s) Parse a string into a vector.
private void	processElementClipping(GeneratorSingleCluster cluster, Node cur) Process a 'clipping' Element in the XML stream.
private void	processElementCluster(GeneratorMain gen, Node cur) Process a 'cluster' Element in the XML stream.
private void	processElementDataset(GeneratorMain gen, Node cur) Process a 'dataset' Element in the XML stream.
private void	processElementGamma(GeneratorSingleCluster cluster, Node cur) Process a 'gamma' Element in the XML stream.
private void	processElementHalton(GeneratorSingleCluster cluster, Node cur) Process a 'halton' Element in the XML stream.
private void	processElementNormal(GeneratorSingleCluster cluster, Node cur) Process a 'normal' Element in the XML stream.
private void	processElementPoint(List<Vector> points, Node cur) Parse a 'point' element (point vector for a static cluster)
private void	processElementRotate(GeneratorSingleCluster cluster, Node cur) Process a 'rotate' Element in the XML stream.
private void	processElementStatic(GeneratorMain gen, Node cur) Process a 'static' cluster Element in the XML stream.
private void	processElementTranslate(GeneratorSingleCluster cluster, Node cur) Process a 'translate' Element in the XML stream.
private void	processElementUniform(GeneratorSingleCluster cluster, Node cur) Process a 'uniform' Element in the XML stream.

Methods inherited from class de.lmu.ifi.dbs.elki.datasource.AbstractDatabaseConnection

invokeBundleFilters, invokeStreamFilters

Methods inherited from class java.lang.Object

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

Field Detail

TAG_DATASET

public static final String TAG_DATASET

Dataset tag

See Also:

Constant Field Values

TAG_CLUSTER

public static final String TAG_CLUSTER

Cluster tag

See Also:

Constant Field Values

TAG_UNIFORM

public static final String TAG_UNIFORM

Uniform distribution

See Also:

Constant Field Values

TAG_NORMAL

public static final String TAG_NORMAL

Normal distribution

See Also:

Constant Field Values

TAG_GAMMA

public static final String TAG_GAMMA

Gamma distribution

See Also:

Constant Field Values

TAG_HALTON

public static final String TAG_HALTON

Halton pseudo uniform distribution.

See Also:

Constant Field Values

TAG_ROTATE

public static final String TAG_ROTATE

Rotation

See Also:

Constant Field Values

TAG_TRANSLATE

public static final String TAG_TRANSLATE

Translation

See Also:

Constant Field Values

TAG_CLIP

public static final String TAG_CLIP

Clipping

See Also:

Constant Field Values

TAG_STATIC

public static final String TAG_STATIC

Static cluster

See Also:

Constant Field Values

TAG_POINT

public static final String TAG_POINT

Point in static cluster

See Also:

Constant Field Values

ATTR_TEST

public static final String ATTR_TEST

Attribute to control model testing

See Also:

Constant Field Values

ATTR_SEED

public static final String ATTR_SEED

Random seed

See Also:

Constant Field Values

ATTR_DENSITY

public static final String ATTR_DENSITY

Density correction factor

See Also:

Constant Field Values

ATTR_NAME

public static final String ATTR_NAME

Cluster nane

See Also:

Constant Field Values

ATTR_SIZE

public static final String ATTR_SIZE

Cluster size

See Also:

Constant Field Values

ATTR_MIN

public static final String ATTR_MIN

Minimum value

See Also:

Constant Field Values

ATTR_MAX

public static final String ATTR_MAX

Maximum value

See Also:

Constant Field Values

ATTR_MEAN

public static final String ATTR_MEAN

Mean

See Also:

Constant Field Values

ATTR_STDDEV

public static final String ATTR_STDDEV

Standard deviation

See Also:

Constant Field Values

ATTR_K

public static final String ATTR_K

Gamma k

See Also:

Constant Field Values

ATTR_THETA

public static final String ATTR_THETA

Gamma theta

See Also:

Constant Field Values

ATTR_VECTOR

public static final String ATTR_VECTOR

Vector

See Also:

Constant Field Values

ATTR_AXIS1

public static final String ATTR_AXIS1

First axis for rotation plane

See Also:

Constant Field Values

ATTR_AXIS2

public static final String ATTR_AXIS2

Second axis for rotation plane

See Also:

Constant Field Values

ATTR_ANGLE

public static final String ATTR_ANGLE

Rotation angle

See Also:

Constant Field Values

LOG

private static final Logging LOG

Logger

WHITESPACE_PATTERN

public static final Pattern WHITESPACE_PATTERN

A pattern defining whitespace.

CONFIGFILE_ID

public static final OptionID CONFIGFILE_ID

Parameter to give the configuration file

RANDOMSEED_ID

public static final OptionID RANDOMSEED_ID

Parameter to give the configuration file

SIZE_SCALE_ID

public static final OptionID SIZE_SCALE_ID

Parameter to give the configuration file

GENERATOR_SCHEMA_FILE

public static final String GENERATOR_SCHEMA_FILE

File name of the generators XML Schema file.

specfile

File specfile

The configuration file.

sizescale

double sizescale

Parameter for scaling the cluster sizes.

clusterRandom

private Random clusterRandom

Random generator used for initializing cluster generators.

testAgainstModel

private Boolean testAgainstModel

Set testAgainstModel flag

Constructor Detail

GeneratorXMLDatabaseConnection

public GeneratorXMLDatabaseConnection(List<ObjectFilter> filters,
                                      File specfile,
                                      double sizescale,
                                      Random clusterRandom)

Constructor.

Parameters:

filters - Filters.

specfile - Specification file

sizescale - Size scaling

clusterRandom - Random number generator

Method Detail

loadData

public MultipleObjectsBundle loadData()

Description copied from interface: DatabaseConnection

Returns the initial data for a database.

Returns:

a database object bundle

loadXMLSpecification

private GeneratorMain loadXMLSpecification()
                                    throws UnableToComplyException

Load the XML configuration file.

Returns:

Generator

Throws:

UnableToComplyException

processElementDataset

private void processElementDataset(GeneratorMain gen,
                                   Node cur)
                            throws UnableToComplyException

Process a 'dataset' Element in the XML stream.

Parameters:

gen - Generator

cur - Current document nod

Throws:

UnableToComplyException

processElementCluster

private void processElementCluster(GeneratorMain gen,
                                   Node cur)
                            throws UnableToComplyException

Process a 'cluster' Element in the XML stream.

Parameters:

gen - Generator

cur - Current document nod

Throws:

UnableToComplyException

processElementUniform

private void processElementUniform(GeneratorSingleCluster cluster,
                                   Node cur)
                            throws UnableToComplyException

Process a 'uniform' Element in the XML stream.

Parameters:

cluster -

cur - Current document nod

Throws:

UnableToComplyException

processElementNormal

private void processElementNormal(GeneratorSingleCluster cluster,
                                  Node cur)
                           throws UnableToComplyException

Process a 'normal' Element in the XML stream.

Parameters:

cluster -

cur - Current document nod

Throws:

UnableToComplyException

processElementGamma

private void processElementGamma(GeneratorSingleCluster cluster,
                                 Node cur)
                          throws UnableToComplyException

Process a 'gamma' Element in the XML stream.

Parameters:

cluster -

cur - Current document nod

Throws:

UnableToComplyException

processElementHalton

private void processElementHalton(GeneratorSingleCluster cluster,
                                  Node cur)
                           throws UnableToComplyException

Process a 'halton' Element in the XML stream.

Parameters:

cluster -

cur - Current document nod

Throws:

UnableToComplyException

processElementRotate

private void processElementRotate(GeneratorSingleCluster cluster,
                                  Node cur)
                           throws UnableToComplyException

Process a 'rotate' Element in the XML stream.

Parameters:

cluster -

cur - Current document nod

Throws:

UnableToComplyException

processElementTranslate

private void processElementTranslate(GeneratorSingleCluster cluster,
                                     Node cur)
                              throws UnableToComplyException

Process a 'translate' Element in the XML stream.

Parameters:

cluster -

cur - Current document nod

Throws:

UnableToComplyException

processElementClipping

private void processElementClipping(GeneratorSingleCluster cluster,
                                    Node cur)
                             throws UnableToComplyException

Process a 'clipping' Element in the XML stream.

Parameters:

cluster -

cur - Current document nod

Throws:

UnableToComplyException

processElementStatic

private void processElementStatic(GeneratorMain gen,
                                  Node cur)
                           throws UnableToComplyException

Process a 'static' cluster Element in the XML stream.

Parameters:

gen - Generator

cur - Current document nod

Throws:

UnableToComplyException

processElementPoint

private void processElementPoint(List<Vector> points,
                                 Node cur)
                          throws UnableToComplyException

Parse a 'point' element (point vector for a static cluster)

Parameters:

points - current list of points (to append to)

cur - Current document nod

Throws:

UnableToComplyException

parseVector

private Vector parseVector(String s)
                    throws UnableToComplyException

Parse a string into a vector. TODO: move this into utility package?

Parameters:

s - String to parse

Returns:

Vector

Throws:

UnableToComplyException

getLogger

protected Logging getLogger()

Description copied from class: AbstractDatabaseConnection

Get the logger for this database connection.

Specified by:

getLogger in class AbstractDatabaseConnection

Returns:

Logger