Package org.apache.lucene.search

Class ByteVectorSimilarityQuery.Explicit

java.lang.Object
org.apache.lucene.search.Query
org.apache.lucene.search.ByteVectorSimilarityQuery
org.apache.lucene.search.ByteVectorSimilarityQuery.Explicit
Enclosing class:
ByteVectorSimilarityQuery
@Deprecated public static non-sealed class ByteVectorSimilarityQuery.Explicit extends ByteVectorSimilarityQuery
Deprecated.
Equivalent to the ByteVectorSimilarityQuery constructors in Lucene 10.4 and earlier, use ByteVectorSimilarityQuery.Adaptive for a more performant version.
A ByteVectorSimilarityQuery with an explicit threshold for graph traversal.

  • Field Details

    • field

      protected final String field

    • resultSimilarity

      protected final float resultSimilarity

    • decay

      protected final float decay

    • filter

      protected final Query filter

    • searchStrategy

      protected final KnnSearchStrategy searchStrategy

  • Constructor Details

    • Explicit

      public Explicit(String field, byte[] target, float traversalSimilarity, float resultSimilarity, Query filter)
      Deprecated.
      Search for all (approximate) byte vectors above a similarity threshold using ExplicitVectorSimilarityCollector. If a filter is applied, it traverses as many nodes as the cost of the filter, and then falls back to exact search if results are incomplete.
      Parameters:
      field - a field that has been indexed as a KnnByteVectorField.
      target - the target of the search.
      traversalSimilarity - (lower) similarity score for graph traversal.
      resultSimilarity - (higher) similarity score for result collection.
      filter - a filter applied before the vector search.

    • Explicit

      public Explicit(String field, byte[] target, float traversalSimilarity, float resultSimilarity)
      Deprecated.
      Search for all (approximate) byte vectors above a similarity threshold using ExplicitVectorSimilarityCollector.
      Parameters:
      field - a field that has been indexed as a KnnByteVectorField.
      target - the target of the search.
      traversalSimilarity - (lower) similarity score for graph traversal.
      resultSimilarity - (higher) similarity score for result collection.

    • Explicit

      public Explicit(String field, byte[] target, float resultSimilarity, Query filter)
      Deprecated.
      Search for all (approximate) byte vectors above a similarity threshold using ExplicitVectorSimilarityCollector. If a filter is applied, it traverses as many nodes as the cost of the filter, and then falls back to exact search if results are incomplete.
      Parameters:
      field - a field that has been indexed as a KnnByteVectorField.
      target - the target of the search.
      resultSimilarity - similarity score for result collection.
      filter - a filter applied before the vector search.

    • Explicit

      public Explicit(String field, byte[] target, float resultSimilarity)
      Deprecated.
      Search for all (approximate) byte vectors above a similarity threshold using ExplicitVectorSimilarityCollector.
      Parameters:
      field - a field that has been indexed as a KnnByteVectorField.
      target - the target of the search.
      resultSimilarity - similarity score for result collection.

  • Method Details

    • getKnnCollectorManager

      protected KnnCollectorManager getKnnCollectorManager()
      Deprecated.
      Returns a KnnCollectorManager that always builds a VectorSimilarityCollector configured with this query's searchStrategy.

      The manager's strategy and LeafReaderContext parameters are intentionally ignored: top-k queries may override the strategy on a per-search basis, but similarity- threshold queries pin the strategy to the query's own value at construction time so that Query.equals(java.lang.Object) / getSearchStrategy() remain a faithful description of search behavior.

    • toString

      public String toString(String field)
      Deprecated.
      Description copied from class: Query
      Prints a query to a string, with field assumed to be the default field and omitted.
      Specified by:
      toString in class Query

    • equals

      public boolean equals(Object o)
      Deprecated.
      Description copied from class: Query
      Override and implement query instance equivalence properly in a subclass. This is required so that QueryCache works properly.

      Typically a query will be equal to another only if it's an instance of the same class and its document-filtering properties are identical to those of the other instance. Utility methods are provided for certain repetitive code.

      Overrides:
      equals in class ByteVectorSimilarityQuery
      See Also:

    • hashCode

      public int hashCode()
      Deprecated.
      Description copied from class: Query
      Override and implement query hash code properly in a subclass. This is required so that QueryCache works properly.
      Overrides:
      hashCode in class ByteVectorSimilarityQuery
      See Also:

    • getSearchStrategy

      public KnnSearchStrategy getSearchStrategy()
      Returns:
      the KnnSearchStrategy used during graph search.

    • createWeight

      public Weight createWeight(IndexSearcher searcher, ScoreMode scoreMode, float boost) throws IOException
      Description copied from class: Query
      Expert: Constructs an appropriate Weight implementation for this query.

      Only implemented by primitive queries, which re-write to themselves.

      Overrides:
      createWeight in class Query
      Parameters:
      scoreMode - How the produced scorers will be consumed.
      boost - The boost that is propagated by the parent queries.
      Throws:
      IOException

    • visit

      public void visit(QueryVisitor visitor)
      Description copied from class: Query
      Recurse through the query tree, visiting any child queries.
      Specified by:
      visit in class Query
      Parameters:
      visitor - a QueryVisitor to be called by each query in the tree