MyMediaLite
3.11
|
Abstract class for matrix factorization based item predictors More...
Public Member Functions | |
override void | AddFeedback (ICollection< Tuple< int, int >> feedback) |
Add positive feedback events and perform incremental training More... | |
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 More... | |
Object | Clone () |
create a shallow copy of the object More... | |
abstract float | ComputeObjective () |
Compute the current optimization objective (usually loss plus regularization term) of the model More... | |
abstract void | Iterate () |
Iterate once over the data More... | |
override void | LoadModel (string file) |
Get the model parameters from a file More... | |
MF () | |
Default constructor More... | |
override float | Predict (int user_id, int item_id) |
Predict the weight for a given user-item combination More... | |
IList< Tuple< int, float > > | Recommend (int user_id, int n=-1, ICollection< int > ignore_items=null, ICollection< int > candidate_items=null) |
Recommend items for a given user More... | |
virtual System.Collections.Generic.IList< Tuple< int, float > > | Recommend (int user_id, int n=-1, System.Collections.Generic.ICollection< int > ignore_items=null, System.Collections.Generic.ICollection< int > candidate_items=null) |
override void | RemoveFeedback (ICollection< Tuple< int, int >> feedback) |
Remove all feedback events by the given user-item combinations More... | |
override void | RemoveItem (int item_id) |
Remove all feedback by one item More... | |
override void | RemoveUser (int user_id) |
Remove all feedback by one user More... | |
override void | SaveModel (string file) |
Save the model parameters to a file More... | |
override string | ToString () |
Return a string representation of the recommender More... | |
override void | Train () |
Learn the model parameters of the recommender from the training data More... | |
Protected Member Functions | |
override void | AddItem (int item_id) |
override void | AddUser (int user_id) |
virtual void | InitModel () |
abstract void | RetrainItem (int item_id) |
Retrain the latent factors of a given item More... | |
abstract void | RetrainUser (int user_id) |
Retrain the latent factors of a given user More... | |
Protected Attributes | |
Matrix< float > | item_factors |
Latent item factor matrix More... | |
int | num_factors = 10 |
Number of latent factors per user/item More... | |
Matrix< float > | user_factors |
Latent user factor matrix More... | |
Properties | |
virtual IPosOnlyFeedback | Feedback [get, set] |
the feedback data to be used for training More... | |
double | InitMean [get, set] |
Mean of the normal distribution used to initialize the latent factors More... | |
double | InitStdDev [get, set] |
Standard deviation of the normal distribution used to initialize the latent factors More... | |
int | MaxItemID [get, set] |
Maximum item ID More... | |
int | MaxUserID [get, set] |
Maximum user ID More... | |
uint | NumFactors [get, set] |
Number of latent factors per user/item More... | |
uint | NumIter [get, set] |
Number of iterations over the training data More... | |
bool | UpdateItems [get, set] |
bool | UpdateUsers [get, set] |
Abstract class for matrix factorization based item predictors
|
inline |
Default constructor
|
inlinevirtual |
Add positive feedback events and perform incremental training
feedback | collection of user id - item id tuples |
Reimplemented from IncrementalItemRecommender.
|
inlinevirtualinherited |
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.
user_id | the user ID |
item_id | the item ID |
Implements IRecommender.
Reimplemented in ExternalItemRecommender, ExternalRatingPredictor, BiPolarSlopeOne, SlopeOne, Constant, GlobalAverage, UserAverage, ItemAverage, and Random.
|
inlineinherited |
create a shallow copy of the object
|
pure virtual |
Compute the current optimization objective (usually loss plus regularization term) of the model
Implements IIterativeModel.
Implemented in BPRMF, WRMF, and SoftMarginRankingMF.
|
pure virtual |
|
inlinevirtual |
Get the model parameters from a file
filename | the name of the file to read from |
Reimplemented from Recommender.
|
inlinevirtual |
Predict the weight for a given user-item combination
If the user or the item are not known to the recommender, zero is returned. To avoid this behavior for unknown entities, use CanPredict() to check before.
user_id | the user ID |
item_id | the item ID |
Implements Recommender.
|
inherited |
Recommend items for a given user
user_id | the user ID |
n | the number of items to recommend, -1 for as many as possible |
ignore_items | collection if items that should not be returned; if null, use empty collection |
candidate_items | the candidate items to choose from; if null, use all items |
Implemented in WeightedEnsemble, and Ensemble.
|
inlinevirtual |
Remove all feedback events by the given user-item combinations
feedback | collection of user id - item id tuples |
Reimplemented from IncrementalItemRecommender.
|
inlinevirtual |
Remove all feedback by one item
item_id | the item ID |
Reimplemented from IncrementalItemRecommender.
|
inlinevirtual |
Remove all feedback by one user
user_id | the user ID |
Reimplemented from IncrementalItemRecommender.
|
protectedpure virtual |
|
protectedpure virtual |
|
inlinevirtual |
Save the model parameters to a file
filename | the name of the file to write to |
Reimplemented from Recommender.
|
inlineinherited |
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.
|
inlinevirtual |
Learn the model parameters of the recommender from the training data
Implements Recommender.
Reimplemented in MultiCoreBPRMF, and WeightedBPRMF.
|
protected |
Latent item factor matrix
|
protected |
Number of latent factors per user/item
|
protected |
Latent user factor matrix
|
getsetinherited |
the feedback data to be used for training
|
getset |
Mean of the normal distribution used to initialize the latent factors
|
getset |
Standard deviation of the normal distribution used to initialize the latent factors
|
getsetinherited |
Maximum item ID
|
getsetinherited |
Maximum user ID
|
getset |
Number of latent factors per user/item
|
getset |
Number of iterations over the training data