-
Notifications
You must be signed in to change notification settings - Fork 127
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add binary index support for Lucene engine
Signed-off-by: Jay Deng <[email protected]>
- Loading branch information
Showing
16 changed files
with
289 additions
and
44 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
106 changes: 106 additions & 0 deletions
106
src/main/java/org/opensearch/knn/index/codec/KNN990Codec/KNN990BinaryVectorScorer.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,106 @@ | ||
| /* | ||
| * Copyright OpenSearch Contributors | ||
| * SPDX-License-Identifier: Apache-2.0 | ||
| */ | ||
|
|
||
| package org.opensearch.knn.index.codec.KNN990Codec; | ||
|
|
||
| import org.apache.lucene.codecs.hnsw.FlatVectorsScorer; | ||
| import org.apache.lucene.index.VectorSimilarityFunction; | ||
| import org.apache.lucene.util.Bits; | ||
| import org.apache.lucene.util.VectorUtil; | ||
| import org.apache.lucene.util.hnsw.RandomAccessVectorValues; | ||
| import org.apache.lucene.util.hnsw.RandomVectorScorer; | ||
| import org.apache.lucene.util.hnsw.RandomVectorScorerSupplier; | ||
|
|
||
| import java.io.IOException; | ||
|
|
||
| /** | ||
| * A FlatVectorsScorer to be used for scoring binary vectors. Meant to be used with {@link KNN990BinaryVectorScorer} | ||
| */ | ||
| public class KNN990BinaryVectorScorer implements FlatVectorsScorer { | ||
| @Override | ||
| public RandomVectorScorerSupplier getRandomVectorScorerSupplier( | ||
| VectorSimilarityFunction vectorSimilarityFunction, | ||
| RandomAccessVectorValues randomAccessVectorValues | ||
| ) throws IOException { | ||
| if (randomAccessVectorValues instanceof RandomAccessVectorValues.Bytes) { | ||
| return new BinaryRandomVectorScorerSupplier((RandomAccessVectorValues.Bytes) randomAccessVectorValues); | ||
| } | ||
| throw new IllegalArgumentException("vectorValues must be an instance of RandomAccessVectorValues.Bytes"); | ||
| } | ||
|
|
||
| @Override | ||
| public RandomVectorScorer getRandomVectorScorer( | ||
| VectorSimilarityFunction vectorSimilarityFunction, | ||
| RandomAccessVectorValues randomAccessVectorValues, | ||
| float[] queryVector | ||
| ) throws IOException { | ||
| throw new IllegalArgumentException("binary vectors do not support float[] targets"); | ||
| } | ||
|
|
||
| @Override | ||
| public RandomVectorScorer getRandomVectorScorer( | ||
| VectorSimilarityFunction vectorSimilarityFunction, | ||
| RandomAccessVectorValues randomAccessVectorValues, | ||
| byte[] queryVector | ||
| ) throws IOException { | ||
| if (randomAccessVectorValues instanceof RandomAccessVectorValues.Bytes) { | ||
| return new BinaryRandomVectorScorer((RandomAccessVectorValues.Bytes) randomAccessVectorValues, queryVector); | ||
| } | ||
| throw new IllegalArgumentException("vectorValues must be an instance of RandomAccessVectorValues.Bytes"); | ||
| } | ||
|
|
||
| static class BinaryRandomVectorScorer implements RandomVectorScorer { | ||
| private final RandomAccessVectorValues.Bytes vectorValues; | ||
| private final byte[] queryVector; | ||
|
|
||
| BinaryRandomVectorScorer(RandomAccessVectorValues.Bytes vectorValues, byte[] query) { | ||
| this.queryVector = query; | ||
| this.vectorValues = vectorValues; | ||
| } | ||
|
|
||
| @Override | ||
| public float score(int node) throws IOException { | ||
| return 1 / (float) (1 + VectorUtil.xorBitCount(queryVector, vectorValues.vectorValue(node))); | ||
| } | ||
|
|
||
| @Override | ||
| public int maxOrd() { | ||
| return vectorValues.size(); | ||
| } | ||
|
|
||
| @Override | ||
| public int ordToDoc(int ord) { | ||
| return vectorValues.ordToDoc(ord); | ||
| } | ||
|
|
||
| @Override | ||
| public Bits getAcceptOrds(Bits acceptDocs) { | ||
| return vectorValues.getAcceptOrds(acceptDocs); | ||
| } | ||
| } | ||
|
|
||
| static class BinaryRandomVectorScorerSupplier implements RandomVectorScorerSupplier { | ||
| protected final RandomAccessVectorValues.Bytes vectorValues; | ||
| protected final RandomAccessVectorValues.Bytes vectorValues1; | ||
| protected final RandomAccessVectorValues.Bytes vectorValues2; | ||
|
|
||
| public BinaryRandomVectorScorerSupplier(RandomAccessVectorValues.Bytes vectorValues) throws IOException { | ||
| this.vectorValues = vectorValues; | ||
| this.vectorValues1 = vectorValues.copy(); | ||
| this.vectorValues2 = vectorValues.copy(); | ||
| } | ||
|
|
||
| @Override | ||
| public RandomVectorScorer scorer(int ord) throws IOException { | ||
| byte[] queryVector = vectorValues1.vectorValue(ord); | ||
| return new BinaryRandomVectorScorer(vectorValues2, queryVector); | ||
| } | ||
|
|
||
| @Override | ||
| public RandomVectorScorerSupplier copy() throws IOException { | ||
| return new BinaryRandomVectorScorerSupplier(vectorValues.copy()); | ||
| } | ||
| } | ||
| } |
119 changes: 119 additions & 0 deletions
119
src/main/java/org/opensearch/knn/index/codec/KNN990Codec/KNN990HnswBinaryVectorsFormat.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,119 @@ | ||
| /* | ||
| * Copyright OpenSearch Contributors | ||
| * SPDX-License-Identifier: Apache-2.0 | ||
| */ | ||
|
|
||
| package org.opensearch.knn.index.codec.KNN990Codec; | ||
|
|
||
| import org.apache.lucene.codecs.KnnVectorsFormat; | ||
| import org.apache.lucene.codecs.KnnVectorsReader; | ||
| import org.apache.lucene.codecs.KnnVectorsWriter; | ||
| import org.apache.lucene.codecs.hnsw.FlatVectorsFormat; | ||
| import org.apache.lucene.codecs.lucene99.Lucene99FlatVectorsFormat; | ||
| import org.apache.lucene.codecs.lucene99.Lucene99HnswVectorsReader; | ||
| import org.apache.lucene.codecs.lucene99.Lucene99HnswVectorsWriter; | ||
| import org.apache.lucene.index.SegmentReadState; | ||
| import org.apache.lucene.index.SegmentWriteState; | ||
| import org.apache.lucene.search.TaskExecutor; | ||
| import org.opensearch.knn.index.engine.KNNEngine; | ||
|
|
||
| import java.io.IOException; | ||
| import java.util.concurrent.ExecutorService; | ||
|
|
||
| import static org.apache.lucene.codecs.lucene99.Lucene99HnswVectorsFormat.DEFAULT_BEAM_WIDTH; | ||
| import static org.apache.lucene.codecs.lucene99.Lucene99HnswVectorsFormat.DEFAULT_MAX_CONN; | ||
| import static org.apache.lucene.codecs.lucene99.Lucene99HnswVectorsFormat.DEFAULT_NUM_MERGE_WORKER; | ||
| import static org.apache.lucene.codecs.lucene99.Lucene99HnswVectorsFormat.MAXIMUM_BEAM_WIDTH; | ||
| import static org.apache.lucene.codecs.lucene99.Lucene99HnswVectorsFormat.MAXIMUM_MAX_CONN; | ||
| import static org.opensearch.knn.index.engine.KNNEngine.getMaxDimensionByEngine; | ||
|
|
||
| /** | ||
| * Custom KnnVectorsFormat implementation to support binary vectors. This class is mostly identical to | ||
| * {@link org.apache.lucene.codecs.lucene99.Lucene99HnswVectorsFormat}, however we use the custom {@link KNN990BinaryVectorScorer} | ||
| * to perform hamming bit scoring. | ||
| */ | ||
| public final class KNN990HnswBinaryVectorsFormat extends KnnVectorsFormat { | ||
|
|
||
| private final int maxConn; | ||
| private final int beamWidth; | ||
| private static final FlatVectorsFormat flatVectorsFormat = new Lucene99FlatVectorsFormat(new KNN990BinaryVectorScorer()); | ||
| private final int numMergeWorkers; | ||
| private final TaskExecutor mergeExec; | ||
|
|
||
| private static final String NAME = "KNN990HnswBinaryVectorsFormat"; | ||
|
|
||
| /** | ||
| * Constructor logic is identical to {@link org.apache.lucene.codecs.lucene99.Lucene99HnswVectorsFormat#Lucene99HnswVectorsFormat()} | ||
| */ | ||
| public KNN990HnswBinaryVectorsFormat() { | ||
| this(DEFAULT_MAX_CONN, DEFAULT_BEAM_WIDTH, DEFAULT_NUM_MERGE_WORKER, null); | ||
| } | ||
|
|
||
| /** | ||
| * Constructor logic is identical to {@link org.apache.lucene.codecs.lucene99.Lucene99HnswVectorsFormat#Lucene99HnswVectorsFormat(int, int)} | ||
| */ | ||
| public KNN990HnswBinaryVectorsFormat(int maxConn, int beamWidth) { | ||
| this(maxConn, beamWidth, 1, null); | ||
| } | ||
|
|
||
| /** | ||
| * Constructor logic is identical to {@link org.apache.lucene.codecs.lucene99.Lucene99HnswVectorsFormat#Lucene99HnswVectorsFormat(int, int, int, java.util.concurrent.ExecutorService)} | ||
| */ | ||
| public KNN990HnswBinaryVectorsFormat(int maxConn, int beamWidth, int numMergeWorkers, ExecutorService mergeExec) { | ||
| super(NAME); | ||
| if (maxConn <= 0 || maxConn > MAXIMUM_MAX_CONN) { | ||
| throw new IllegalArgumentException( | ||
| "maxConn must be positive and less than or equal to " + MAXIMUM_MAX_CONN + "; maxConn=" + maxConn | ||
| ); | ||
| } | ||
| if (beamWidth <= 0 || beamWidth > MAXIMUM_BEAM_WIDTH) { | ||
| throw new IllegalArgumentException( | ||
| "beamWidth must be positive and less than or equal to " + MAXIMUM_BEAM_WIDTH + "; beamWidth=" + beamWidth | ||
| ); | ||
| } | ||
| this.maxConn = maxConn; | ||
| this.beamWidth = beamWidth; | ||
| if (numMergeWorkers == 1 && mergeExec != null) { | ||
| throw new IllegalArgumentException("No executor service is needed as we'll use single thread to merge"); | ||
| } | ||
| this.numMergeWorkers = numMergeWorkers; | ||
| if (mergeExec != null) { | ||
| this.mergeExec = new TaskExecutor(mergeExec); | ||
| } else { | ||
| this.mergeExec = null; | ||
| } | ||
| } | ||
|
|
||
| @Override | ||
| public KnnVectorsWriter fieldsWriter(SegmentWriteState state) throws IOException { | ||
| return new Lucene99HnswVectorsWriter( | ||
| state, | ||
| this.maxConn, | ||
| this.beamWidth, | ||
| flatVectorsFormat.fieldsWriter(state), | ||
| this.numMergeWorkers, | ||
| this.mergeExec | ||
| ); | ||
| } | ||
|
|
||
| @Override | ||
| public KnnVectorsReader fieldsReader(SegmentReadState state) throws IOException { | ||
| return new Lucene99HnswVectorsReader(state, flatVectorsFormat.fieldsReader(state)); | ||
| } | ||
|
|
||
| @Override | ||
| public int getMaxDimensions(String fieldName) { | ||
| return getMaxDimensionByEngine(KNNEngine.LUCENE); | ||
| } | ||
|
|
||
| @Override | ||
| public String toString() { | ||
| return "KNN990HnswBinaryVectorsFormat(name=KNN990HnswBinaryVectorsFormat, maxConn=" | ||
| + this.maxConn | ||
| + ", beamWidth=" | ||
| + this.beamWidth | ||
| + ", flatVectorFormat=" | ||
| + flatVectorsFormat | ||
| + ")"; | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.