Package org.terrier.matching

Class FatFeaturedScoringMatching

java.lang.Object

org.terrier.matching.FilterMatching

org.terrier.matching.FeaturedScoringMatching

org.terrier.matching.FatFeaturedScoringMatching

All Implemented Interfaces:

Matching

public class FatFeaturedScoringMatching
extends FeaturedScoringMatching

Makes a FeaturedResultSet by applying a list of features. The input from a parent matching class is a FatResultSet.

Feature names have a particular format:

• WMODEL: defines a weighting model for all matching query terms (or other operator), i.e. a query dependent feature.
• WMODELt: defines a weighting model for all matching single terms, i.e. a query dependent feature.
• WMODELp1: defines a weighting model for all matching #1 proximity ops (query dependent).
• WMODELuw8: defines a weighting model for all matching #uw8 proxity op (query dependent).
• WMODEL$tag: defines a weighting model for all the matching op tagged "tag" - see #tag() in the MatchOp ql (query dependent).
• QI: defined a weighting model called once for each matching document, i.e. a query independent feature.
• DSM: applies a document score modifier.
• SAMPLE the scoring method used by the parent Matching class becomes a feature.

Properties:

• fat.featured.scoring.matching.features - a semicolon delimited list of features OR the word FILE to load the feature list from a file.
• fat.featured.scoring.matching.features.file - a filename containing a newline delimited list of feature.

See also: "About Learning Models with Multiple Query Dependent Features. Craig Macdonald, Rodrygo L.T. Santos, Iadh Ounis and Ben He. Transactions on Information Systems. 31(3). 2013. [PDF]

Since:

4.0

Author:

Craig Macdonald

Field Summary

Fields inherited from class org.terrier.matching.FeaturedScoringMatching

dsmNames, dsms, filterOW, filterProx, filterTerm, filterUW, index, logger, qiFeatureNames, qiFeatures, sampleFeature, scoringMatchingImpl, wModelNames, wModels

Fields inherited from class org.terrier.matching.FilterMatching

parent

Constructor Summary

Constructors

Constructor	Description
FatFeaturedScoringMatching(Index _index, Matching _parent)
FatFeaturedScoringMatching(Index _index, Matching _parent, java.lang.String[] _featureNames)

Method Summary

Modifier and Type	Method	Description
ResultSet	doMatch(java.lang.String queryNumber, MatchingQueryTerms queryTerms, ResultSet res, boolean keepInputScores)
ResultSet	match(java.lang.String queryNumber, MatchingQueryTerms queryTerms)	Get a ResultSet for the given query terms.

Methods inherited from class org.terrier.matching.FeaturedScoringMatching

applyDSMs, getInfo, getModelNames, getModelNames, getTagPredictate, loadFeatures, setCollectionStatistics

Methods inherited from class org.terrier.matching.FilterMatching

doMatch

Methods inherited from class java.lang.Object

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

Constructor Detail

FatFeaturedScoringMatching

public FatFeaturedScoringMatching(Index _index,
                                  Matching _parent,
                                  java.lang.String[] _featureNames)
                           throws java.lang.Exception

Throws:

java.lang.Exception

FatFeaturedScoringMatching

public FatFeaturedScoringMatching(Index _index,
                                  Matching _parent)
                           throws java.lang.Exception

Throws:

java.lang.Exception

Method Detail

doMatch

public ResultSet doMatch(java.lang.String queryNumber,
                         MatchingQueryTerms queryTerms,
                         ResultSet res,
                         boolean keepInputScores)
                  throws java.io.IOException

Specified by:

doMatch in class FilterMatching

Throws:

java.io.IOException

match

public ResultSet match(java.lang.String queryNumber,
                       MatchingQueryTerms queryTerms)
                throws java.io.IOException

Description copied from interface: Matching

Get a ResultSet for the given query terms.

Specified by:

match in interface Matching

Overrides:

match in class FilterMatching

Parameters:

queryNumber - - some ID of the query

queryTerms - - query terms to match

Returns:

ResultSet - the matched results

Throws:

java.io.IOException - if a problem occurs during matching