testing.assert_less

array_api_extra.testing.assert_less(x, y, *, err_msg='', verbose=True, check_dtype=True, check_shape=True, check_scalar=False, xp=None)

Check that two arrays are ordered by less than.

This is an interface to numpy.testing.assert_array_less() which accepts any standard-compatible array and performs additional array namespace, shape, and dtype checks.

Parameters:
  • x (Array) – Array to compare according to x < y (elementwise).

  • y (Array) – Array to compare according to x < y (elementwise).

  • err_msg (str, optional) – Error message to display on failure.

  • verbose (bool, default: True) – Whether to include the conflicting arrays in the error message on failure.

  • check_dtype (bool, default: True) – Whether to check agreement between the dtypes of x and y.

  • check_shape (bool, default: True) – Whether to check agreement between the shapes of x and y.

  • check_scalar (bool, default: False) – NumPy only: whether to check agreement between actual and desired types — 0-D numpy.ndarray vs scalar (e.g. numpy.double).

  • xp (array_namespace, optional) – A standard-compatible namespace which x and y must match.

Raises:

ImportError – If numpy is not importable in the Python environment.

Return type:

None

See also

assert_close

Similar function for inexact equality checks.

numpy.testing.assert_array_less

Similar function for NumPy arrays.