org.apache.lucene.facet.range

Class DoubleRangeFacetCounts

java.lang.Object

org.apache.lucene.facet.Facets

org.apache.lucene.facet.range.DoubleRangeFacetCounts

public class DoubleRangeFacetCounts
extends Facets

Facets implementation that computes counts for dynamic double ranges from a provided ValueSource, using FunctionValues.doubleVal(int). Use this for dimensions that change in real-time (e.g. a relative time based dimension like "Past day", "Past 2 days", etc.) or that change for each request (e.g. distance from the user's location, "< 1 km", "< 2 km", etc.).

If you had indexed your field using FloatDocValuesField then pass FloatFieldSource as the ValueSource; if you used DoubleDocValuesField then pass DoubleFieldSource (this is the default used when you pass just a the field name).

Constructor Summary

Constructors

Constructor and Description
DoubleRangeFacetCounts(String field, FacetsCollector hits, DoubleRange... ranges) Create RangeFacetCounts, using DoubleFieldSource from the specified field.
DoubleRangeFacetCounts(String field, ValueSource valueSource, FacetsCollector hits, DoubleRange... ranges) Create RangeFacetCounts, using the provided ValueSource.
DoubleRangeFacetCounts(String field, ValueSource valueSource, FacetsCollector hits, Filter fastMatchFilter, DoubleRange... ranges) Create RangeFacetCounts, using the provided ValueSource, and using the provided Filter as a fastmatch: only documents passing the filter are checked for the matching ranges.

Method Summary

Modifier and Type	Method and Description
List<FacetResult>	getAllDims(int topN) Returns topN labels for any dimension that had hits, sorted by the number of hits that dimension matched; this is used for "sparse" faceting, where many different dimensions were indexed, for example depending on the type of document.
Number	getSpecificValue(String dim, String... path) Return the count or value for a specific path.
FacetResult	getTopChildren(int topN, String dim, String... path) Returns the topN child labels under the specified path.

Methods inherited from class java.lang.Object

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

Constructor Detail

DoubleRangeFacetCounts

public DoubleRangeFacetCounts(String field,
                              FacetsCollector hits,
                              DoubleRange... ranges)
                       throws IOException

Create RangeFacetCounts, using DoubleFieldSource from the specified field.

Throws:

IOException

DoubleRangeFacetCounts

public DoubleRangeFacetCounts(String field,
                              ValueSource valueSource,
                              FacetsCollector hits,
                              DoubleRange... ranges)
                       throws IOException

Create RangeFacetCounts, using the provided ValueSource.

Throws:

IOException

DoubleRangeFacetCounts

public DoubleRangeFacetCounts(String field,
                              ValueSource valueSource,
                              FacetsCollector hits,
                              Filter fastMatchFilter,
                              DoubleRange... ranges)
                       throws IOException

Create RangeFacetCounts, using the provided ValueSource, and using the provided Filter as a fastmatch: only documents passing the filter are checked for the matching ranges. The filter must be random access (implement DocIdSet.bits()).

Throws:

IOException

Method Detail

getTopChildren

public FacetResult getTopChildren(int topN,
                                  String dim,
                                  String... path)

Description copied from class: Facets

Returns the topN child labels under the specified path. Returns null if the specified path doesn't exist or if this dimension was never seen.

Specified by:

getTopChildren in class Facets

getSpecificValue

public Number getSpecificValue(String dim,
                               String... path)
                        throws IOException

Description copied from class: Facets

Return the count or value for a specific path. Returns -1 if this path doesn't exist, else the count.

Specified by:

getSpecificValue in class Facets

Throws:

IOException

getAllDims

public List<FacetResult> getAllDims(int topN)
                             throws IOException

Description copied from class: Facets

Returns topN labels for any dimension that had hits, sorted by the number of hits that dimension matched; this is used for "sparse" faceting, where many different dimensions were indexed, for example depending on the type of document.

Specified by:

getAllDims in class Facets

Throws:

IOException