TieredIndexParams

View as Markdown

Java package: com.nvidia.cuvs

1public final class TieredIndexParams

Configuration parameters for building a TieredIndex. Only CAGRA is currently supported as the underlying ANN algorithm.

Public Members

product

1L2, /** Inner product (cosine similarity) distance metric */ INNER_PRODUCT } private final Metric metric

L2 (Euclidean) distance metric

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:20

TieredIndexParams

1private TieredIndexParams(Builder builder)

Private constructor used by the Builder.

Parameters

NameDescription
builderThe Builder instance containing the configuration

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:35

getMetric

1public Metric getMetric()

Returns the distance metric used for similarity computation.

Returns

The Metric (L2 or Inner Product)

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:47

getMinAnnRows

1public int getMinAnnRows()

Returns the minimum number of rows required to use the ANN algorithm.

Returns

The minimum row count threshold for ANN algorithm usage

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:56

isCreateAnnIndexOnExtend

1public boolean isCreateAnnIndexOnExtend()

Returns whether to create an ANN index when extending the dataset.

Returns

true if ANN index should be created on extend, false otherwise

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:65

getCagraParams

1public CagraIndexParams getCagraParams()

Returns the CAGRA-specific parameters for the ANN algorithm.

Returns

The CagraIndexParams configuration, or null if not using CAGRA

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:75

newBuilder

1public static Builder newBuilder()

Creates a new Builder for constructing TieredIndexParams.

Returns

A new Builder instance

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:84

metric

1public Builder metric(Metric metric)

Sets the distance metric for similarity computation.

Parameters

NameDescription
metricThe Metric to use (L2 or Inner Product)

Returns

This Builder instance for method chaining

Throws

TypeDescription
NullPointerExceptionif metric is null

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:104

minAnnRows

1public Builder minAnnRows(int minAnnRows)

Sets the minimum number of rows required to use the ANN algorithm.

Parameters

NameDescription
minAnnRowsThe minimum row count threshold (must be positive)

Returns

This Builder instance for method chaining

Throws

TypeDescription
IllegalArgumentExceptionif minAnnRows is not positive

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:116

createAnnIndexOnExtend

1public Builder createAnnIndexOnExtend(boolean val)

Sets whether to create an ANN index when extending the dataset.

Parameters

NameDescription
valtrue to create ANN index on extend, false otherwise

Returns

This Builder instance for method chaining

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:130

withCagraParams

1public Builder withCagraParams(CagraIndexParams params)

Sets the CAGRA-specific parameters for the ANN algorithm.

Parameters

NameDescription
paramsThe CagraIndexParams configuration for CAGRA algorithm

Returns

This Builder instance for method chaining

Throws

TypeDescription
NullPointerExceptionif params is null

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:143

build

1public TieredIndexParams build()

Builds and returns a TieredIndexParams instance with the configured parameters.

Returns

A new TieredIndexParams instance

Throws

TypeDescription
IllegalStateExceptionif CAGRA params are required but not provided

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:156

Source: java/cuvs-java/src/main/java/com/nvidia/cuvs/TieredIndexParams.java:14