How to cluster an instance with Weka's DBSCAN?

Question

I've been trying to use the DBSCAN clusterer from Weka to cluster instances. From what I understand I should be using the clusterInstance() method for this, but to my surprise, when taking a look at the code of that method, it looks like the implementation ignores the parameter:

/**
 * Classifies a given instance.
 *
 * @param instance The instance to be assigned to a cluster
 * @return int The number of the assigned cluster as an integer
 * @throws java.lang.Exception If instance could not be clustered
 * successfully
 */
public int clusterInstance(Instance instance) throws Exception {
    if (processed_InstanceID >= database.size()) processed_InstanceID = 0;
    int cnum = (database.getDataObject(Integer.toString(processed_InstanceID++))).getClusterLabel();
    if (cnum == DataObject.NOISE)
        throw new Exception();
    else
        return cnum;
}

This doesn't seem right. How is that supposed to work? Is there a different method I should be using for clustering? Do I have to run this method sequentially on all instances, in some specific order, if I want to get any useful information out of it?

Answer 1

This has been reported as a bug - [Wekalist] DBScan - Issue/Bug with "clusterInstance()"-Function.

I'm doing some clustering with the DBScan library. Unfortunately it seems that there is a bug in the function "clusterInstance()". The function doesn't return the number of the assigned cluster but only returns the cluster-number of the first database element (or the second on the second call, the third on the third call, and so on.) and NOT the assigned instance.

It simply cannot work because the assigned variable is never used in the function.

The response reads:

DBScan and Optics are contributions to Weka. It's probably best if you contact the authors to see if they can suggest a bug fix. The code and package info (Weka 3.7) has contact information:

http://weka.sourceforge.net/packageMetaData/optics_dbScan/index.html

I'm afraid I am unfamiliar with the DBScan algorithm and the code is quite old now (2004), you might be lucky and find that you are still able to contact the authors at LMU Munich.

I did find numerous copies of it via Google Code Search and GitHub but I could not find an example where it had been fixed. While searching I did notice several other implementations of DBScan that you could examine to work out how this one could be fixed (e.g. ELKI's DBSCAN)

As I have said I am unfamiliar with DBScan but looking at the JavaDocs gave me the impression that actual clustering is invoked by calling buildClusterer(Instances instances). Examining the source code there seems to be much more going on inside the buildClusterer method than the clusterInstance method. OPTICS.java contains a clusterInstance method too and that one just throws an exception. If your are lucky maybe you can get by without a functioning clusterInstance method.

I found an example of Weka's DBScan being used here: DBSCANClustering.java