- All Known Implementing Classes:
RandomVectorScorer.AbstractRandomVectorScorer
,ScalarQuantizedRandomVectorScorer
public interface RandomVectorScorer
A
RandomVectorScorer
for scoring random nodes in batches against an abstract query.-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic class
Creates a default scorer for random access vectors. -
Method Summary
Modifier and TypeMethodDescriptionstatic RandomVectorScorer
createBytes
(RandomAccessVectorValues<byte[]> vectors, VectorSimilarityFunction similarityFunction, byte[] query) Creates a default scorer for byte vectors.static RandomVectorScorer
createFloats
(RandomAccessVectorValues<float[]> vectors, VectorSimilarityFunction similarityFunction, float[] query) Creates a default scorer for float vectors.default Bits
getAcceptOrds
(Bits acceptDocs) Returns theBits
representing live documents.int
maxOrd()
default int
ordToDoc
(int ord) Translates vector ordinal to the correct document ID.float
score
(int node) Returns the score between the query and the provided node.
-
Method Details
-
score
Returns the score between the query and the provided node.- Parameters:
node
- a random node in the graph- Returns:
- the computed score
- Throws:
IOException
-
maxOrd
int maxOrd()- Returns:
- the maximum possible ordinal for this scorer
-
ordToDoc
default int ordToDoc(int ord) Translates vector ordinal to the correct document ID. By default, this is an identity function.- Parameters:
ord
- the vector ordinal- Returns:
- the document Id for that vector ordinal
-
getAcceptOrds
Returns theBits
representing live documents. By default, this is an identity function.- Parameters:
acceptDocs
- the accept docs- Returns:
- the accept docs
-
createFloats
static RandomVectorScorer createFloats(RandomAccessVectorValues<float[]> vectors, VectorSimilarityFunction similarityFunction, float[] query) Creates a default scorer for float vectors.WARNING: The
RandomAccessVectorValues
given can contain stateful buffers. Avoid using it after calling this function. If you plan to use it again outside the returnedRandomVectorScorer
, think about passing a copied version (RandomAccessVectorValues.copy()
).- Parameters:
vectors
- the underlying storage for vectorssimilarityFunction
- the similarity function to score vectorsquery
- the actual query
-
createBytes
static RandomVectorScorer createBytes(RandomAccessVectorValues<byte[]> vectors, VectorSimilarityFunction similarityFunction, byte[] query) Creates a default scorer for byte vectors.WARNING: The
RandomAccessVectorValues
given can contain stateful buffers. Avoid using it after calling this function. If you plan to use it again outside the returnedRandomVectorScorer
, think about passing a copied version (RandomAccessVectorValues.copy()
).- Parameters:
vectors
- the underlying storage for vectorssimilarityFunction
- the similarity function to use to score vectorsquery
- the actual query
-