XMoreLikeThis (Elasticsearch: Core 2.3.5.1 API)

java.lang.Object
- org.elasticsearch.common.lucene.search.XMoreLikeThis

public final class XMoreLikeThis
extends Object

Generate "more like this" similarity queries. Based on this mail:

 Lucene does let you access the document frequency of terms, with IndexReader.docFreq().
 Term frequencies can be computed by re-tokenizing the text, which, for a single document,
 is usually fast enough.  But looking up the docFreq() of every term in the document is
 probably too slow.
 You can use some heuristics to prune the set of terms, to avoid calling docFreq() too much,
 or at all.  Since you're trying to maximize a tf*idf score, you're probably most interested
 in terms with a high tf. Choosing a tf threshold even as low as two or three will radically
 reduce the number of terms under consideration.  Another heuristic is that terms with a
 high idf (i.e., a low df) tend to be longer.  So you could threshold the terms by the
 number of characters, not selecting anything less than, e.g., six or seven characters.
 With these sorts of heuristics you can usually find small set of, e.g., ten or fewer terms
 that do a pretty good job of characterizing a document.
 It all depends on what you're trying to do.  If you're trying to eek out that last percent
 of precision and recall regardless of computational difficulty so that you can win a TREC
 competition, then the techniques I mention above are useless.  But if you're trying to
 provide a "more like this" button on a search results page that does a decent job and has
 good performance, such techniques might be useful.
 An efficient, effective "more-like-this" query generator would be a great contribution, if
 anyone's interested.  I'd imagine that it would take a Reader or a String (the document's
 text), analyzer Analyzer, and return a set of representative terms using heuristics like those
 above.  The frequency and length thresholds could be parameters, etc.
 Doug

Initial Usage

This class has lots of options to try to make it efficient and flexible. The simplest possible usage is as follows. The bold fragment is specific to this class.

 IndexReader ir = ...
 IndexSearcher is = ...

 MoreLikeThis mlt = new MoreLikeThis(ir);
 Reader target = ... // orig source of doc you want to find similarities to
 Query query = mlt.like( target);

 Hits hits = is.search(query);
 // now the usual iteration thru 'hits' - the only thing to watch for is to make sure
 //you ignore the doc if it matches your 'target' document, as it should be similar to itself

Thus you:

do your normal, Lucene setup for searching,
create a MoreLikeThis,
get the text of the doc you want to find similarities to
then call one of the like() calls to generate a similarity query
call the searcher to find the similar docs

More Advanced Usage

You may want to use setFieldNames(...) so you can examine multiple fields (e.g. body and title) for similarity.

Depending on the size of your index and the size and makeup of your documents you may want to call the other set methods to control how the similarity queries are generated:

 Changes: Mark Harwood 29/02/04
 Some bugfixing, some refactoring, some optimisation.
 - bugfix: retrieveTerms(int docNum) was not working for indexes without a termvector -added missing code
 - bugfix: No significant terms being created for fields with a termvector - because
 was only counting one occurrence per term/field pair in calculations(ie not including frequency info from TermVector)
 - refactor: moved common code into isNoiseWord()
 - optimise: when no termvector support available - used maxNumTermsParsed to limit amount of tokenization

フィールドのサマリー

フィールド
修飾子とタイプ	フィールドと説明
`static boolean`	`DEFAULT_BOOST` Boost terms in query based on score.
`static String[]`	`DEFAULT_FIELD_NAMES` Default field names.
`static int`	`DEFAULT_MAX_DOC_FREQ` Ignore words which occur in more than this many docs.
`static int`	`DEFAULT_MAX_NUM_TOKENS_PARSED` Default maximum number of tokens to parse in each example doc field that is not stored with TermVector support.
`static int`	`DEFAULT_MAX_QUERY_TERMS` Return a Query with no more than this many terms.
`static int`	`DEFAULT_MAX_WORD_LENGTH` Ignore words greater than this length or if 0 then this has no effect.
`static int`	`DEFAULT_MIN_DOC_FREQ` Ignore words which do not occur in at least this many docs.
`static int`	`DEFAULT_MIN_TERM_FREQ` Ignore terms with less than this frequency in the source doc.
`static int`	`DEFAULT_MIN_WORD_LENGTH` Ignore words less than this length or if 0 then this has no effect.
`static Set<?>`	`DEFAULT_STOP_WORDS` Default set of stopwords.

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`XMoreLikeThis(org.apache.lucene.index.IndexReader ir)` Constructor requiring an IndexReader.
`XMoreLikeThis(org.apache.lucene.index.IndexReader ir, org.apache.lucene.search.similarities.TFIDFSimilarity sim)`

メソッドのサマリー

すべてのメソッドインスタンス・メソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`String`	`describeParams()` Describe the parameters that control how the "more like this" query is formed.
`org.apache.lucene.analysis.Analyzer`	`getAnalyzer()` Returns an analyzer that will be used to parse source doc with.
`float`	`getBoostFactor()` Returns the boost factor used when boosting terms
`String[]`	`getFieldNames()` Returns the field names that will be used when generating the 'More Like This' query.
`int`	`getMaxDocFreq()` Returns the maximum frequency in which words may still appear.
`int`	`getMaxNumTokensParsed()`
`int`	`getMaxQueryTerms()` Returns the maximum number of query terms that will be included in any generated query.
`int`	`getMaxWordLen()` Returns the maximum word length above which words will be ignored.
`int`	`getMinDocFreq()` Returns the frequency at which words will be ignored which do not occur in at least this many docs.
`int`	`getMinTermFreq()` Returns the frequency below which terms will be ignored in the source doc.
`int`	`getMinWordLen()` Returns the minimum word length below which words will be ignored.
`org.apache.lucene.search.similarities.TFIDFSimilarity`	`getSimilarity()`
`Set<?>`	`getStopWords()` Get the current stop words being used.
`boolean`	`isBoost()` Returns whether to boost terms in query based on "score" or not.
`org.apache.lucene.search.Query`	`like(org.apache.lucene.index.Fields... likeFields)` Return a query that will return docs like the passed Fields.
`org.apache.lucene.search.Query`	`like(int docNum)` Return a query that will return docs like the passed lucene document ID.
`org.apache.lucene.search.Query`	`like(String fieldName, Reader... readers)` Return a query that will return docs like the passed Readers.
`org.apache.lucene.search.Query`	`like(org.apache.lucene.index.Terms... likeTerms)` Return a query that will return docs like the passed Terms.
`String[]`	`retrieveInterestingTerms(int docNum)`
`String[]`	`retrieveInterestingTerms(Reader r, String fieldName)` Convenience routine to make it easy to return the most interesting words in a document.
`void`	`setAnalyzer(org.apache.lucene.analysis.Analyzer analyzer)` Sets the analyzer to use.
`void`	`setBoost(boolean boost)` Sets whether to boost terms in query based on "score" or not.
`void`	`setBoostFactor(float boostFactor)` Sets the boost factor to use when boosting terms
`void`	`setFieldNames(String[] fieldNames)` Sets the field names that will be used when generating the 'More Like This' query.
`void`	`setMaxDocFreq(int maxFreq)` Set the maximum frequency in which words may still appear.
`void`	`setMaxDocFreqPct(int maxPercentage)` Set the maximum percentage in which words may still appear.
`void`	`setMaxNumTokensParsed(int i)`
`void`	`setMaxQueryTerms(int maxQueryTerms)` Sets the maximum number of query terms that will be included in any generated query.
`void`	`setMaxWordLen(int maxWordLen)` Sets the maximum word length above which words will be ignored.
`void`	`setMinDocFreq(int minDocFreq)` Sets the frequency at which words will be ignored which do not occur in at least this many docs.
`void`	`setMinTermFreq(int minTermFreq)` Sets the frequency below which terms will be ignored in the source doc.
`void`	`setMinWordLen(int minWordLen)` Sets the minimum word length below which words will be ignored.
`void`	`setSimilarity(org.apache.lucene.search.similarities.TFIDFSimilarity similarity)`
`void`	`setSkipTerms(Set<org.apache.lucene.index.Term> skipTerms)` Sets a list of terms to never select from
`void`	`setStopWords(Set<?> stopWords)` Set the set of stopwords.

クラスから継承されたメソッド java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - DEFAULT_MAX_NUM_TOKENS_PARSED
```
public static final int DEFAULT_MAX_NUM_TOKENS_PARSED
```
    Default maximum number of tokens to parse in each example doc field that is not stored with TermVector support.
    
    関連項目:
    
    getMaxNumTokensParsed(), 定数フィールド値
  - DEFAULT_MIN_TERM_FREQ
```
public static final int DEFAULT_MIN_TERM_FREQ
```
    Ignore terms with less than this frequency in the source doc.
    
    関連項目:
    
    getMinTermFreq(), setMinTermFreq(int), 定数フィールド値
  - DEFAULT_MIN_DOC_FREQ
```
public static final int DEFAULT_MIN_DOC_FREQ
```
    Ignore words which do not occur in at least this many docs.
    
    関連項目:
    
    getMinDocFreq(), setMinDocFreq(int), 定数フィールド値
  - DEFAULT_MAX_DOC_FREQ
```
public static final int DEFAULT_MAX_DOC_FREQ
```
    Ignore words which occur in more than this many docs.
    
    関連項目:
    
    getMaxDocFreq(), setMaxDocFreq(int), setMaxDocFreqPct(int), 定数フィールド値
  - DEFAULT_BOOST
```
public static final boolean DEFAULT_BOOST
```
    Boost terms in query based on score.
    
    関連項目:
    
    isBoost(), setBoost(boolean), 定数フィールド値
  - DEFAULT_FIELD_NAMES
```
public static final String[] DEFAULT_FIELD_NAMES
```
    Default field names. Null is used to specify that the field names should be looked up at runtime from the provided reader.
  - DEFAULT_MIN_WORD_LENGTH
```
public static final int DEFAULT_MIN_WORD_LENGTH
```
    Ignore words less than this length or if 0 then this has no effect.
    
    関連項目:
    
    getMinWordLen(), setMinWordLen(int), 定数フィールド値
  - DEFAULT_MAX_WORD_LENGTH
```
public static final int DEFAULT_MAX_WORD_LENGTH
```
    Ignore words greater than this length or if 0 then this has no effect.
    
    関連項目:
    
    getMaxWordLen(), setMaxWordLen(int), 定数フィールド値
  - DEFAULT_STOP_WORDS
```
public static final Set<?> DEFAULT_STOP_WORDS
```
    Default set of stopwords. If null means to allow stop words.
    
    関連項目:
    
    setStopWords(java.util.Set<?>), getStopWords()
  - DEFAULT_MAX_QUERY_TERMS
```
public static final int DEFAULT_MAX_QUERY_TERMS
```
    Return a Query with no more than this many terms.
    
    関連項目:
    
    BooleanQuery.getMaxClauseCount(), getMaxQueryTerms(), setMaxQueryTerms(int), 定数フィールド値
- コンストラクタの詳細
  - XMoreLikeThis
```
public XMoreLikeThis(org.apache.lucene.index.IndexReader ir)
```
    Constructor requiring an IndexReader.
  - XMoreLikeThis
```
public XMoreLikeThis(org.apache.lucene.index.IndexReader ir,
                     org.apache.lucene.search.similarities.TFIDFSimilarity sim)
```
- メソッドの詳細
  - getBoostFactor
```
public float getBoostFactor()
```
    Returns the boost factor used when boosting terms
    
    戻り値:
    
    the boost factor used when boosting terms
    
    関連項目:
    
    setBoostFactor(float)
  - setBoostFactor
```
public void setBoostFactor(float boostFactor)
```
    Sets the boost factor to use when boosting terms
    
    関連項目:
    
    getBoostFactor()
  - setSkipTerms
```
public void setSkipTerms(Set<org.apache.lucene.index.Term> skipTerms)
```
    Sets a list of terms to never select from
  - getSimilarity
```
public org.apache.lucene.search.similarities.TFIDFSimilarity getSimilarity()
```
  - setSimilarity
```
public void setSimilarity(org.apache.lucene.search.similarities.TFIDFSimilarity similarity)
```
  - getAnalyzer
```
public org.apache.lucene.analysis.Analyzer getAnalyzer()
```
    Returns an analyzer that will be used to parse source doc with. The default analyzer is not set.
    
    戻り値:
    
    the analyzer that will be used to parse source doc with.
  - setAnalyzer
```
public void setAnalyzer(org.apache.lucene.analysis.Analyzer analyzer)
```
    Sets the analyzer to use. An analyzer is not required for generating a query with the like(int) method, all other 'like' methods require an analyzer.
    
    パラメータ:
    
    analyzer - the analyzer to use to tokenize text.
  - getMinTermFreq
```
public int getMinTermFreq()
```
    Returns the frequency below which terms will be ignored in the source doc. The default frequency is the DEFAULT_MIN_TERM_FREQ.
    
    戻り値:
    
    the frequency below which terms will be ignored in the source doc.
  - setMinTermFreq
```
public void setMinTermFreq(int minTermFreq)
```
    Sets the frequency below which terms will be ignored in the source doc.
    
    パラメータ:
    
    minTermFreq - the frequency below which terms will be ignored in the source doc.
  - getMinDocFreq
```
public int getMinDocFreq()
```
    Returns the frequency at which words will be ignored which do not occur in at least this many docs. The default frequency is DEFAULT_MIN_DOC_FREQ.
    
    戻り値:
    
    the frequency at which words will be ignored which do not occur in at least this many docs.
  - setMinDocFreq
```
public void setMinDocFreq(int minDocFreq)
```
    Sets the frequency at which words will be ignored which do not occur in at least this many docs.
    
    パラメータ:
    
    minDocFreq - the frequency at which words will be ignored which do not occur in at least this many docs.
  - getMaxDocFreq
```
public int getMaxDocFreq()
```
    Returns the maximum frequency in which words may still appear. Words that appear in more than this many docs will be ignored. The default frequency is DEFAULT_MAX_DOC_FREQ.
    
    戻り値:
    
    get the maximum frequency at which words are still allowed, words which occur in more docs than this are ignored.
  - setMaxDocFreq
```
public void setMaxDocFreq(int maxFreq)
```
    Set the maximum frequency in which words may still appear. Words that appear in more than this many docs will be ignored.
    
    パラメータ:
    
    maxFreq - the maximum count of documents that a term may appear in to be still considered relevant
  - setMaxDocFreqPct
```
public void setMaxDocFreqPct(int maxPercentage)
```
    Set the maximum percentage in which words may still appear. Words that appear in more than this many percent of all docs will be ignored.
    
    パラメータ:
    
    maxPercentage - the maximum percentage of documents (0-100) that a term may appear in to be still considered relevant
  - isBoost
```
public boolean isBoost()
```
    Returns whether to boost terms in query based on "score" or not. The default is DEFAULT_BOOST.
    
    戻り値:
    
    whether to boost terms in query based on "score" or not.
    
    関連項目:
    
    setBoost(boolean)
  - setBoost
```
public void setBoost(boolean boost)
```
    Sets whether to boost terms in query based on "score" or not.
    
    パラメータ:
    
    boost - true to boost terms in query based on "score", false otherwise.
    
    関連項目:
    
    isBoost()
  - getFieldNames
```
public String[] getFieldNames()
```
    Returns the field names that will be used when generating the 'More Like This' query. The default field names that will be used is DEFAULT_FIELD_NAMES.
    
    戻り値:
    
    the field names that will be used when generating the 'More Like This' query.
  - setFieldNames
```
public void setFieldNames(String[] fieldNames)
```
    Sets the field names that will be used when generating the 'More Like This' query. Set this to null for the field names to be determined at runtime from the IndexReader provided in the constructor.
    
    パラメータ:
    
    fieldNames - the field names that will be used when generating the 'More Like This' query.
  - getMinWordLen
```
public int getMinWordLen()
```
    Returns the minimum word length below which words will be ignored. Set this to 0 for no minimum word length. The default is DEFAULT_MIN_WORD_LENGTH.
    
    戻り値:
    
    the minimum word length below which words will be ignored.
  - setMinWordLen
```
public void setMinWordLen(int minWordLen)
```
    Sets the minimum word length below which words will be ignored.
    
    パラメータ:
    
    minWordLen - the minimum word length below which words will be ignored.
  - getMaxWordLen
```
public int getMaxWordLen()
```
    Returns the maximum word length above which words will be ignored. Set this to 0 for no maximum word length. The default is DEFAULT_MAX_WORD_LENGTH.
    
    戻り値:
    
    the maximum word length above which words will be ignored.
  - setMaxWordLen
```
public void setMaxWordLen(int maxWordLen)
```
    Sets the maximum word length above which words will be ignored.
    
    パラメータ:
    
    maxWordLen - the maximum word length above which words will be ignored.
  - setStopWords
```
public void setStopWords(Set<?> stopWords)
```
    Set the set of stopwords. Any word in this set is considered "uninteresting" and ignored. Even if your Analyzer allows stopwords, you might want to tell the MoreLikeThis code to ignore them, as for the purposes of document similarity it seems reasonable to assume that "a stop word is never interesting".
    
    パラメータ:
    
    stopWords - set of stopwords, if null it means to allow stop words
    
    関連項目:
    
    getStopWords()
  - getStopWords
```
public Set<?> getStopWords()
```
    Get the current stop words being used.
    
    関連項目:
    
    setStopWords(java.util.Set<?>)
  - getMaxQueryTerms
```
public int getMaxQueryTerms()
```
    Returns the maximum number of query terms that will be included in any generated query. The default is DEFAULT_MAX_QUERY_TERMS.
    
    戻り値:
    
    the maximum number of query terms that will be included in any generated query.
  - setMaxQueryTerms
```
public void setMaxQueryTerms(int maxQueryTerms)
```
    Sets the maximum number of query terms that will be included in any generated query.
    
    パラメータ:
    
    maxQueryTerms - the maximum number of query terms that will be included in any generated query.
  - getMaxNumTokensParsed
```
public int getMaxNumTokensParsed()
```
    戻り値:
    
    The maximum number of tokens to parse in each example doc field that is not stored with TermVector support
    
    関連項目:
    
    DEFAULT_MAX_NUM_TOKENS_PARSED
  - setMaxNumTokensParsed
```
public void setMaxNumTokensParsed(int i)
```
    パラメータ:
    
    i - The maximum number of tokens to parse in each example doc field that is not stored with TermVector support
  - like
```
public org.apache.lucene.search.Query like(int docNum)
                                    throws IOException
```
    Return a query that will return docs like the passed lucene document ID.
    
    パラメータ:
    
    docNum - the documentID of the lucene doc to generate the 'More Like This" query for.
    
    戻り値:
    
    a query that will return docs like the passed lucene document ID.
    
    例外:
    
    IOException
  - like
```
public org.apache.lucene.search.Query like(String fieldName,
                                           Reader... readers)
                                    throws IOException
```
    Return a query that will return docs like the passed Readers. This was added in order to treat multi-value fields.
    
    戻り値:
    
    a query that will return docs like the passed Readers.
    
    例外:
    
    IOException
  - like
```
public org.apache.lucene.search.Query like(org.apache.lucene.index.Terms... likeTerms)
                                    throws IOException
```
    Return a query that will return docs like the passed Terms.
    
    戻り値:
    
    a query that will return docs like the passed Terms.
    
    例外:
    
    IOException
  - like
```
public org.apache.lucene.search.Query like(org.apache.lucene.index.Fields... likeFields)
                                    throws IOException
```
    Return a query that will return docs like the passed Fields.
    
    戻り値:
    
    a query that will return docs like the passed Fields.
    
    例外:
    
    IOException
  - describeParams
```
public String describeParams()
```
    Describe the parameters that control how the "more like this" query is formed.
  - retrieveInterestingTerms
```
public String[] retrieveInterestingTerms(int docNum)
                                  throws IOException
```
    例外:
    
    IOException
    
    関連項目:
    
    retrieveInterestingTerms(java.io.Reader, String)
  - retrieveInterestingTerms
```
public String[] retrieveInterestingTerms(Reader r,
                                         String fieldName)
                                  throws IOException
```
    Convenience routine to make it easy to return the most interesting words in a document. More advanced users will call retrieveTerms() directly.
    
    パラメータ:
    
    r - the source document
    
    fieldName - field passed to analyzer to use when analyzing the content
    
    戻り値:
    
    the most interesting words in the document
    
    例外:
    
    IOException
    
    関連項目:
    
    retrieveTerms(java.io.Reader, String), setMaxQueryTerms(int)

クラス XMoreLikeThis

Initial Usage

More Advanced Usage

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラスから継承されたメソッド java.lang.Object

フィールドの詳細

DEFAULT_MAX_NUM_TOKENS_PARSED

DEFAULT_MIN_TERM_FREQ

DEFAULT_MIN_DOC_FREQ

DEFAULT_MAX_DOC_FREQ

DEFAULT_BOOST

DEFAULT_FIELD_NAMES

DEFAULT_MIN_WORD_LENGTH

DEFAULT_MAX_WORD_LENGTH

DEFAULT_STOP_WORDS

DEFAULT_MAX_QUERY_TERMS

コンストラクタの詳細

XMoreLikeThis

XMoreLikeThis

メソッドの詳細

getBoostFactor

setBoostFactor

setSkipTerms

getSimilarity

setSimilarity

getAnalyzer

setAnalyzer

getMinTermFreq

setMinTermFreq

getMinDocFreq

setMinDocFreq

getMaxDocFreq

setMaxDocFreq

setMaxDocFreqPct

isBoost

setBoost

getFieldNames

setFieldNames

getMinWordLen

setMinWordLen

getMaxWordLen

setMaxWordLen

setStopWords

getStopWords

getMaxQueryTerms

setMaxQueryTerms

getMaxNumTokensParsed

setMaxNumTokensParsed

like

like

like

like

describeParams

retrieveInterestingTerms

retrieveInterestingTerms