org.lenskit.knn.user

Class UserUserItemScorer

java.lang.Object

org.lenskit.basic.AbstractItemScorer

org.lenskit.knn.user.UserUserItemScorer

All Implemented Interfaces:

ItemScorer

public class UserUserItemScorer
extends AbstractItemScorer

Score items with user-user collaborative filtering.

The detailed results returned by this scorer are of type UserUserResult.

Field Summary

Fields

Modifier and Type	Field and Description
protected NeighborFinder	neighborFinder
protected UserVectorNormalizer	normalizer

Constructor Summary

Constructors

Constructor and Description
UserUserItemScorer(RatingVectorPDAO rvd, NeighborFinder nf, UserVectorNormalizer norm, UserNeighborhoodScorer scorer, int nnbrs)

Method Summary

Modifier and Type	Method and Description
protected Long2ObjectMap<java.util.List<Neighbor>>	findNeighbors(long user, LongSet items) Find the neighbors for a user with respect to a collection of items.
ResultMap	scoreWithDetails(long user, java.util.Collection<java.lang.Long> items) Score a collection of items and potentially return more details on the scores.

Methods inherited from class org.lenskit.basic.AbstractItemScorer

score, score

Methods inherited from class java.lang.Object

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

Field Detail

neighborFinder

protected final NeighborFinder neighborFinder

normalizer

protected final UserVectorNormalizer normalizer

Constructor Detail

UserUserItemScorer

@Inject
public UserUserItemScorer(RatingVectorPDAO rvd,
                                  NeighborFinder nf,
                                  UserVectorNormalizer norm,
                                  UserNeighborhoodScorer scorer,
                                  @NeighborhoodSize
                                  int nnbrs)

Method Detail

scoreWithDetails

@Nonnull
public ResultMap scoreWithDetails(long user,
                                           @Nonnull
                                           java.util.Collection<java.lang.Long> items)

Description copied from interface: ItemScorer

Score a collection of items and potentially return more details on the scores.

Parameters:

user - The user ID for whom to generate scores.

items - The item to score.

Returns:

The scores for the items. This result set may not contain all requested items. Implementations that support additional details will return a subclass of ResultMap that provides access to those details.

findNeighbors

protected Long2ObjectMap<java.util.List<Neighbor>> findNeighbors(long user,
                                                                 @Nonnull
                                                                 LongSet items)

Find the neighbors for a user with respect to a collection of items. For each item, the neighborhoodSize users closest to the provided user are returned.

Parameters:

user - The user’s rating vector.

items - The items for which neighborhoods are requested.

Returns:

A mapping of item IDs to neighborhoods.