org.grouplens.lenskit.eval.traintest

Class FunctionMultiModelMetric

java.lang.Object

org.grouplens.lenskit.eval.traintest.FunctionMultiModelMetric

All Implemented Interfaces:

Closeable, AutoCloseable, Metric<Void>

public class FunctionMultiModelMetric
extends Object
implements Metric<Void>

Model metric backed by an arbitrary function that returns multiple rows per algorithmInfo.

Since:

1.1

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FunctionMultiModelMetric.Factory

Constructor Summary

Constructors

Constructor and Description
FunctionMultiModelMetric(File file, List<String> columns, Function<Recommender,List<List<Object>>> func, org.grouplens.lenskit.eval.traintest.ExperimentOutputLayout layout)

Method Summary

Modifier and Type	Method and Description
void	close()
Void	createContext(Attributed algorithm, TTDataSet dataSet, Recommender recommender) Create the context for an experimental condition (algorithm/data set pair).
List<String>	getColumnLabels() Get labels for the aggregate columns output by this evaluator.
List<Object>	getResults(Void context) Get the aggregate results from an accumulator.
List<String>	getUserColumnLabels() Get labels for the per-user columns output by this evaluator.
List<Object>	measureUser(TestUser user, Void context) Measure a user in the evaluation.

Methods inherited from class java.lang.Object

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

Constructor Detail

FunctionMultiModelMetric

public FunctionMultiModelMetric(File file,
                                List<String> columns,
                                Function<Recommender,List<List<Object>>> func,
                                org.grouplens.lenskit.eval.traintest.ExperimentOutputLayout layout)

Method Detail

getColumnLabels

public List<String> getColumnLabels()

Description copied from interface: Metric

Get labels for the aggregate columns output by this evaluator.

Specified by:

getColumnLabels in interface Metric<Void>

Returns:

The labels for this evaluator's output, used as column headers when outputting the results table.

getUserColumnLabels

public List<String> getUserColumnLabels()

Description copied from interface: Metric

Get labels for the per-user columns output by this evaluator.

Specified by:

getUserColumnLabels in interface Metric<Void>

Returns:

The labels for this evaluator's per-user output, used as column headers when outputting the results table.

See Also:

Metric.measureUser(TestUser, Object)

createContext

@Nullable
public Void createContext(Attributed algorithm,
                                    TTDataSet dataSet,
                                    Recommender recommender)

Description copied from interface: Metric

Create the context for an experimental condition (algorithm/data set pair).

Specified by:

createContext in interface Metric<Void>

Parameters:

algorithm - The algorithm.

dataSet - The data set.

recommender - The LensKit recommender, if applicable. This can be null for an external algorithm that does not provide a LensKit recommender.

Returns:

The accumulator. This will be passed to Metric.measureUser(TestUser, Object). If the metric does not accumulate any results, this method can return null.

measureUser

@Nonnull
public List<Object> measureUser(TestUser user,
                                         Void context)

Description copied from interface: Metric

Measure a user in the evaluation.

Specified by:

measureUser in interface Metric<Void>

Parameters:

user - The user to evaluate.

context - The context for the active experimental condition.

Returns:

The table rows resulting from this user's measurement.

getResults

@Nonnull
public List<Object> getResults(Void context)

Description copied from interface: Metric

Get the aggregate results from an accumulator.

Specified by:

getResults in interface Metric<Void>

Parameters:

context - The context for an experimental condition.

Returns:

The aggregate results from the accumulator.

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException