Main Page | Class Hierarchy | Class List | Class Members

kddml.Operators.Preprocessing.PP_ADD_HIERARCHY_RESOLVER Class Reference

Inheritance diagram for kddml.Operators.Preprocessing.PP_ADD_HIERARCHY_RESOLVER:

kddml.Operators.Preprocessing.SchemaLevelTransformation kddml.Operators.Preprocessing.PreprocessingResolver kddml.Operators.OperatorResolver kddml.Operators.HWResourcesDescription List of all members.

Public Member Functions

void readAttributes (Hashtable< String, KDDMLScalarManager > parameters) throws KDDMLCoreException
KDDMLObjectType getArgumentType (int i)
KDDMLObject execute (Hashtable< String, KDDMLScalarManager > settings, Vector< KDDMLObject > arguments) throws ResolverException, KDDMLCoreException

Protected Member Functions

void readDataStatistics (DataStatisticsManager stat, DataStatisticsManager PPstat) throws ResolverException, KDDMLCoreException
void readOthersArgurments (Vector< KDDMLObject > arguments) throws KDDMLCoreException
String getHistoryDescription ()
Instances[] runCore (Instances tuple, Instances metatuple) throws ResolverException, KDDMLCoreException
boolean dataTransformationIsNeeded ()

Detailed Description

The operator assigns an hierarchy object to a table column as meta-data information. This operator works only on data schemata: neither the physical records, nor the preprocessing section are affected.

Title: KDDML

Description: Knowledge Discovery in Database Environment

Copyright: Copyright (c) 2003-2005

Company: Universita' di Pisa - Dipartimento di Informatica

Author:
Andrea Romei (romei@di.unipi.it)

Sandra Zimei

Version:
2.0.16


Member Function Documentation

void kddml.Operators.Preprocessing.PP_ADD_HIERARCHY_RESOLVER.readAttributes Hashtable< String, KDDMLScalarManager parameters  )  throws KDDMLCoreException [virtual]
 

Reads the XML attributes related to a generic preprocessing operator. An operator settings object captures the attributes associated with a particular operator. It allows a knowledgeable user to fine tune operator parameters. Generally, not all parameters must be specified, however, those specified are taken into account by the KDDML.
Attributes are given as hashtable, where the key is the name of the attribute related to the operator and the value is a KDDMLScalar object containing the attribute value. Attribute value is checked by the interpreter layer and its type is correct.

Parameters:
parameters Hashtable the attributes related to the operator. The key of the hashtable is the name of the operator. The value of the hashtable is a KDDMLScalar representing the value of the operator.
Exceptions:
ResolverException if a resolving error occurs.
KDDMLCoreException if a level core error occurs.

Implements kddml.Operators.Preprocessing.PreprocessingResolver.

void kddml.Operators.Preprocessing.PP_ADD_HIERARCHY_RESOLVER.readDataStatistics DataStatisticsManager  stat,
DataStatisticsManager  PPstat
throws ResolverException, KDDMLCoreException [protected]
 

Reads data statistics related to input preprocessing table. Data statistic can be used to provide additional information to preprocessing operator, such as the number of total instances or attributes belonging to the data source. By default, this method do nothing. It can be overried inside operator implementation if necessary.

Parameters:
stat DataStatisticsManager statistics related to physical instances
PPstat DataStatisticsManager statistics related to preprocessing instances
Exceptions:
ResolverException if a resolving error occurs.
KDDMLCoreException if a level core error occurs.

Reimplemented from kddml.Operators.Preprocessing.PreprocessingResolver.

void kddml.Operators.Preprocessing.PP_ADD_HIERARCHY_RESOLVER.readOthersArgurments Vector< KDDMLObject arguments  )  throws KDDMLCoreException [protected]
 

Reads other arguments from the input vector, i.e. arguments whose position is different from the first. By default, this method do nothing. It must be overried if and only if the preprocessing operator accepts other arguments in addiction to the preprocessing table. In this case, also the method getArgumentType(int i) must be overried.

Parameters:
arguments Vector the list of arguments as KDDMLObject.
Exceptions:
KDDMLCoreException if a level core error occurs.

Reimplemented from kddml.Operators.Preprocessing.PreprocessingResolver.

String kddml.Operators.Preprocessing.PP_ADD_HIERARCHY_RESOLVER.getHistoryDescription  )  [protected, virtual]
 

Returns a description of the actions performed by this preprocessing operator. This description will be reported in the history related to the preprocessing data source.

Returns:
String
Exceptions:
KDDMLCoreException 

Implements kddml.Operators.Preprocessing.PreprocessingResolver.

Instances [] kddml.Operators.Preprocessing.PP_ADD_HIERARCHY_RESOLVER.runCore Instances  tuple,
Instances  metatuple
throws ResolverException, KDDMLCoreException [protected, virtual]
 

Core operator method. Given a physical set of instance and the related preprocessing tuple as weka.core.Instances, the operator returns the modified instances as two-dimensional array. Input tuples and metatuples are loaded and passed up by the main execute method that imports a block of instances at each iteration. So, the method is automatically called many times, and this depends on the number of total instances and attributes. At first iteration, only the data schemata (and related preprocessing data schemata) is loaded.

Parameters:
tuple Instances a block of instances as weka.core.Instances.
metatuple Instances a block of related preprocessing instances as weka.core.Instances. The number of metatuple coincides with the number of physical tuples.
Returns:
Instances[] a two-dimensional array containing the modified output block of instances. The first element contains the physical instances; the second element contains the related preprocessing instances. Output schema of instances must be compatible with input schemata and the number of ouput instances must coincide with the number of input instances.
Exceptions:
ResolverException if a resolving error occurs.
KDDMLCoreException if a level core error occurs.

Implements kddml.Operators.Preprocessing.SchemaLevelTransformation.

KDDMLObjectType kddml.Operators.Preprocessing.PP_ADD_HIERARCHY_RESOLVER.getArgumentType int  i  )  [virtual]
 

Returns the expected type of the i-th argument of the operator. Returns null if the operator do not admit argument as i-th child.

Parameters:
i int
Returns:
KDDMLObjectType

Reimplemented from kddml.Operators.Preprocessing.PreprocessingResolver.

KDDMLObject kddml.Operators.Preprocessing.PP_ADD_HIERARCHY_RESOLVER.execute Hashtable< String, KDDMLScalarManager settings,
Vector< KDDMLObject arguments
throws ResolverException, KDDMLCoreException [virtual]
 

Overloading of the main execute method. Returns the result of evaluating the operator over the passed arguments and attributes.
Attributes are given as hashtable, where the key is the name of the XML attribute related to the operator and the value is a KDDMLScalar object containing the attribute value. Attribute value is checked by the interpreter layer and it is correct.
Arguments are given as vector of KDDMLOjbect. Types of arguments are correct, as required by the getArgumentType(int i) method.
Implementations of the execute method can be distinguished according to the type of operator.

Parameters:
settings Hashtable the attributes related to the operator. The key of the hashtable is the name of the attribute. The value of the hashtable is a KDDMLScalar representing the value of the attribute.
arguments Vector the list of arguments as KDDMLObject.
Returns:
KDDMLObject the result of evaluating the operator.
Exceptions:
ResolverException if a resolving error occurs.
KDDMLCoreException if a level core error occurs.

Reimplemented from kddml.Operators.Preprocessing.SchemaLevelTransformation.

boolean kddml.Operators.Preprocessing.PP_ADD_HIERARCHY_RESOLVER.dataTransformationIsNeeded  )  [protected, virtual]
 

Returns false if only data schemata related to input preprocessing table will be changed by the operator. Returns true if also physical data will be changed by the operator. E.g., the operator that removes attributes also modifies the physical data; an operator that changes the logical type of an attribute do not modifies it.

Returns:
boolean

Implements kddml.Operators.Preprocessing.SchemaLevelTransformation.


Generated on Thu Feb 23 13:04:52 2006 for kddml by  doxygen 1.4.3