Package es.upm.etsisi.cf4j.util.optimization

Class GridSearchCV

java.lang.Object

es.upm.etsisi.cf4j.util.optimization.RandomSearchCV

es.upm.etsisi.cf4j.util.optimization.GridSearchCV

public class GridSearchCV
extends RandomSearchCV

Utility class to performs a grid search over a Recommender instance. The Recommender class used during the grid search must contains a constructor with the signature Recommender::<init>(DataModel, Map<String, Object>) that initializes the Recommender using the attributes defined in the Map object. The parameters used in the search process, i.e. the development set, must be defined in a ParamsGrid instance. The random search is executed in such a way that it minimizes (by default) or maximizes a QualityMeasure by splitting the train set of the dataset in validations sets using cross validation. If the QualityMeasure requires parameters to work, it must contains a constructor with the signature QualityMeasure::<init>(Recommender, Map<String, Object>) that initializes the QualityMeasure using the attributes defined in the Map object.

Constructor Summary

Constructors

Constructor	Description
GridSearchCV(DataModel datamodel, ParamsGrid grid, Class<? extends Recommender> recommenderClass, Class<? extends QualityMeasure>[] qualityMeasuresClasses, int cv)	GridSearchCV constructor
GridSearchCV(DataModel datamodel, ParamsGrid grid, Class<? extends Recommender> recommenderClass, Class<? extends QualityMeasure>[] qualityMeasuresClasses, int cv, long seed)	GridSearchCV constructor
GridSearchCV(DataModel datamodel, ParamsGrid grid, Class<? extends Recommender> recommenderClass, Class<? extends QualityMeasure>[] qualityMeasuresClasses, Map<String,Object>[] qualityMeasuresParams, int cv)	GridSearchCV constructor
GridSearchCV(DataModel datamodel, ParamsGrid grid, Class<? extends Recommender> recommenderClass, Class<? extends QualityMeasure>[] qualityMeasuresClasses, Map<String,Object>[] qualityMeasuresParams, int cv, long seed)	GridSearchCV constructor
GridSearchCV(DataModel datamodel, ParamsGrid grid, Class<? extends Recommender> recommenderClass, Class<? extends QualityMeasure> qualityMeasureClass, int cv)	GridSearchCV constructor
GridSearchCV(DataModel datamodel, ParamsGrid grid, Class<? extends Recommender> recommenderClass, Class<? extends QualityMeasure> qualityMeasureClass, int cv, long seed)	GridSearchCV constructor
GridSearchCV(DataModel datamodel, ParamsGrid grid, Class<? extends Recommender> recommenderClass, Class<? extends QualityMeasure> qualityMeasureClass, Map<String,Object> qualityMeasureParams, int cv)	GridSearchCV constructor
GridSearchCV(DataModel datamodel, ParamsGrid grid, Class<? extends Recommender> recommenderClass, Class<? extends QualityMeasure> qualityMeasureClass, Map<String,Object> qualityMeasureParams, int cv, long seed)	GridSearchCV constructor

Method Summary

Methods inherited from class es.upm.etsisi.cf4j.util.optimization.RandomSearchCV

exportResults, exportResults, exportResults, exportResults, fit, getBestParams, getBestParams, getBestParams, getBestScore, getBestScore, getBestScore, printResults, printResults, printResults, printResults

Methods inherited from class java.lang.Object

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

Constructor Detail

GridSearchCV

public GridSearchCV(DataModel datamodel,
                    ParamsGrid grid,
                    Class<? extends Recommender> recommenderClass,
                    Class<? extends QualityMeasure> qualityMeasureClass,
                    int cv)

GridSearchCV constructor

Parameters:

datamodel - DataModel instance

grid - ParamsGrid instance containing the development set

recommenderClass - Recommender class to be evaluated. This class must contains a constructor with the signature Recommender.<init>(DataModel, Map<String, Object>)

qualityMeasureClass - QualityMeasure class used to evaluate the Recommender. This class must contains a constructor with the signature QualityMeasure.<init>(Recommender, Map<String, Object>)

cv - Number of folds for the cross validation

GridSearchCV

public GridSearchCV(DataModel datamodel,
                    ParamsGrid grid,
                    Class<? extends Recommender> recommenderClass,
                    Class<? extends QualityMeasure> qualityMeasureClass,
                    int cv,
                    long seed)

GridSearchCV constructor

Parameters:

datamodel - DataModel instance

grid - ParamsGrid instance containing the development set

recommenderClass - Recommender class to be evaluated. This class must contains a constructor with the signature Recommender.<init>(DataModel, Map<String, Object>)

qualityMeasureClass - QualityMeasure class used to evaluate the Recommender. This class must contains a constructor with the signature QualityMeasure.<init>(Recommender, Map<String, Object>)

cv - Number of folds for the cross validation

seed - Random seed for random numbers generation

GridSearchCV

public GridSearchCV(DataModel datamodel,
                    ParamsGrid grid,
                    Class<? extends Recommender> recommenderClass,
                    Class<? extends QualityMeasure> qualityMeasureClass,
                    Map<String,Object> qualityMeasureParams,
                    int cv)

GridSearchCV constructor

Parameters:

datamodel - DataModel instance

grid - ParamsGrid instance containing the development set

recommenderClass - Recommender class to be evaluated. This class must contains a constructor with the signature Recommender.<init>(DataModel, Map<String, Object>)

qualityMeasureClass - QualityMeasure class used to evaluate the Recommender. This class must contains a constructor with the signature QualityMeasure.<init>(Recommender, Map<String, Object>)

qualityMeasureParams - Map object containing the quality measure parameters names (keys) and values (value)

cv - Number of folds for the cross validation

GridSearchCV

public GridSearchCV(DataModel datamodel,
                    ParamsGrid grid,
                    Class<? extends Recommender> recommenderClass,
                    Class<? extends QualityMeasure> qualityMeasureClass,
                    Map<String,Object> qualityMeasureParams,
                    int cv,
                    long seed)

GridSearchCV constructor

Parameters:

datamodel - DataModel instance

grid - ParamsGrid instance containing the development set

recommenderClass - Recommender class to be evaluated. This class must contains a constructor with the signature Recommender.<init>(DataModel, Map<String, Object>)

qualityMeasureClass - QualityMeasure class used to evaluate the Recommender. This class must contains a constructor with the signature QualityMeasure.<init>(Recommender, Map<String, Object>)

qualityMeasureParams - Map object containing the quality measure parameters names (keys) and values (value)

cv - Number of folds for the cross validation

seed - Random seed for random numbers generation

GridSearchCV

public GridSearchCV(DataModel datamodel,
                    ParamsGrid grid,
                    Class<? extends Recommender> recommenderClass,
                    Class<? extends QualityMeasure>[] qualityMeasuresClasses,
                    int cv)

GridSearchCV constructor

Parameters:

datamodel - DataModel instance

grid - ParamsGrid instance containing the development set

recommenderClass - Recommender class to be evaluated. This class must contains a constructor with the signature Recommender.<init>(DataModel, Map<String, Object>)

qualityMeasuresClasses - QualityMeasure classes used to evaluate the Recommender. These classes must contain a constructor with the signature QualityMeasure.<init>(Recommender, Map<String, Object>)

cv - Number of folds for the cross validation

GridSearchCV

public GridSearchCV(DataModel datamodel,
                    ParamsGrid grid,
                    Class<? extends Recommender> recommenderClass,
                    Class<? extends QualityMeasure>[] qualityMeasuresClasses,
                    int cv,
                    long seed)

GridSearchCV constructor

Parameters:

datamodel - DataModel instance

grid - ParamsGrid instance containing the development set

recommenderClass - Recommender class to be evaluated. This class must contains a constructor with the signature Recommender.<init>(DataModel, Map<String, Object>)

qualityMeasuresClasses - QualityMeasure classes used to evaluate the Recommender. These classes must contain a constructor with the signature QualityMeasure.<init>(Recommender, Map<String, Object>)

cv - Number of folds for the cross validation

seed - Random seed for random numbers generation

GridSearchCV

public GridSearchCV(DataModel datamodel,
                    ParamsGrid grid,
                    Class<? extends Recommender> recommenderClass,
                    Class<? extends QualityMeasure>[] qualityMeasuresClasses,
                    Map<String,Object>[] qualityMeasuresParams,
                    int cv)

GridSearchCV constructor

Parameters:

datamodel - DataModel instance

grid - ParamsGrid instance containing the development set

recommenderClass - Recommender class to be evaluated. This class must contains a constructor with the signature Recommender.<init>(DataModel, Map<String, Object>)

qualityMeasuresClasses - QualityMeasure classes used to evaluate the Recommender. These classes must contain a constructor with the signature QualityMeasure.<init>(Recommender, Map<String, Object>)

qualityMeasuresParams - Maps objects containing the quality measure parameters names (keys) and values (value)

cv - Number of folds for the cross validation

GridSearchCV

public GridSearchCV(DataModel datamodel,
                    ParamsGrid grid,
                    Class<? extends Recommender> recommenderClass,
                    Class<? extends QualityMeasure>[] qualityMeasuresClasses,
                    Map<String,Object>[] qualityMeasuresParams,
                    int cv,
                    long seed)

GridSearchCV constructor

Parameters:

datamodel - DataModel instance

grid - ParamsGrid instance containing the development set

recommenderClass - Recommender class to be evaluated. This class must contains a constructor with the signature Recommender.<init>(DataModel, Map<String, Object>)

qualityMeasuresClasses - QualityMeasure classes used to evaluate the Recommender. These classes must contain a constructor with the signature QualityMeasure.<init>(Recommender, Map<String, Object>)

qualityMeasuresParams - Maps objects containing the quality measure parameters names (keys) and values (value)

cv - Number of folds for the cross validation

seed - Random seed for random numbers generation