truncated_svd#

ivy.truncated_svd(x, /, compute_uv=True, n_eigenvecs=None)[source]#

Compute a truncated SVD on x using the standard SVD.

Parameters:
  • x (Union[Array, NativeArray]) – 2D-array compute_uv If True then left and right singular vectors will be computed and returned in U and Vh, respectively. Otherwise, only the singular values will be computed, which can be significantly faster.

  • n_eigenvecs (Optional[int], default: None) – if specified, number of eigen[vectors-values] to return else full matrices will be returned

Return type:

Union[Array, Tuple[Array, Array, Array]]

Returns:

ret – a namedtuple (U, S, Vh) Each returned array must have the same floating-point data type as x.

Array.truncated_svd(self, /, compute_uv=True, n_eigenvecs=None)[source]#

ivy.Array instance method variant of ivy.make_svd_non_negative. This method simply wraps the function, and so the docstring for ivy.make_svd_non_negative also applies to this method with minimal changes.

Parameters:
  • x – 2D-array

  • compute_uv (bool, default: True) – If True then left and right singular vectors will be computed and returnedv in U and Vh respectively. Otherwise, only the singular values will be computed, which can be significantly faster.

  • n_eigenvecs (Optional[int], default: None) – if specified, number of eigen[vectors-values] to return else full matrices will be returned

Return type:

Union[Array, Tuple[Array, Array, Array]]

Returns:

ret – a namedtuple (U, S, Vh) Each returned array must have the same floating-point data type as x.

Container.truncated_svd(self, /, compute_uv=True, n_eigenvecs=None, *, key_chains=None, to_apply=True, prune_unapplied=False, map_sequences=False)[source]#

ivy.Container instance method variant of ivy.truncated_svd. This method simply wraps the function, and so the docstring for ivy.truncated_svd also applies to this method with minimal changes.

Parameters:
  • x – Container of 2D-arrays

  • compute_uv (Union[bool, Container], default: True) – If True then left and right singular vectors will be computed and returned in U and Vh respectively. Otherwise, only the singular values will be computed, which can be significantly faster.

  • n_eigenvecs (Optional[Union[int, Container]], default: None) – if specified, number of eigen[vectors-values] to return else full matrices will be returned

Return type:

Union[Container, Tuple[Container, Container, Container]]

Returns:

ret – a namedtuple (U, S, Vh) Each returned container must have the same floating-point data type as x.