russell_binary_distance#

skfp.distances.russell_binary_distance(vec_a: ndarray | csr_array, vec_b: ndarray | csr_array) → float#

Russell distance for vectors of binary values.

Computes the Russell distance [1] [2] [3] for binary data between two input arrays or sparse matrices by subtracting the similarity from 1, using the formula:

\[dist(a, b) = 1 - sim(a, b)\]

See also russell_binary_similarity(). The calculated similarity falls within the range \([0, 1]\). Passing all-zero vectors to this function results in a similarity of 1.

Parameters:

vec_a ({ndarray, sparse matrix}) – First binary input array or sparse matrix.
vec_b ({ndarray, sparse matrix}) – Second binary input array or sparse matrix.

Returns:

distance – Russell distance between vec_a and vec_b.

Return type:

float

References

Examples

>>> from skfp.distances import russell_binary_distance
>>> import numpy as np
>>> vec_a = np.array([1, 1, 1, 1])
>>> vec_b = np.array([1, 1, 0, 0])
>>> dist = russell_binary_distance(vec_a, vec_b)
>>> dist
0.5

>>> from scipy.sparse import csr_array
>>> vec_a = csr_array([[1, 1, 1, 1]])
>>> vec_b = csr_array([[1, 1, 0, 0]])
>>> dist = russell_binary_distance(vec_a, vec_b)
>>> dist
0.5

russell_binary_distance#

This Page