moa.streams.generators.multilabel

Class MetaMultilabelGenerator

java.lang.Object

moa.AbstractMOAObject

moa.options.AbstractOptionHandler

moa.streams.generators.multilabel.MetaMultilabelGenerator

All Implemented Interfaces:

Serializable, MOAObject, OptionHandler, InstanceStream

public class MetaMultilabelGenerator
extends AbstractOptionHandler
implements InstanceStream

Stream generator for multilabel data.

Version:

$Revision: 7 $

Author:

Jesse Read ((jesse@tsc.uc3m.es))

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
ClassOption	binaryGeneratorOption
protected double[][]	Conditional
FloatOption	labelCardinalityOption
FloatOption	labelCardinalityRatioOption
FloatOption	labelCardinalityVarOption
FloatOption	labelDependencyChangeRatioOption
protected int	m_A
protected InstanceStream	m_BinaryGenerator
protected int	m_L
protected Random	m_MetaRandom
protected MultilabelInstancesHeader	m_MultilabelInstancesHeader
protected HashSet[]	m_TopCombinations
IntOption	metaRandomSeedOption
protected weka.core.Instances	multilabelStreamTemplate
IntOption	numLabelsOption
protected double[]	priors
protected double[]	priors_norm
IntOption	skewOption

Fields inherited from class moa.options.AbstractOptionHandler

classOptionNamesToPreparedObjects, options

Constructor Summary

Constructors

Constructor and Description
MetaMultilabelGenerator()

Method Summary

Methods

Modifier and Type	Method and Description
long	estimatedRemainingInstances() Gets the estimated number of remaining instances in this stream
protected double[][]	generateConditional(double[] P, boolean[][] M) GenerateConditional.
protected MultilabelInstancesHeader	generateMultilabelHeader(weka.core.Instances si) GenerateMultilabelHeader.
void	getDescription(StringBuilder sb, int indent) Returns a string representation of this object.
InstancesHeader	getHeader() Gets the header of this stream.
String	getPurposeString() Gets the purpose of this object
boolean	hasMoreInstances() Gets whether this stream has more instances to output.
boolean	isRestartable() Gets whether this stream can restart.
static void	main(String[] args)
protected boolean[][]	modifyDependencyMatrix(boolean[][] M, double u, Random r) ModifyDependencyMatrix.
protected double[]	modifyPriorVector(double[] P, double u, Random r, boolean skew) ModifyPriorVector.
weka.core.Instance	nextInstance() GenerateML.
void	prepareForUseImpl(TaskMonitor monitor, ObjectRepository repository) This method describes the implementation of how to prepare this object for use.
void	restart() Restarts this stream.

Methods inherited from class moa.options.AbstractOptionHandler

copy, discoverOptionsViaReflection, getCLICreationString, getOptions, getPreparedClassOption, getPreparedClassOption, prepareClassOptions, prepareForUse, prepareForUse

Methods inherited from class moa.AbstractMOAObject

copy, measureByteSize, measureByteSize, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface moa.MOAObject

copy, measureByteSize

Field Detail

binaryGeneratorOption

public ClassOption binaryGeneratorOption

metaRandomSeedOption

public IntOption metaRandomSeedOption

numLabelsOption

public IntOption numLabelsOption

skewOption

public IntOption skewOption

labelCardinalityOption

public FloatOption labelCardinalityOption

labelCardinalityVarOption

public FloatOption labelCardinalityVarOption

labelCardinalityRatioOption

public FloatOption labelCardinalityRatioOption

labelDependencyChangeRatioOption

public FloatOption labelDependencyChangeRatioOption

m_MultilabelInstancesHeader

protected MultilabelInstancesHeader m_MultilabelInstancesHeader

m_BinaryGenerator

protected InstanceStream m_BinaryGenerator

multilabelStreamTemplate

protected weka.core.Instances multilabelStreamTemplate

m_MetaRandom

protected Random m_MetaRandom

m_L

protected int m_L

m_A

protected int m_A

priors

protected double[] priors

priors_norm

protected double[] priors_norm

Conditional

protected double[][] Conditional

m_TopCombinations

protected HashSet[] m_TopCombinations

Constructor Detail

MetaMultilabelGenerator

public MetaMultilabelGenerator()

Method Detail

prepareForUseImpl

public void prepareForUseImpl(TaskMonitor monitor,
                     ObjectRepository repository)

Description copied from class: AbstractOptionHandler

This method describes the implementation of how to prepare this object for use. All classes that extends this class have to implement prepareForUseImpl and not prepareForUse since prepareForUse calls prepareForUseImpl.

Specified by:

prepareForUseImpl in class AbstractOptionHandler

Parameters:

monitor - the TaskMonitor to use

repository - the ObjectRepository to use

restart

public void restart()

Description copied from interface: InstanceStream

Restarts this stream. It must be similar to starting a new stream from scratch.

Specified by:

restart in interface InstanceStream

generateMultilabelHeader

protected MultilabelInstancesHeader generateMultilabelHeader(weka.core.Instances si)

GenerateMultilabelHeader.

Parameters:

si - single-label Instances

nextInstance

public weka.core.Instance nextInstance()

GenerateML. Generates a multi-label example.

Specified by:

nextInstance in interface InstanceStream

Returns:

the next instance of this stream

modifyPriorVector

protected double[] modifyPriorVector(double[] P,
                         double u,
                         Random r,
                         boolean skew)

ModifyPriorVector. A certain number of values will be altered.

Parameters:

P[] - the prior distribution

u - the probability of changing P[j]

r - for random numbers

skew - NOTE not currently used

Returns:

the modified P

modifyDependencyMatrix

protected boolean[][] modifyDependencyMatrix(boolean[][] M,
                                 double u,
                                 Random r)

ModifyDependencyMatrix. A certain number of values will be altered. @NOTE a future improvement would be to detect cycles, since this may lead to inconsistencies. However, due to the rarity of this occurring, and the minimal problems it would cause (and considering that inconsistencies also occr in real datasets) we don't implement this.

Parameters:

M[][] - a boolean matrix

u - the probability of changing the relationship M[j][k]

r - for random numbers

Returns:

the modified M

generateConditional

protected double[][] generateConditional(double[] P,
                             boolean[][] M)

GenerateConditional. Given the priors distribution and a matrix flagging dependencies, generate a conditional distribution matrix Q; such that: P(i) = Q[i][i] P(i|j) = Q[i][j]

Parameters:

P - prior distribution

M - dependency matrix (where 1 == dependency)

Returns:

Q conditional dependency matrix

getHeader

public InstancesHeader getHeader()

Description copied from interface: InstanceStream

Gets the header of this stream. This is useful to know attributes and classes. InstancesHeader is an extension of weka.Instances.

Specified by:

getHeader in interface InstanceStream

Returns:

the header of this stream

getPurposeString

public String getPurposeString()

Description copied from interface: OptionHandler

Gets the purpose of this object

Specified by:

getPurposeString in interface OptionHandler

Overrides:

getPurposeString in class AbstractOptionHandler

Returns:

the string with the purpose of this object

estimatedRemainingInstances

public long estimatedRemainingInstances()

Description copied from interface: InstanceStream

Gets the estimated number of remaining instances in this stream

Specified by:

estimatedRemainingInstances in interface InstanceStream

Returns:

the estimated number of instances to get from this stream

hasMoreInstances

public boolean hasMoreInstances()

Description copied from interface: InstanceStream

Gets whether this stream has more instances to output. This is useful when reading streams from files.

Specified by:

hasMoreInstances in interface InstanceStream

Returns:

true if this stream has more instances to output

isRestartable

public boolean isRestartable()

Description copied from interface: InstanceStream

Gets whether this stream can restart.

Specified by:

isRestartable in interface InstanceStream

Returns:

true if this stream can restart

getDescription

public void getDescription(StringBuilder sb,
                  int indent)

Description copied from interface: MOAObject

Returns a string representation of this object. Used in AbstractMOAObject.toString to give a string representation of the object.

Specified by:

getDescription in interface MOAObject

Parameters:

sb - the stringbuilder to add the description

indent - the number of characters to indent

main

public static void main(String[] args)