nz.ac.waikato.mcennis.rat.graph.algorithm.collaborativefiltering
Class AssociativeMiningItemSetGroup

java.lang.Object
  extended by nz.ac.waikato.mcennis.rat.graph.algorithm.collaborativefiltering.AssociativeMiningItemSetGroup

public class AssociativeMiningItemSetGroup
extends java.lang.Object

Class for bundling Association Objects. It stores references to the paraent graph object and handles all bookkeeping for expanding association objects until no larger group of items has a significant association. All previous associations are kept during each expansion. See Associative mining for a description of the algorithm this is a part of.


Constructor Summary
AssociativeMiningItemSetGroup(Graph g, java.lang.String relation)
          Creates a new association group in the given (sub)graph over the given link relation
 
Method Summary
 void addNegativeBase(Actor a, AssociativeMiningItems ami)
          Add to the given base set of associations this actor and associated item describing its (negative) relationship to the source actor.
 void addPositiveBase(Actor a, AssociativeMiningItems ami)
          Add to the given base set of associations this actor and associated item describing its (positive) relationship to the source actor.
 int expandSet(Actor targetActor)
          Expand the current set of associations with all other actors in either the positive or negaqtive base set.
 AssociativeMiningItems[] exportAssociations()
          Combine all significant relations found by exporting the objects that describe them in an array.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AssociativeMiningItemSetGroup

public AssociativeMiningItemSetGroup(Graph g,
                                     java.lang.String relation)
Creates a new association group in the given (sub)graph over the given link relation

Parameters:
g - graph of objects
relation - link relation associations are derived from
Method Detail

addPositiveBase

public void addPositiveBase(Actor a,
                            AssociativeMiningItems ami)
Add to the given base set of associations this actor and associated item describing its (positive) relationship to the source actor.

Parameters:
a - actor that has the sigificant relation
ami - object describing this significant relation.

addNegativeBase

public void addNegativeBase(Actor a,
                            AssociativeMiningItems ami)
Add to the given base set of associations this actor and associated item describing its (negative) relationship to the source actor.

Parameters:
a - actor that has the sigificant relation
ami - object describing this significant relation.

exportAssociations

public AssociativeMiningItems[] exportAssociations()
Combine all significant relations found by exporting the objects that describe them in an array.

Returns:
array of objects describing associations

expandSet

public int expandSet(Actor targetActor)
Expand the current set of associations with all other actors in either the positive or negaqtive base set. To avoid duplication, only actors greater than all actors in the association are tested.

Parameters:
targetActor - actor to check for a larger-member association
Returns:
number of new associations created.