Package com.redis.vl.utils

Class Utils

java.lang.Object

com.redis.vl.utils.Utils

public final class Utils
extends Object

Utility methods for RedisVL.

Method Summary

Modifier and Type	Method	Description
static double	currentTimestamp()	Get current timestamp with microsecond precision.
static float	denormCosineDistance(float value)	Denormalize a similarity score (0-1) to a Redis COSINE distance (0-2).
static float	normCosineDistance(float value)	Normalize a Redis COSINE distance (0-2) to a similarity score (0-1).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

currentTimestamp

public static double currentTimestamp()

Get current timestamp with microsecond precision.

Matches Python's current_timestamp() from redisvl.utils.utils which uses time.time() returning seconds since epoch with microsecond precision (e.g., 1759898747.946505).

Returns:

Current time in seconds since epoch with microsecond precision as a double

normCosineDistance

public static float normCosineDistance(float value)

Normalize a Redis COSINE distance (0-2) to a similarity score (0-1).

Redis COSINE distance ranges from 0 (identical) to 2 (opposite). This method converts it to a normalized similarity score where 0 is completely dissimilar and 1 is identical.

Matches Python's norm_cosine_distance() from redisvl.utils.utils.

Parameters:

value - Redis COSINE distance value (0-2)

Returns:

Normalized similarity score (0-1)

denormCosineDistance

public static float denormCosineDistance(float value)

Denormalize a similarity score (0-1) to a Redis COSINE distance (0-2).

Converts a normalized similarity score (where 1 is identical and 0 is dissimilar) back to Redis COSINE distance format (where 0 is identical and 2 is opposite).

Matches Python's denorm_cosine_distance() from redisvl.utils.utils.

Parameters:

value - Normalized similarity score (0-1)

Returns:

Redis COSINE distance value (0-2)