TimeAwareRatingPredictor Class Reference

Abstract class for time-aware rating predictors. More...

Inheritance diagram for TimeAwareRatingPredictor:
RatingPredictor ITimeAwareRatingPredictor IRatingPredictor IRatingPredictor IRecommender IRecommender TimeAwareBaseline TimeAwareBaselineWithFrequencies

List of all members.

Public Member Functions

virtual bool CanPredict (int user_id, int item_id)
 Check whether a useful prediction (i.e. not using a fallback/default answer) can be made for a given user-item combination.
Object Clone ()
 create a shallow copy of the object
virtual void LoadModel (string file)
 Get the model parameters from a file.
abstract double Predict (int user_id, int item_id)
 Predict rating or score for a given user-item combination.
abstract double Predict (int user_id, int item_id, DateTime time)
 predict rating at a certain point in time
virtual void SaveModel (string file)
 Save the model parameters to a file.
override string ToString ()
 Return a string representation of the recommender.
abstract void Train ()
 Learn the model parameters of the recommender from the training data.

Protected Attributes

double max_rating
 Maximum rating value.
double min_rating
 Minimum rating value.
IRatings ratings
 rating data
ITimedRatings timed_ratings
 rating data, including time information

Properties

int MaxItemID [get, set]
 Maximum item ID.
virtual double MaxRating [get, set]
 Maximum rating value.
int MaxUserID [get, set]
 Maximum user ID.
virtual double MinRating [get, set]
 Minimum rating value.
override IRatings Ratings [get, set]
 The rating data.
virtual ITimedRatings TimedRatings [get, set]
 the rating data, including time information

Detailed Description

Abstract class for time-aware rating predictors.

Exceptions:
ArgumentException Is thrown when an argument passed to a method is invalid.

Member Function Documentation

virtual bool CanPredict ( int  user_id,
int  item_id 
) [inline, virtual, inherited]

Check whether a useful prediction (i.e. not using a fallback/default answer) can be made for a given user-item combination.

It is up to the recommender implementor to decide when a prediction is useful, and to document it accordingly.

Parameters:
user_id the user ID
item_id the item ID
Returns:
true if a useful prediction can be made, false otherwise

Implements IRecommender.

Reimplemented in BiPolarSlopeOne, GlobalAverage, ItemAverage, SlopeOne, and UserAverage.

Object Clone (  )  [inline, inherited]

create a shallow copy of the object

virtual void LoadModel ( string  filename  )  [inline, virtual, inherited]

Get the model parameters from a file.

Parameters:
filename the name of the file to read from

Implements IRecommender.

Reimplemented in BiasedMatrixFactorization, BiPolarSlopeOne, CoClustering, EntityAverage, FactorWiseMatrixFactorization, GlobalAverage, ItemKNN, KNN, MatrixFactorization, SlopeOne, and UserItemBaseline.

abstract double Predict ( int  user_id,
int  item_id 
) [pure virtual, inherited]

Predict rating or score for a given user-item combination.

Parameters:
user_id the user ID
item_id the item ID
Returns:
the predicted score/rating for the given user-item combination

Implements IRecommender.

Implemented in BiasedMatrixFactorization, BiPolarSlopeOne, CoClustering, FactorWiseMatrixFactorization, GlobalAverage, ItemAverage, ItemKNN, MatrixFactorization, SlopeOne, TimeAwareBaseline, UserAverage, UserItemBaseline, and UserKNN.

abstract double Predict ( int  user_id,
int  item_id,
DateTime  time 
) [pure virtual]

predict rating at a certain point in time

Parameters:
user_id the user ID
item_id the item ID
time the time of the rating event

Implements ITimeAwareRatingPredictor.

Implemented in TimeAwareBaseline, and TimeAwareBaselineWithFrequencies.

virtual void SaveModel ( string  filename  )  [inline, virtual, inherited]

Save the model parameters to a file.

Parameters:
filename the name of the file to write to

Implements IRecommender.

Reimplemented in BiasedMatrixFactorization, BiPolarSlopeOne, CoClustering, EntityAverage, FactorWiseMatrixFactorization, GlobalAverage, KNN, MatrixFactorization, SlopeOne, and UserItemBaseline.

override string ToString (  )  [inline, inherited]

Return a string representation of the recommender.

The ToString() method of recommenders should list the class name and all hyperparameters, separated by space characters.

Implements IRecommender.

Reimplemented in BiasedMatrixFactorization, CoClustering, FactorWiseMatrixFactorization, ItemAttributeKNN, ItemKNNCosine, ItemKNNPearson, MatrixFactorization, TimeAwareBaseline, TimeAwareBaselineWithFrequencies, UserAttributeKNN, UserItemBaseline, UserKNNCosine, and UserKNNPearson.


Member Data Documentation

double max_rating [protected, inherited]

Maximum rating value.

double min_rating [protected, inherited]

Minimum rating value.

IRatings ratings [protected, inherited]

rating data

rating data, including time information


Property Documentation

int MaxItemID [get, set, inherited]

Maximum item ID.

virtual double MaxRating [get, set, inherited]

Maximum rating value.

Implements IRatingPredictor.

int MaxUserID [get, set, inherited]

Maximum user ID.

virtual double MinRating [get, set, inherited]

Minimum rating value.

Implements IRatingPredictor.

override IRatings Ratings [get, set]

The rating data.

Reimplemented from RatingPredictor.

virtual ITimedRatings TimedRatings [get, set]

the rating data, including time information

Implements ITimeAwareRatingPredictor.


The documentation for this class was generated from the following file:
Generated on Mon Nov 28 19:18:50 2011 for MyMediaLite by  doxygen 1.6.3