Skip to content

vecdot

Computes the (vector) dot product of two arrays.

Parameters:

Name Type Description Default
x1 array_like

Input sparse arrays

required
x2 array_like

Input sparse arrays

required
axis int

The axis to reduce over.

-1

Returns:

Name Type Description
out Union[SparseArray, ndarray]

Sparse or 0-D array containing dot product.

Source code in sparse/numba_backend/_common.py
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
def vecdot(x1, x2, /, *, axis=-1):
    """
    Computes the (vector) dot product of two arrays.

    Parameters
    ----------
    x1, x2 : array_like
        Input sparse arrays
    axis : int
        The axis to reduce over.

    Returns
    -------
    out : Union[SparseArray, numpy.ndarray]
        Sparse or 0-D array containing dot product.
    """
    ndmin = builtins.min((x1.ndim, x2.ndim))
    if not (-ndmin <= axis < ndmin) or x1.shape[axis] != x2.shape[axis]:
        raise ValueError("Shapes must match along `axis`.")

    if np.issubdtype(x1.dtype, np.complexfloating):
        x1 = np.conjugate(x1)

    return np.sum(x1 * x2, axis=axis)