org.lenskit.basic

Class TopNItemRecommender

java.lang.Object

org.lenskit.basic.AbstractItemRecommender

org.lenskit.basic.TopNItemRecommender

All Implemented Interfaces:

ItemRecommender

public class TopNItemRecommender
extends AbstractItemRecommender

Recommender that recommends the top N items by a scorer. Implements all methods required by AbstractItemRecommender. The default exclude set is all items rated by the user.

Recommendations are returned in descending order of score.

Since:

1.1

Field Summary

Fields

Modifier and Type	Field and Description
protected ItemDAO	itemDAO
protected ItemScorer	scorer
protected UserEventDAO	userEventDAO

Constructor Summary

Constructors

Constructor and Description
TopNItemRecommender(UserEventDAO uedao, ItemDAO idao, ItemScorer scorer)

Method Summary

Modifier and Type	Method and Description
protected LongSet	getDefaultExcludes(long user) Get the default exclude set for a user.
protected LongSet	getDefaultExcludes(UserHistory<? extends Event> user) Get the default exclude set for a user.
protected LongSet	getPredictableItems(long user) Determine the items for which predictions can be made for a certain user.
ItemScorer	getScorer()
protected List<Long>	recommend(long user, int n, LongSet candidates, LongSet exclude) Implement recommendation by calling ItemScorer.score(long, Collection) and sorting the results by score.
protected ResultList	recommendWithDetails(long user, int n, LongSet candidates, LongSet exclude) Implement recommendation by calling ItemScorer.scoreWithDetails(long, Collection) and sorting the results.

Methods inherited from class org.lenskit.basic.AbstractItemRecommender

recommend, recommend, recommend, recommendWithDetails

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

userEventDAO

protected final UserEventDAO userEventDAO

itemDAO

protected final ItemDAO itemDAO

scorer

protected final ItemScorer scorer

Constructor Detail

TopNItemRecommender

@Inject
public TopNItemRecommender(UserEventDAO uedao,
                                    ItemDAO idao,
                                    ItemScorer scorer)

Method Detail

getScorer

public ItemScorer getScorer()

recommend

protected List<Long> recommend(long user,
                               int n,
                               LongSet candidates,
                               LongSet exclude)

Implement recommendation by calling ItemScorer.score(long, Collection) and sorting the results by score. This method uses getDefaultExcludes(long) to get the default exclude set for the user, if none is provided.

Overrides:

recommend in class AbstractItemRecommender

Parameters:

user - The user ID.

n - The number of recommendations to produce, or a negative value to produce unlimited recommendations.

candidates - The candidate items, or null for default.

exclude - The exclude set, or null for default.

Returns:

The result list.

See Also:

AbstractItemRecommender.recommend(long, int, Set, Set)

recommendWithDetails

protected ResultList recommendWithDetails(long user,
                                          int n,
                                          LongSet candidates,
                                          LongSet exclude)

Implement recommendation by calling ItemScorer.scoreWithDetails(long, Collection) and sorting the results. This method uses getDefaultExcludes(long) to get the default exclude set for the user, if none is provided.

Specified by:

recommendWithDetails in class AbstractItemRecommender

Parameters:

user - The user ID.

n - The number of recommendations to produce, or a negative value to produce unlimited recommendations.

candidates - The candidate items, or null for default.

exclude - The exclude set, or null for default.

Returns:

The result list.

See Also:

AbstractItemRecommender.recommendWithDetails(long, int, Set, Set)

getDefaultExcludes

protected LongSet getDefaultExcludes(long user)

Get the default exclude set for a user. The base implementation gets all the items they have interacted with.

Parameters:

user - The user ID.

Returns:

The set of items to exclude.

getDefaultExcludes

protected LongSet getDefaultExcludes(@Nullable
                                     UserHistory<? extends Event> user)

Get the default exclude set for a user. The base implementation returns all the items they have interacted with (from UserHistory.itemSet()).

Parameters:

user - The user history.

Returns:

The set of items to exclude.

getPredictableItems

protected LongSet getPredictableItems(long user)

Determine the items for which predictions can be made for a certain user. This implementation is naive and asks the DAO for all items; subclasses should override it with something more efficient if practical.

Parameters:

user - The user’s ID.

Returns:

All items for which predictions can be generated for the user.