java.lang.Object
org.apache.lucene.facet.Facets
org.apache.lucene.facet.taxonomy.TaxonomyFacets
- Direct Known Subclasses:
FastTaxonomyFacetCounts
,FloatTaxonomyFacets
,IntTaxonomyFacets
Deprecated.
Base class for all taxonomy-based facets impls.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprivate class
Deprecated.protected static class
Deprecated.An accumulator for an aggregated value.private static class
Deprecated.(package private) static class
Deprecated.Intermediate result to store top children for a given path before resolving labels, etc. -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate ParallelTaxonomyArrays.IntArray
Deprecated.Maps parent ordinal to its child, or -1 if the parent is childless.protected final FacetsConfig
Deprecated.FacetsConfig
provided to the constructor.(package private) int[]
Deprecated.Dense ordinal counts.(package private) final FacetsCollector
Deprecated.FacetsCollector
provided to the constructor.protected final String
Deprecated.Index field name provided to the constructor.(package private) boolean
Deprecated.Have value counters been initialized.(package private) final ParallelTaxonomyArrays.IntArray
Deprecated.Maps an ordinal to its parent, or -1 if there is no parent (root node).private ParallelTaxonomyArrays.IntArray
Deprecated.Maps an ordinal to its sibling, or -1 if there is no sibling.(package private) IntIntHashMap
Deprecated.Sparse ordinal counts.protected final TaxonomyReader
Deprecated.TaxonomyReader
provided to the constructor.protected Comparator
<Number> Deprecated.Defines comparison between aggregated values. -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotected
TaxonomyFacets
(String indexFieldName, TaxonomyReader taxoReader, FacetsConfig config) Deprecated.To be removed in Lucene 10.(package private)
TaxonomyFacets
(String indexFieldName, TaxonomyReader taxoReader, FacetsConfig config, FacetsCollector fc) Deprecated.Constructor with aFacetsCollector
, allowing lazy initialization of internal data structures. -
Method Summary
Modifier and TypeMethodDescriptionprotected Number
Deprecated.Apply an aggregation to the two values and return the result.boolean
Deprecated.Returns true if the (costly, and lazily initialized) children int[] was initialized.private FacetResult
createFacetResult
(TaxonomyFacets.TopChildrenForPath topChildrenForPath, String dim, String... path) Deprecated.Create a FacetResult for the provided dim + path and intermediate results.protected Number
getAggregationValue
(int ordinal) Deprecated.Get the aggregation value for this ordinal.getAllChildren
(String dim, String... path) Deprecated.Returns all child labels with non-zero counts under the specified path.getAllDims
(int topN) Deprecated.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.(package private) ParallelTaxonomyArrays.IntArray
Deprecated.Returns int[] mapping each ordinal to its first child; this is a large array and is computed (and then saved) the first time this method is invoked.protected int
getCount
(int ordinal) Deprecated.Get the count for this ordinal.(package private) ParallelTaxonomyArrays.IntArray
Deprecated.Returns int[] mapping each ordinal to its next sibling; this is a large array and is computed (and then saved) the first time this method is invoked.getSpecificValue
(String dim, String... path) Deprecated.Return the count or value for a specific path.getTopChildren
(int topN, String dim, String... path) Deprecated.Returns the topN child labels under the specified path.protected TaxonomyFacets.TopChildrenForPath
getTopChildrenForPath
(FacetsConfig.DimConfig dimConfig, int pathOrd, int topN) Deprecated.Determine the top-n children for a specified dimension + path.getTopDims
(int topNDims, int topNChildren) Deprecated.Returns labels for topN dimensions and their topNChildren sorted by the number of hits/aggregated values that dimension matched.(package private) boolean
Deprecated.Were any values actually aggregated during counting?protected void
Deprecated.If not done already, initialize the data structures storing counts.protected TopOrdAndNumberQueue.OrdAndValue
insertIntoQueue
(TopOrdAndNumberQueue q, TopOrdAndNumberQueue.OrdAndValue incomingOrdAndValue, int ord) Deprecated.Insert an ordinal and the value corresponding to it into the queue.protected TopOrdAndNumberQueue
makeTopOrdAndNumberQueue
(int topN) Deprecated.Return aTopOrdAndNumberQueue
of the appropriate type, i.e.protected Number
Deprecated.Return the value for a missing aggregation, i.e.protected TaxonomyFacets.AggregatedValue
Deprecated.Initialize an accumulator.protected void
rollup()
Deprecated.Rolls up any single-valued hierarchical dimensions.private int
rollup
(int ord) Deprecated.protected void
setCount
(int ordinal, int newValue) Deprecated.Set the count for this ordinal tonewValue
.protected void
setIncomingValue
(TopOrdAndNumberQueue.OrdAndValue incomingOrdAndValue, int ord) Deprecated.Set the value for aTopOrdAndNumberQueue.OrdAndValue
to the one corresponding to the given ordinal.boolean
Deprecated.Returns true if the (costly, and lazily initialized) sibling int[] was initialized.protected void
updateValueFromRollup
(int ordinal, int childOrdinal) Deprecated.Roll-up the aggregation values fromchildOrdinal
toordinal
.protected boolean
useHashTable
(FacetsCollector fc, TaxonomyReader taxoReader) Deprecated.Return true if a sparse hash table should be used for counting, instead of a dense int[].protected FacetsConfig.DimConfig
Deprecated.Verifies and returnsFacetsConfig.DimConfig
for the given dimension name.Methods inherited from class org.apache.lucene.facet.Facets
validateTopN
-
Field Details
-
indexFieldName
Deprecated.Index field name provided to the constructor. -
taxoReader
Deprecated.TaxonomyReader
provided to the constructor. -
config
Deprecated.FacetsConfig
provided to the constructor. -
fc
Deprecated.FacetsCollector
provided to the constructor. -
children
Deprecated.Maps parent ordinal to its child, or -1 if the parent is childless. -
siblings
Deprecated.Maps an ordinal to its sibling, or -1 if there is no sibling. -
parents
Deprecated.Maps an ordinal to its parent, or -1 if there is no parent (root node). -
counts
int[] countsDeprecated.Dense ordinal counts. -
sparseCounts
IntIntHashMap sparseCountsDeprecated.Sparse ordinal counts. -
initialized
boolean initializedDeprecated.Have value counters been initialized. -
valueComparator
Deprecated.Defines comparison between aggregated values.
-
-
Constructor Details
-
TaxonomyFacets
@Deprecated protected TaxonomyFacets(String indexFieldName, TaxonomyReader taxoReader, FacetsConfig config) throws IOException Deprecated.To be removed in Lucene 10.Constructor without aFacetsCollector
- we don't have access to the hits, so we have to assume there are hits when initializing internal data structures.- Throws:
IOException
-
TaxonomyFacets
TaxonomyFacets(String indexFieldName, TaxonomyReader taxoReader, FacetsConfig config, FacetsCollector fc) throws IOException Deprecated.Constructor with aFacetsCollector
, allowing lazy initialization of internal data structures.- Throws:
IOException
-
-
Method Details
-
useHashTable
Deprecated.Return true if a sparse hash table should be used for counting, instead of a dense int[]. -
initializeValueCounters
protected void initializeValueCounters()Deprecated.If not done already, initialize the data structures storing counts. -
setCount
protected void setCount(int ordinal, int newValue) Deprecated.Set the count for this ordinal tonewValue
. -
getCount
protected int getCount(int ordinal) Deprecated.Get the count for this ordinal. -
getAggregationValue
Deprecated.Get the aggregation value for this ordinal. -
aggregate
Deprecated.Apply an aggregation to the two values and return the result. -
hasValues
boolean hasValues()Deprecated.Were any values actually aggregated during counting? -
getChildren
Deprecated.Returns int[] mapping each ordinal to its first child; this is a large array and is computed (and then saved) the first time this method is invoked.- Throws:
IOException
-
getSiblings
Deprecated.Returns int[] mapping each ordinal to its next sibling; this is a large array and is computed (and then saved) the first time this method is invoked.- Throws:
IOException
-
childrenLoaded
public boolean childrenLoaded()Deprecated.Returns true if the (costly, and lazily initialized) children int[] was initialized. -
siblingsLoaded
public boolean siblingsLoaded()Deprecated.Returns true if the (costly, and lazily initialized) sibling int[] was initialized. -
verifyDim
Deprecated.Verifies and returnsFacetsConfig.DimConfig
for the given dimension name.- Returns:
FacetsConfig.DimConfig
for the given dim, orFacetsConfig.DEFAULT_DIM_CONFIG
if it was never manually configured.- Throws:
IllegalArgumentException
- if the provided dimension was manually configured, but itsFacetsConfig.DimConfig.indexFieldName
does not matchindexFieldName
.
-
updateValueFromRollup
Deprecated.Roll-up the aggregation values fromchildOrdinal
toordinal
. Overrides should probably call this to update the counts. Overriding allows us to work with primitive types for the aggregation values, keeping aggregation efficient.- Throws:
IOException
-
makeTopOrdAndNumberQueue
Deprecated.Return aTopOrdAndNumberQueue
of the appropriate type, i.e. aTopOrdAndIntNumberQueue
or aTopOrdAndFloatNumberQueue
. -
missingAggregationValue
Deprecated.Return the value for a missing aggregation, i.e.-1
or-1f
. -
rollup
Deprecated.Rolls up any single-valued hierarchical dimensions.- Throws:
IOException
-
rollup
Deprecated.- Throws:
IOException
-
createFacetResult
private FacetResult createFacetResult(TaxonomyFacets.TopChildrenForPath topChildrenForPath, String dim, String... path) throws IOException Deprecated.Create a FacetResult for the provided dim + path and intermediate results. Does the extra work of resolving ordinals -> labels, etc. Will return null if there are no children.- Throws:
IOException
-
getAllChildren
Deprecated.Description copied from class:Facets
Returns all child labels with non-zero counts under the specified path. Users should make no assumptions about ordering of the children. Returns null if the specified path doesn't exist or if this dimension was never seen.- Specified by:
getAllChildren
in classFacets
- Throws:
IOException
-
setIncomingValue
Deprecated.Set the value for aTopOrdAndNumberQueue.OrdAndValue
to the one corresponding to the given ordinal. -
insertIntoQueue
protected TopOrdAndNumberQueue.OrdAndValue insertIntoQueue(TopOrdAndNumberQueue q, TopOrdAndNumberQueue.OrdAndValue incomingOrdAndValue, int ord) Deprecated.Insert an ordinal and the value corresponding to it into the queue. -
newAggregatedValue
Deprecated.Initialize an accumulator. -
getTopChildrenForPath
protected TaxonomyFacets.TopChildrenForPath getTopChildrenForPath(FacetsConfig.DimConfig dimConfig, int pathOrd, int topN) throws IOException Deprecated.Determine the top-n children for a specified dimension + path. Results are in an intermediate form.- Throws:
IOException
-
getTopChildren
Deprecated.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 classFacets
- Throws:
IOException
-
getSpecificValue
Deprecated.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 classFacets
- Throws:
IOException
-
getAllDims
Deprecated.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 classFacets
- Throws:
IOException
-
getTopDims
Deprecated.Description copied from class:Facets
Returns labels for topN dimensions and their topNChildren sorted by the number of hits/aggregated values that dimension matched. Results should be the same as calling getAllDims and then only using the first topNDims. Note that dims should be configured as requiring dim counts if using this functionality to ensure accurate counts are available (see:FacetsConfig.setRequireDimCount(String, boolean)
).Sub-classes may want to override this implementation with a more efficient one if they are able.
- Overrides:
getTopDims
in classFacets
- Throws:
IOException
-
Facets
implementations. If your code is relying on this, please migrate necessary functionality down into your own class.