org.lenskit.basic

Class TopNItemBasedItemRecommender

java.lang.Object

org.lenskit.basic.AbstractItemBasedItemRecommender

org.lenskit.basic.TopNItemBasedItemRecommender

All Implemented Interfaces:

ItemBasedItemRecommender

public class TopNItemBasedItemRecommender
extends AbstractItemBasedItemRecommender

A global item recommender that recommends the top N items from a scorer.

Since:

1.1

Field Summary

Fields

Modifier and Type	Field and Description
protected DataAccessObject	dao
protected ItemBasedItemScorer	scorer

Constructor Summary

Constructors

Constructor and Description
TopNItemBasedItemRecommender(DataAccessObject data, ItemBasedItemScorer scorer)

Method Summary

Modifier and Type	Method and Description
protected LongSet	getDefaultExcludes(LongSet items) Get the default exclude set for a item in the global recommendation.
protected ResultList	recommend(int n, ResultMap scores) Pick the top n items from a score vector.
ResultList	recommendRelatedItemsWithDetails(java.util.Set<java.lang.Long> basket, int n, java.util.Set<java.lang.Long> candidates, java.util.Set<java.lang.Long> exclude) Produce a set of recommendations for the item, with details.

Methods inherited from class org.lenskit.basic.AbstractItemBasedItemRecommender

recommendRelatedItems, recommendRelatedItems, recommendRelatedItems, recommendRelatedItems, recommendRelatedItems

Methods inherited from class java.lang.Object

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

Field Detail

dao

protected final DataAccessObject dao

scorer

protected final ItemBasedItemScorer scorer

Constructor Detail

TopNItemBasedItemRecommender

@Inject
public TopNItemBasedItemRecommender(DataAccessObject data,
                                            ItemBasedItemScorer scorer)

Method Detail

recommendRelatedItemsWithDetails

public ResultList recommendRelatedItemsWithDetails(java.util.Set<java.lang.Long> basket,
                                                   int n,
                                                   @Nullable
                                                   java.util.Set<java.lang.Long> candidates,
                                                   @Nullable
                                                   java.util.Set<java.lang.Long> exclude)

Description copied from interface: ItemBasedItemRecommender

Produce a set of recommendations for the item, with details. This method functions identically to ItemBasedItemRecommender.recommendRelatedItems(Set, int, Set, Set), except that it returns more detailed results.

Parameters:

basket - The reference items.

n - The number of ratings to return. If negative, recommend as many as possible.

candidates - A set of candidate items which can be recommended. If null, all items are considered candidates.

exclude - A set of items to be excluded. If null, a default exclude set is used.

Returns:

A list of recommended items with recommendation details. If the recommender cannot assign meaningful scores, the scores will be Double.NaN.

getDefaultExcludes

protected LongSet getDefaultExcludes(LongSet items)

Get the default exclude set for a item in the global recommendation. The base implementation returns the input set.

Parameters:

items - The items for which we are recommending.

Returns:

The set of items to exclude.

recommend

protected ResultList recommend(int n,
                               ResultMap scores)

Pick the top n items from a score vector.

Parameters:

n - The number of items to recommend.

scores - The scored item vector.

Returns:

The top n items from scores, in descending order of score.