org.elasticsearch.search.aggregations.bucket.significant.heuristics

Class SignificanceHeuristic

java.lang.Object

org.elasticsearch.search.aggregations.bucket.significant.heuristics.SignificanceHeuristic

All Implemented Interfaces:

NamedWriteable, Writeable, ToXContent

Direct Known Subclasses:

JLHScore, NXYSignificanceHeuristic, PercentageScore, ScriptHeuristic

public abstract class SignificanceHeuristic
extends java.lang.Object
implements NamedWriteable, ToXContent

Heuristic for that SignificantTerms uses to pick out significant terms.

Nested Class Summary

Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Nested classes/interfaces inherited from interface org.elasticsearch.common.xcontent.ToXContent

ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params

Field Summary

Fields inherited from interface org.elasticsearch.common.xcontent.ToXContent

EMPTY_PARAMS

Constructor Summary

Constructors

Constructor and Description
SignificanceHeuristic()

Method Summary

Modifier and Type	Method and Description
protected void	checkFrequencyValidity(long subsetFreq, long subsetSize, long supersetFreq, long supersetSize, java.lang.String scoreFunctionName)
abstract double	getScore(long subsetFreq, long subsetSize, long supersetFreq, long supersetSize)
SignificanceHeuristic	rewrite(InternalAggregation.ReduceContext reduceContext) Provides a hook for subclasses to provide a version of the heuristic prepared for execution on data on the coordinating node.
SignificanceHeuristic	rewrite(SearchContext context) Provides a hook for subclasses to provide a version of the heuristic prepared for execution on data on a shard.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.elasticsearch.common.io.stream.NamedWriteable

getWriteableName

Methods inherited from interface org.elasticsearch.common.io.stream.Writeable

writeTo

Methods inherited from interface org.elasticsearch.common.xcontent.ToXContent

isFragment, toXContent

Constructor Detail

SignificanceHeuristic

public SignificanceHeuristic()

Method Detail

getScore

public abstract double getScore(long subsetFreq,
                                long subsetSize,
                                long supersetFreq,
                                long supersetSize)

Parameters:

subsetFreq - The frequency of the term in the selected sample

subsetSize - The size of the selected sample (typically number of docs)

supersetFreq - The frequency of the term in the superset from which the sample was taken

supersetSize - The size of the superset from which the sample was taken (typically number of docs)

Returns:

a "significance" score

checkFrequencyValidity

protected void checkFrequencyValidity(long subsetFreq,
                                      long subsetSize,
                                      long supersetFreq,
                                      long supersetSize,
                                      java.lang.String scoreFunctionName)

rewrite

public SignificanceHeuristic rewrite(InternalAggregation.ReduceContext reduceContext)

Provides a hook for subclasses to provide a version of the heuristic prepared for execution on data on the coordinating node.

Parameters:

reduceContext - the reduce context on the coordinating node

Returns:

a version of this heuristic suitable for execution

rewrite

public SignificanceHeuristic rewrite(SearchContext context)

Provides a hook for subclasses to provide a version of the heuristic prepared for execution on data on a shard.

Parameters:

context - the search context on the data node

Returns:

a version of this heuristic suitable for execution