convolve

Contents

convolve#

class saiunit.math.convolve(a, v, mode='full', *, precision=None, preferred_element_type=None, **kwargs)#

Return the discrete, linear convolution of two one-dimensional sequences.

The resulting unit is a.unit * v.unit.

Parameters:

  • a (Union[saiunit.Quantity, Array, ndarray, number, bool]) – First one-dimensional input array.

  • v (Union[saiunit.Quantity, Array, ndarray, number, bool]) – Second one-dimensional input array.

  • mode (str) – ‘full’ (default): output shape (N+M-1,). ‘same’: output length max(M, N). ‘valid’: output length max(M, N) - min(M, N) + 1.

  • precision (Any) – Precision for the computation.

  • preferred_element_type (Union[str, type[Any], dtype, SupportsDType, None]) – Accumulation and result dtype.

Returns:

out – Discrete, linear convolution of a and v. The resulting unit is a.unit * v.unit.

Return type:

Union[saiunit.Quantity, Array, ndarray, number, bool]

Examples

>>> import saiunit as u
>>> a = u.math.array([1.0, 2.0, 3.0]) * u.meter
>>> v = u.math.array([0.5, 1.0]) * u.second
>>> u.math.convolve(a, v)  # unit is meter * second
Contents