org.apache.mahout.cf.taste.impl.similarity
Class CachingUserSimilarity

java.lang.Object
  extended by org.apache.mahout.cf.taste.impl.similarity.CachingUserSimilarity
All Implemented Interfaces:
Refreshable, UserSimilarity

public final class CachingUserSimilarity
extends java.lang.Object
implements UserSimilarity

Caches the results from an underlying UserSimilarity implementation.


Constructor Summary
CachingUserSimilarity(UserSimilarity similarity, DataModel dataModel)
           
 
Method Summary
 void refresh(java.util.Collection<Refreshable> alreadyRefreshed)
           Triggers "refresh" -- whatever that means -- of the implementation.
 void setPreferenceInferrer(PreferenceInferrer inferrer)
           Attaches a PreferenceInferrer to the implementation.
 double userSimilarity(long userID1, long userID2)
           Returns the degree of similarity, of two users, based on the their preferences.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

CachingUserSimilarity

public CachingUserSimilarity(UserSimilarity similarity,
                             DataModel dataModel)
                      throws TasteException
Throws:
TasteException
Method Detail

userSimilarity

public double userSimilarity(long userID1,
                             long userID2)
                      throws TasteException
Description copied from interface: UserSimilarity

Returns the degree of similarity, of two users, based on the their preferences.

Specified by:
userSimilarity in interface UserSimilarity
Parameters:
userID1 - first user ID
userID2 - second user ID
Returns:
similarity between the two users, in [-1,1]
Throws:
TasteException - if an error occurs while accessing the data

setPreferenceInferrer

public void setPreferenceInferrer(PreferenceInferrer inferrer)
Description copied from interface: UserSimilarity

Attaches a PreferenceInferrer to the implementation.

Specified by:
setPreferenceInferrer in interface UserSimilarity
Parameters:
inferrer - PreferenceInferrer

refresh

public void refresh(java.util.Collection<Refreshable> alreadyRefreshed)
Description copied from interface: Refreshable

Triggers "refresh" -- whatever that means -- of the implementation. The general contract is that any should always leave itself in a consistent, operational state, and that the refresh atomically updates internal state from old to new.

Specified by:
refresh in interface Refreshable
Parameters:
alreadyRefreshed - s that are known to have already been refreshed as a result of an initial call to a method on some object. This ensure that objects in a refresh dependency graph aren't refreshed twice needlessly.


Copyright © 2008-2010 The Apache Software Foundation. All Rights Reserved.