org.terrier.learning

Class FeaturedQueryResultSet

java.lang.Object

org.terrier.matching.CollectionResultSet

org.terrier.matching.QueryResultSet

org.terrier.learning.FeaturedQueryResultSet

All Implemented Interfaces:

Serializable, FeaturedResultSet, ResultSet

public class FeaturedQueryResultSet
extends QueryResultSet
implements FeaturedResultSet

A result set implementation that accommodates multiple query feature scores, besides the original relevance scores.

Since:

4.0

Author:

Rodrygo Santos

See Also:

Serialized Form

Field Summary

Fields inherited from class org.terrier.matching.QueryResultSet

metadata, metaMap

Fields inherited from class org.terrier.matching.CollectionResultSet

arraysInitialised, docids, exactResultSize, lock, occurrences, resultSize, scores, statusCode

Constructor Summary

Constructors

Constructor and Description
FeaturedQueryResultSet(int length)
FeaturedQueryResultSet(ResultSet resultSet)

Method Summary

Methods

Modifier and Type	Method and Description
String	getDefaultLabel()
String[]	getFeatureNames() Gets the names of the features that have been added to this ResultSet
double[]	getFeatureScores(int id) Get the feature scores for a given feature id
double[]	getFeatureScores(String name) Get all scores for the enabled docids given a feature name
String[]	getLabels()
int	getNumberOfFeatures() Number of features decorated for this resultset
ResultSet	getResultSet(int[] positions) Extracts a subset of the resultset given by the list parameter, which contains a list of positions in the resultset that should be saved.
ResultSet	getResultSet(int startPosition, int length) Crops the existing result file and extracts a subset from the given starting point to the ending point.
protected QueryResultSet	makeNewResultSet(int length)
void	putFeatureScores(String name, double[] scores) Add a feature to this result set
void	setDefaultLabel(String defLabel)
void	setLabels(String[] labels)

Methods inherited from class org.terrier.matching.QueryResultSet

addMetaItem, addMetaItems, addMetaType, getMetaItem, getMetaItems, getMetaKeys, hasMetaItems, initialise

Methods inherited from class org.terrier.matching.CollectionResultSet

getDocids, getExactResultSize, getLock, getOccurrences, getResultSize, getScores, getStatusCode, initialise, setExactResultSize, setResultSize, setStatusCode, sort, sort

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.terrier.matching.ResultSet

addMetaItem, addMetaItems, getDocids, getExactResultSize, getLock, getMetaItem, getMetaItems, getMetaKeys, getOccurrences, getResultSize, getScores, getStatusCode, hasMetaItems, initialise, initialise, setExactResultSize, setResultSize, setStatusCode, sort, sort

Constructor Detail

FeaturedQueryResultSet

public FeaturedQueryResultSet(ResultSet resultSet)

FeaturedQueryResultSet

public FeaturedQueryResultSet(int length)

Method Detail

getFeatureNames

public String[] getFeatureNames()

Gets the names of the features that have been added to this ResultSet

Specified by:

getFeatureNames in interface FeaturedResultSet

setLabels

public void setLabels(String[] labels)

Specified by:

setLabels in interface FeaturedResultSet

getLabels

public String[] getLabels()

Specified by:

getLabels in interface FeaturedResultSet

setDefaultLabel

public void setDefaultLabel(String defLabel)

Specified by:

setDefaultLabel in interface FeaturedResultSet

getDefaultLabel

public String getDefaultLabel()

Specified by:

getDefaultLabel in interface FeaturedResultSet

putFeatureScores

public void putFeatureScores(String name,
                    double[] scores)

Add a feature to this result set

Specified by:

putFeatureScores in interface FeaturedResultSet

getFeatureScores

public double[] getFeatureScores(String name)

Get all scores for the enabled docids given a feature name

Specified by:

getFeatureScores in interface FeaturedResultSet

getFeatureScores

public double[] getFeatureScores(int id)

Get the feature scores for a given feature id

Specified by:

getFeatureScores in interface FeaturedResultSet

getNumberOfFeatures

public int getNumberOfFeatures()

Number of features decorated for this resultset

Specified by:

getNumberOfFeatures in interface FeaturedResultSet

getResultSet

public ResultSet getResultSet(int startPosition,
                     int length)

Crops the existing result file and extracts a subset from the given starting point to the ending point.

Specified by:

getResultSet in interface ResultSet

Overrides:

getResultSet in class QueryResultSet

Parameters:

startPosition - the beginning of the subset.

length - the number of entries to get.

Returns:

a subset of the current result set.

getResultSet

public ResultSet getResultSet(int[] positions)

Extracts a subset of the resultset given by the list parameter, which contains a list of positions in the resultset that should be saved.

Specified by:

getResultSet in interface ResultSet

Overrides:

getResultSet in class QueryResultSet

Parameters:

positions - int[] the list of elements in the current list that should be kept.

Returns:

a subset of the current result set specified by the list.

makeNewResultSet

protected QueryResultSet makeNewResultSet(int length)

Overrides:

makeNewResultSet in class QueryResultSet