Environment for
DeveLoping
KDD-Applications
Supported by Index-Structures

de.lmu.ifi.dbs.elki.data
Class HierarchicalClassLabel

java.lang.Object
  extended by de.lmu.ifi.dbs.elki.data.ClassLabel
      extended by de.lmu.ifi.dbs.elki.data.HierarchicalClassLabel
All Implemented Interfaces:
Comparable<ClassLabel>

public class HierarchicalClassLabel
extends ClassLabel

A HierarchicalClassLabel is a ClassLabel to reflect a hierarchical structure of classes.

Author:
Arthur Zimek

Field Summary
static Pattern DEFAULT_SEPARATOR
          The default separator pattern, a point ('.').
static String DEFAULT_SEPARATOR_STRING
          The default separator, a point ('.').
private  Comparable<?>[] levelwiseNames
          Holds the names on the different levels.
private  Pattern separatorPattern
          Holds the Pattern to separate different levels parsing input.
private  String separatorString
          A String to separate different levels in a String representation of this HierarchicalClassLabel.
 
Constructor Summary
HierarchicalClassLabel()
           
 
Method Summary
 int compareTo(ClassLabel o)
          Compares two HierarchicalClassLabels.
 int depth()
          The length of the hierarchy of names.
 String getNameAt(int level)
          Returns the name at the given level as a String.
 void init(String label)
          Constructs a hierarchical class label from the given name.
 void init(String name, Pattern regex, String separator)
          Constructs a hierarchical class label from the given name, using the given Pattern to match separators of different levels in the given name, and setting the given separator-String to separate different levels in String representations of this HierarchicalClassLabel.
 String toString()
          Returns a String representation of this HierarchicalClassLabel using separatorString to separate levels.
 String toString(int level)
          Provides a String representation of this ClassLabel comprising only the first level levels.
 
Methods inherited from class de.lmu.ifi.dbs.elki.data.ClassLabel
equals, hashCode
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

DEFAULT_SEPARATOR

public static final Pattern DEFAULT_SEPARATOR
The default separator pattern, a point ('.').


DEFAULT_SEPARATOR_STRING

public static final String DEFAULT_SEPARATOR_STRING
The default separator, a point ('.').

See Also:
Constant Field Values

separatorPattern

private Pattern separatorPattern
Holds the Pattern to separate different levels parsing input.


separatorString

private String separatorString
A String to separate different levels in a String representation of this HierarchicalClassLabel.


levelwiseNames

private Comparable<?>[] levelwiseNames
Holds the names on the different levels.

Constructor Detail

HierarchicalClassLabel

public HierarchicalClassLabel()
See Also:
ClassLabel.ClassLabel()
Method Detail

init

public void init(String name,
                 Pattern regex,
                 String separator)
Constructs a hierarchical class label from the given name, using the given Pattern to match separators of different levels in the given name, and setting the given separator-String to separate different levels in String representations of this HierarchicalClassLabel.

Parameters:
name - a String describing a hierarchical class label
regex - a Pattern to match separators of different levels in the given name
separator - a separator String to separate different levels in the String-representation of this HierarchicalClassLabel

init

public void init(String label)
Constructs a hierarchical class label from the given name. Different levels are supposed to be separated by points ('.'), as defined by DEFAULT_SEPARATOR. Also, in a String-representation of this HierarchicalClassLabel, different levels get separated by '.'.

Specified by:
init in class ClassLabel
Parameters:
label - a String describing a hierarchical class label
See Also:
init(String, java.util.regex.Pattern, String)

compareTo

public int compareTo(ClassLabel o)
Compares two HierarchicalClassLabels. Names at higher levels are compared first. Names at a lower level are compared only if their parent-names are equal. Names at a level are tried to be compared as integer values. If this does not succeed, both names are compared as Strings.


depth

public int depth()
The length of the hierarchy of names.

Returns:
length of the hierarchy of names

getNameAt

public String getNameAt(int level)
Returns the name at the given level as a String.

Parameters:
level - the level to return the name at
Returns:
the name at the given level as a String

toString

public String toString()
Returns a String representation of this HierarchicalClassLabel using separatorString to separate levels.

Specified by:
toString in class ClassLabel
See Also:
toString(int)

toString

public String toString(int level)
Provides a String representation of this ClassLabel comprising only the first level levels.

Parameters:
level - the lowest level to include in the String representation.
Returns:
a String representation of this ClassLabel comprising only the first level levels

Release 0.3 (2010-03-31_1612)