scico.numpy.testing#

Test support functions.

Functions

`assert_`(val[, msg])	Assert that works in release mode.
`assert_allclose`(actual, desired[, rtol, ...])	Raises an AssertionError if two objects are not equal up to desired tolerance.
`assert_almost_equal`(actual, desired[, ...])	Raises an AssertionError if two items are not equal up to desired precision.
`assert_approx_equal`(actual, desired[, ...])	Raises an AssertionError if two items are not equal up to significant digits.
`assert_array_almost_equal`(x, y[, decimal, ...])	Raises an AssertionError if two objects are not equal up to desired precision.
`assert_array_almost_equal_nulp`(x, y[, nulp])	Compare two arrays relatively to their spacing.
`assert_array_compare`(comparison, x, y[, ...])	None
`assert_array_equal`(x, y[, err_msg, verbose, ...])	Raises an AssertionError if two array_like objects are not equal.
`assert_array_less`(x, y[, err_msg, verbose])	Raises an AssertionError if two array_like objects are not ordered by less than.
`assert_array_max_ulp`(a, b[, maxulp, dtype])	Check that all items of arrays differ in at most N Units in the Last Place.
`assert_equal`(actual, desired[, err_msg, verbose])	Raises an AssertionError if two objects are not equal.
`assert_no_gc_cycles`(args, *kwargs)	Fail if the given callable produces any reference cycles.
`assert_no_warnings`(args, *kwargs)	Fail if the given callable produces any warnings.
`assert_raises`()	Fail unless an exception of class exception_class is thrown by callable when invoked with arguments args and keyword arguments kwargs.
`assert_raises_regex`()	Fail unless an exception of class exception_class and with message that matches expected_regexp is thrown by callable when invoked with arguments args and keyword arguments kwargs.
`assert_string_equal`(actual, desired)	Test if two strings are equal.
`assert_warns`(warning_class, args, *kwargs)	Fail unless the given callable throws the specified warning.
`break_cycles`()	Break reference cycles by calling gc.collect.
`build_err_msg`(arrays, err_msg[, header, ...])	None
`decorate_methods`(cls, decorator[, testmatch])	Apply a decorator to all methods in a class matching a regular expression.
`jiffies`([_proc_pid_stat, _load_time])	Return number of jiffies elapsed.
`measure`(code_str[, times, label])	Return elapsed time for executing code in the namespace of the caller.
`memusage`([_proc_pid_stat])	Return virtual memory size in bytes of the running python.
`print_assert_equal`(test_string, actual, desired)	Test if two objects are equal, and print an error message if test fails.
`raises`(*args)	Decorator to check for raised exceptions.
`run_module_suite`([file_to_run, argv])	Run a test module.
`rundocs`([filename, raise_on_error])	Run doctests found in the given file.
`runstring`(astr, dict)	None
`tempdir`(args, *kwargs)	Context manager to provide a temporary test folder.
`temppath`(args, *kwargs)	Context manager for temporary files.

scico.numpy.testing.assert_(val, msg='')#

Assert that works in release mode. Accepts callable msg to allow deferring evaluation until failure.

The Python built-in assert does not work when executing code in optimized mode (the -O flag) - no byte-code is generated for it.

For documentation on usage, refer to the Python documentation.

scico.numpy.testing.assert_allclose(actual, desired, rtol=1e-07, atol=0, equal_nan=True, err_msg='', verbose=True)#

Raises an AssertionError if two objects are not equal up to desired tolerance.

Given two array_like objects, check that their shapes and all elements are equal (but see the Notes for the special handling of a scalar). An exception is raised if the shapes mismatch or any values conflict. In contrast to the standard usage in numpy, NaNs are compared like numbers, no assertion is raised if both objects have NaNs in the same positions.

The test is equivalent to allclose(actual, desired, rtol, atol) (note that allclose has different default values). It compares the difference between actual and desired to atol + rtol * abs(desired).

New in version 1.5.0.

Parameters:

actual (array_like) – Array obtained.
desired (array_like) – Array desired.
rtol (float, optional) – Relative tolerance.
atol (float, optional) – Absolute tolerance.
equal_nan (bool, optional.) – If True, NaNs will compare equal.
err_msg (str, optional) – The error message to be printed in case of failure.
verbose (bool, optional) – If True, the conflicting values are appended to the error message.

Raises:

AssertionError – If actual and desired are not equal up to specified precision.

Notes

When one of actual and desired is a scalar and the other is array_like, the function checks that each element of the array_like object is equal to the scalar.

Examples

>>> x = [1e-5, 1e-3, 1e-1]
>>> y = np.arccos(np.cos(x))
>>> np.testing.assert_allclose(x, y, rtol=1e-5, atol=0)

scico.numpy.testing.assert_almost_equal(actual, desired, decimal=7, err_msg='', verbose=True)#

Raises an AssertionError if two items are not equal up to desired precision.

Note

It is recommended to use one of assert_allclose, assert_array_almost_equal_nulp or assert_array_max_ulp instead of this function for more consistent floating point comparisons.

The test verifies that the elements of actual and desired satisfy.

abs(desired-actual) < float64(1.5 * 10**(-decimal))

That is a looser test than originally documented, but agrees with what the actual implementation in assert_array_almost_equal did up to rounding vagaries. An exception is raised at conflicting values. For ndarrays this delegates to assert_array_almost_equal

Parameters:

actual (array_like) – The object to check.
desired (array_like) – The expected object.
decimal (int, optional) – Desired precision, default is 7.
err_msg (str, optional) – The error message to be printed in case of failure.
verbose (bool, optional) – If True, the conflicting values are appended to the error message.

Raises:

AssertionError – If actual and desired are not equal up to specified precision.

See also

assert_allclose: Compare two array_like objects for equality with desired relative and/or absolute precision.

assert_array_almost_equal_nulp, assert_array_max_ulp, assert_equal

Examples

>>> from numpy.testing import assert_almost_equal
>>> assert_almost_equal(2.3333333333333, 2.33333334)
>>> assert_almost_equal(2.3333333333333, 2.33333334, decimal=10)
Traceback (most recent call last):
    ...
AssertionError:
Arrays are not almost equal to 10 decimals
 ACTUAL: 2.3333333333333
 DESIRED: 2.33333334

>>> assert_almost_equal(np.array([1.0,2.3333333333333]),
...                     np.array([1.0,2.33333334]), decimal=9)
Traceback (most recent call last):
    ...
AssertionError:
Arrays are not almost equal to 9 decimals

Mismatched elements: 1 / 2 (50%)
Max absolute difference: 6.66669964e-09
Max relative difference: 2.85715698e-09
 x: array([1.         , 2.333333333])
 y: array([1.        , 2.33333334])

scico.numpy.testing.assert_approx_equal(actual, desired, significant=7, err_msg='', verbose=True)#

Raises an AssertionError if two items are not equal up to significant digits.

Note

It is recommended to use one of assert_allclose, assert_array_almost_equal_nulp or assert_array_max_ulp instead of this function for more consistent floating point comparisons.

Given two numbers, check that they are approximately equal. Approximately equal is defined as the number of significant digits that agree.

Parameters:

actual (scalar) – The object to check.
desired (scalar) – The expected object.
significant (int, optional) – Desired precision, default is 7.
err_msg (str, optional) – The error message to be printed in case of failure.
verbose (bool, optional) – If True, the conflicting values are appended to the error message.

Raises:

AssertionError – If actual and desired are not equal up to specified precision.

See also

assert_allclose: Compare two array_like objects for equality with desired relative and/or absolute precision.

assert_array_almost_equal_nulp, assert_array_max_ulp, assert_equal

Examples

>>> np.testing.assert_approx_equal(0.12345677777777e-20, 0.1234567e-20)
>>> np.testing.assert_approx_equal(0.12345670e-20, 0.12345671e-20,
...                                significant=8)
>>> np.testing.assert_approx_equal(0.12345670e-20, 0.12345672e-20,
...                                significant=8)
Traceback (most recent call last):
    ...
AssertionError:
Items are not equal to 8 significant digits:
 ACTUAL: 1.234567e-21
 DESIRED: 1.2345672e-21

the evaluated condition that raises the exception is

>>> abs(0.12345670e-20/1e-21 - 0.12345672e-20/1e-21) >= 10**-(8-1)
True

scico.numpy.testing.assert_array_almost_equal(x, y, decimal=6, err_msg='', verbose=True)#

Raises an AssertionError if two objects are not equal up to desired precision.

Note

It is recommended to use one of assert_allclose, assert_array_almost_equal_nulp or assert_array_max_ulp instead of this function for more consistent floating point comparisons.

The test verifies identical shapes and that the elements of actual and desired satisfy.

abs(desired-actual) < 1.5 * 10**(-decimal)

That is a looser test than originally documented, but agrees with what the actual implementation did up to rounding vagaries. An exception is raised at shape mismatch or conflicting values. In contrast to the standard usage in numpy, NaNs are compared like numbers, no assertion is raised if both objects have NaNs in the same positions.

Parameters:

x (array_like) – The actual object to check.
y (array_like) – The desired, expected object.
decimal (int, optional) – Desired precision, default is 6.
err_msg (str, optional) – The error message to be printed in case of failure.
verbose (bool, optional) – If True, the conflicting values are appended to the error message.

Raises:

AssertionError – If actual and desired are not equal up to specified precision.

See also

assert_allclose: Compare two array_like objects for equality with desired relative and/or absolute precision.

assert_array_almost_equal_nulp, assert_array_max_ulp, assert_equal

Examples

the first assert does not raise an exception

>>> np.testing.assert_array_almost_equal([1.0,2.333,np.nan],
...                                      [1.0,2.333,np.nan])

>>> np.testing.assert_array_almost_equal([1.0,2.33333,np.nan],
...                                      [1.0,2.33339,np.nan], decimal=5)
Traceback (most recent call last):
    ...
AssertionError:
Arrays are not almost equal to 5 decimals

Mismatched elements: 1 / 3 (33.3%)
Max absolute difference: 6.e-05
Max relative difference: 2.57136612e-05
 x: array([1.     , 2.33333,     nan])
 y: array([1.     , 2.33339,     nan])

>>> np.testing.assert_array_almost_equal([1.0,2.33333,np.nan],
...                                      [1.0,2.33333, 5], decimal=5)
Traceback (most recent call last):
    ...
AssertionError:
Arrays are not almost equal to 5 decimals

x and y nan location mismatch:
 x: array([1.     , 2.33333,     nan])
 y: array([1.     , 2.33333, 5.     ])

scico.numpy.testing.assert_array_almost_equal_nulp(x, y, nulp=1)#

Compare two arrays relatively to their spacing.

This is a relatively robust method to compare two arrays whose amplitude is variable.

Parameters:

x (array_like) – Input arrays.
y (array_like) – Input arrays.
nulp (int, optional) – The maximum number of unit in the last place for tolerance (see Notes). Default is 1.

Returns:

None

Raises:

AssertionError – If the spacing between x and y for one or more elements is larger than nulp.

See also

assert_array_max_ulp: Check that all items of arrays differ in at most N Units in the Last Place.
spacing: Return the distance between x and the nearest adjacent number.

Notes

An assertion is raised if the following condition is not met:

abs(x - y) <= nulp * spacing(maximum(abs(x), abs(y)))

Examples

>>> x = np.array([1., 1e-10, 1e-20])
>>> eps = np.finfo(x.dtype).eps
>>> np.testing.assert_array_almost_equal_nulp(x, x*eps/2 + x)

>>> np.testing.assert_array_almost_equal_nulp(x, x*eps + x)
Traceback (most recent call last):
  ...
AssertionError: X and Y are not equal to 1 ULP (max is 2)

scico.numpy.testing.assert_array_compare(comparison, x, y, err_msg='', verbose=True, header='', precision=6, equal_nan=True, equal_inf=True, *, strict=False)#: None

scico.numpy.testing.assert_array_equal(x, y, err_msg='', verbose=True, *, strict=False)#

Raises an AssertionError if two array_like objects are not equal.

Given two array_like objects, check that the shape is equal and all elements of these objects are equal (but see the Notes for the special handling of a scalar). An exception is raised at shape mismatch or conflicting values. In contrast to the standard usage in numpy, NaNs are compared like numbers, no assertion is raised if both objects have NaNs in the same positions.

The usual caution for verifying equality with floating point numbers is advised.

Parameters:

x (array_like) – The actual object to check.
y (array_like) – The desired, expected object.
err_msg (str, optional) – The error message to be printed in case of failure.
verbose (bool, optional) – If True, the conflicting values are appended to the error message.
strict (bool, optional) –
If True, raise an AssertionError when either the shape or the data type of the array_like objects does not match. The special handling for scalars mentioned in the Notes section is disabled.

New in version 1.24.0.

Raises:

AssertionError – If actual and desired objects are not equal.

See also

assert_allclose: Compare two array_like objects for equality with desired relative and/or absolute precision.

assert_array_almost_equal_nulp, assert_array_max_ulp, assert_equal

Notes

When one of x and y is a scalar and the other is array_like, the function checks that each element of the array_like object is equal to the scalar. This behaviour can be disabled with the strict parameter.

Examples

The first assert does not raise an exception:

>>> np.testing.assert_array_equal([1.0,2.33333,np.nan],
...                               [np.exp(0),2.33333, np.nan])

Assert fails with numerical imprecision with floats:

>>> np.testing.assert_array_equal([1.0,np.pi,np.nan],
...                               [1, np.sqrt(np.pi)**2, np.nan])
Traceback (most recent call last):
    ...
AssertionError:
Arrays are not equal

Mismatched elements: 1 / 3 (33.3%)
Max absolute difference: 4.4408921e-16
Max relative difference: 1.41357986e-16
 x: array([1.      , 3.141593,      nan])
 y: array([1.      , 3.141593,      nan])

Use assert_allclose or one of the nulp (number of floating point values) functions for these cases instead:

>>> np.testing.assert_allclose([1.0,np.pi,np.nan],
...                            [1, np.sqrt(np.pi)**2, np.nan],
...                            rtol=1e-10, atol=0)

As mentioned in the Notes section, assert_array_equal has special handling for scalars. Here the test checks that each value in x is 3:

>>> x = np.full((2, 5), fill_value=3)
>>> np.testing.assert_array_equal(x, 3)

Use strict to raise an AssertionError when comparing a scalar with an array:

>>> np.testing.assert_array_equal(x, 3, strict=True)
Traceback (most recent call last):
    ...
AssertionError:
Arrays are not equal

(shapes (2, 5), () mismatch)
 x: array([[3, 3, 3, 3, 3],
       [3, 3, 3, 3, 3]])
 y: array(3)

The strict parameter also ensures that the array data types match:

>>> x = np.array([2, 2, 2])
>>> y = np.array([2., 2., 2.], dtype=np.float32)
>>> np.testing.assert_array_equal(x, y, strict=True)
Traceback (most recent call last):
    ...
AssertionError:
Arrays are not equal

(dtypes int64, float32 mismatch)
 x: array([2, 2, 2])
 y: array([2., 2., 2.], dtype=float32)

scico.numpy.testing.assert_array_less(x, y, err_msg='', verbose=True)#

Raises an AssertionError if two array_like objects are not ordered by less than.

Given two array_like objects, check that the shape is equal and all elements of the first object are strictly smaller than those of the second object. An exception is raised at shape mismatch or incorrectly ordered values. Shape mismatch does not raise if an object has zero dimension. In contrast to the standard usage in numpy, NaNs are compared, no assertion is raised if both objects have NaNs in the same positions.

Parameters:

x (array_like) – The smaller object to check.
y (array_like) – The larger object to compare.
err_msg (string) – The error message to be printed in case of failure.
verbose (bool) – If True, the conflicting values are appended to the error message.

Raises:

AssertionError – If actual and desired objects are not equal.

See also

assert_array_equal: tests objects for equality
assert_array_almost_equal: test objects for equality up to precision

Examples

>>> np.testing.assert_array_less([1.0, 1.0, np.nan], [1.1, 2.0, np.nan])
>>> np.testing.assert_array_less([1.0, 1.0, np.nan], [1, 2.0, np.nan])
Traceback (most recent call last):
    ...
AssertionError:
Arrays are not less-ordered

Mismatched elements: 1 / 3 (33.3%)
Max absolute difference: 1.
Max relative difference: 0.5
 x: array([ 1.,  1., nan])
 y: array([ 1.,  2., nan])

>>> np.testing.assert_array_less([1.0, 4.0], 3)
Traceback (most recent call last):
    ...
AssertionError:
Arrays are not less-ordered

Mismatched elements: 1 / 2 (50%)
Max absolute difference: 2.
Max relative difference: 0.66666667
 x: array([1., 4.])
 y: array(3)

>>> np.testing.assert_array_less([1.0, 2.0, 3.0], [4])
Traceback (most recent call last):
    ...
AssertionError:
Arrays are not less-ordered

(shapes (3,), (1,) mismatch)
 x: array([1., 2., 3.])
 y: array([4])

scico.numpy.testing.assert_array_max_ulp(a, b, maxulp=1, dtype=None)#

Check that all items of arrays differ in at most N Units in the Last Place.

Parameters:

a (array_like) – Input arrays to be compared.
b (array_like) – Input arrays to be compared.
maxulp (int, optional) – The maximum number of units in the last place that elements of a and b can differ. Default is 1.
dtype (dtype, optional) – Data-type to convert a and b to if given. Default is None.

Returns:

ret (ndarray) – Array containing number of representable floating point numbers between items in a and b.

Raises:

AssertionError – If one or more elements differ by more than maxulp.

Notes

For computing the ULP difference, this API does not differentiate between various representations of NAN (ULP difference between 0x7fc00000 and 0xffc00000 is zero).

See also

assert_array_almost_equal_nulp: Compare two arrays relatively to their spacing.

Examples

>>> a = np.linspace(0., 1., 100)
>>> res = np.testing.assert_array_max_ulp(a, np.arcsin(np.sin(a)))

scico.numpy.testing.assert_equal(actual, desired, err_msg='', verbose=True)#

Raises an AssertionError if two objects are not equal.

Given two objects (scalars, lists, tuples, dictionaries or numpy arrays), check that all elements of these objects are equal. An exception is raised at the first conflicting values.

When one of actual and desired is a scalar and the other is array_like, the function checks that each element of the array_like object is equal to the scalar.

This function handles NaN comparisons as if NaN was a “normal” number. That is, AssertionError is not raised if both objects have NaNs in the same positions. This is in contrast to the IEEE standard on NaNs, which says that NaN compared to anything must return False.

Parameters:

actual (array_like) – The object to check.
desired (array_like) – The expected object.
err_msg (str, optional) – The error message to be printed in case of failure.
verbose (bool, optional) – If True, the conflicting values are appended to the error message.

Raises:

AssertionError – If actual and desired are not equal.

Examples

>>> np.testing.assert_equal([4,5], [4,6])
Traceback (most recent call last):
    ...
AssertionError:
Items are not equal:
item=1
 ACTUAL: 5
 DESIRED: 6

The following comparison does not raise an exception. There are NaNs in the inputs, but they are in the same positions.

>>> np.testing.assert_equal(np.array([1.0, 2.0, np.nan]), [1, 2, np.nan])

scico.numpy.testing.assert_no_gc_cycles(*args, **kwargs)#

Fail if the given callable produces any reference cycles.

If called with all arguments omitted, may be used as a context manager:

with assert_no_gc_cycles():
do_something()

New in version 1.15.0.

Parameters:

func (callable) – The callable to test.
*args (Arguments) – Arguments passed to func.
**kwargs (Kwargs) – Keyword arguments passed to func.

Returns:

Nothing. The result is deliberately discarded to ensure that all cycles
are found.

scico.numpy.testing.assert_no_warnings(*args, **kwargs)#

Fail if the given callable produces any warnings.

If called with all arguments omitted, may be used as a context manager:

with assert_no_warnings():
do_something()

The ability to be used as a context manager is new in NumPy v1.11.0.

New in version 1.7.0.

Parameters:

func (callable) – The callable to test.
*args (Arguments) – Arguments passed to func.
**kwargs (Kwargs) – Keyword arguments passed to func.

Returns:

The value returned by func.

scico.numpy.testing.assert_raises(exception_class, callable, *args, **kwargs)#

scico.numpy.testing.assert_raises(exception_class) → None

Fail unless an exception of class exception_class is thrown by callable when invoked with arguments args and keyword arguments kwargs. If a different type of exception is thrown, it will not be caught, and the test case will be deemed to have suffered an error, exactly as for an unexpected exception.

Alternatively, assert_raises can be used as a context manager:

>>> from numpy.testing import assert_raises
>>> with assert_raises(ZeroDivisionError):
...     1 / 0

is equivalent to

>>> def div(x, y):
...     return x / y
>>> assert_raises(ZeroDivisionError, div, 1, 0)

scico.numpy.testing.assert_raises_regex(exception_class, expected_regexp, callable, *args, **kwargs)#

scico.numpy.testing.assert_raises_regex(exception_class, expected_regexp) → None

Fail unless an exception of class exception_class and with message that matches expected_regexp is thrown by callable when invoked with arguments args and keyword arguments kwargs.

Alternatively, can be used as a context manager like assert_raises.

Notes

New in version 1.9.0.

scico.numpy.testing.assert_string_equal(actual, desired)#

Test if two strings are equal.

If the given strings are equal, assert_string_equal does nothing. If they are not equal, an AssertionError is raised, and the diff between the strings is shown.

Parameters:

actual (str) – The string to test for equality against the expected string.
desired (str) – The expected string.

Examples

>>> np.testing.assert_string_equal('abc', 'abc')
>>> np.testing.assert_string_equal('abc', 'abcd')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
...
AssertionError: Differences in strings:
- abc+ abcd?    +

scico.numpy.testing.assert_warns(warning_class, *args, **kwargs)#

Fail unless the given callable throws the specified warning.

A warning of class warning_class should be thrown by the callable when invoked with arguments args and keyword arguments kwargs. If a different type of warning is thrown, it will not be caught.

If called with all arguments other than the warning class omitted, may be used as a context manager:

with assert_warns(SomeWarning):
do_something()

The ability to be used as a context manager is new in NumPy v1.11.0.

New in version 1.4.0.

Parameters:

warning_class (class) – The class defining the warning that func is expected to throw.
func (callable, optional) – Callable to test
*args (Arguments) – Arguments for func.
**kwargs (Kwargs) – Keyword arguments for func.

Returns:

The value returned by func.

Examples

>>> import warnings
>>> def deprecated_func(num):
...     warnings.warn("Please upgrade", DeprecationWarning)
...     return num*num
>>> with np.testing.assert_warns(DeprecationWarning):
...     assert deprecated_func(4) == 16
>>> # or passing a func
>>> ret = np.testing.assert_warns(DeprecationWarning, deprecated_func, 4)
>>> assert ret == 16

scico.numpy.testing.break_cycles()#

Break reference cycles by calling gc.collect.

Objects can call other objects’ methods (for instance, another object’s __del__) inside their own __del__. On PyPy, the interpreter only runs between calls to gc.collect, so multiple calls are needed to completely release all cycles.

scico.numpy.testing.build_err_msg(arrays, err_msg, header='Items are not equal:', verbose=True, names=('ACTUAL', 'DESIRED'), precision=8)#: None

scico.numpy.testing.decorate_methods(cls, decorator, testmatch=None)#

Apply a decorator to all methods in a class matching a regular expression.

The given decorator is applied to all public methods of cls that are matched by the regular expression testmatch (testmatch.search(methodname)). Methods that are private, i.e. start with an underscore, are ignored.

Parameters:

cls (class) – Class whose methods to decorate.
decorator (function) – Decorator to apply to methods
testmatch (compiled regexp or str, optional) – The regular expression. Default value is None, in which case the nose default (re.compile(r'(?:^|[\b_\.%s-])[Tt]est' % os.sep)) is used. If testmatch is a string, it is compiled to a regular expression first.

scico.numpy.testing.jiffies(_proc_pid_stat='/proc/1112/stat', _load_time=[])#

Return number of jiffies elapsed.

Return number of jiffies (1/100ths of a second) that this process has been scheduled in user mode. See man 5 proc.

scico.numpy.testing.measure(code_str, times=1, label=None)#

Return elapsed time for executing code in the namespace of the caller.

The supplied code string is compiled with the Python builtin compile. The precision of the timing is 10 milli-seconds. If the code will execute fast on this timescale, it can be executed many times to get reasonable timing accuracy.

Parameters:

code_str (str) – The code to be timed.
times (int, optional) – The number of times the code is executed. Default is 1. The code is only compiled once.
label (str, optional) – A label to identify code_str with. This is passed into compile as the second argument (for run-time error messages).

Returns:

elapsed (float) – Total elapsed time in seconds for executing code_str times times.

Examples

>>> times = 10
>>> etime = np.testing.measure('for i in range(1000): np.sqrt(i**2)', times=times)
>>> print("Time for a single execution : ", etime / times, "s")  
Time for a single execution :  0.005 s

scico.numpy.testing.memusage(_proc_pid_stat='/proc/1112/stat')#: Return virtual memory size in bytes of the running python.

scico.numpy.testing.print_assert_equal(test_string, actual, desired)#

Test if two objects are equal, and print an error message if test fails.

The test is performed with actual == desired.

Parameters:

test_string (str) – The message supplied to AssertionError.
actual (object) – The object to test for equality against desired.
desired (object) – The expected result.

Examples

>>> np.testing.print_assert_equal('Test XYZ of func xyz', [0, 1], [0, 1])
>>> np.testing.print_assert_equal('Test XYZ of func xyz', [0, 1], [0, 2])
Traceback (most recent call last):
...
AssertionError: Test XYZ of func xyz failed
ACTUAL:
[0, 1]
DESIRED:
[0, 2]

scico.numpy.testing.raises(*args)#

Decorator to check for raised exceptions.

The decorated test function must raise one of the passed exceptions to pass. If you want to test many assertions about exceptions in a single test, you may want to use assert_raises instead.

Warning

This decorator is nose specific, do not use it if you are using a different test framework.

Parameters:: args (exceptions) – The test passes if any of the passed exceptions is raised.
Raises:: AssertionError –

Examples

Usage:

@raises(TypeError, ValueError)
def test_raises_type_error():
    raise TypeError("This test passes")

@raises(Exception)
def test_that_fails_by_passing():
    pass

scico.numpy.testing.run_module_suite(file_to_run=None, argv=None)#

Run a test module.

Equivalent to calling $ nosetests <argv> <file_to_run> from the command line

Parameters:

file_to_run (str, optional) – Path to test module, or None. By default, run the module from which this function is called.
argv (list of strings) –
Arguments to be passed to the nose test runner. argv[0] is ignored. All command line arguments accepted by nosetests will work. If it is the default value None, sys.argv is used.

New in version 1.9.0.

Examples

Adding the following:

if __name__ == "__main__" :
    run_module_suite(argv=sys.argv)

at the end of a test module will run the tests when that module is called in the python interpreter.

Alternatively, calling:

>>> run_module_suite(file_to_run="numpy/tests/test_matlib.py")  

from an interpreter will run all the test routine in ‘test_matlib.py’.

scico.numpy.testing.rundocs(filename=None, raise_on_error=True)#

Run doctests found in the given file.

By default rundocs raises an AssertionError on failure.

Parameters:

filename (str) – The path to the file for which the doctests are run.
raise_on_error (bool) – Whether to raise an AssertionError when a doctest fails. Default is True.

Notes

The doctests can be run by the user/developer by adding the doctests argument to the test() call. For example, to run all tests (including doctests) for numpy.lib:

>>> np.lib.test(doctests=True)  

scico.numpy.testing.runstring(astr, dict)#: None

scico.numpy.testing.tempdir(*args, **kwargs)#

Context manager to provide a temporary test folder.

All arguments are passed as this to the underlying tempfile.mkdtemp function.

scico.numpy.testing.temppath(*args, **kwargs)#

Context manager for temporary files.

Context manager that returns the path to a closed temporary file. Its parameters are the same as for tempfile.mkstemp and are passed directly to that function. The underlying file is removed when the context is exited, so it should be closed at that time.

Windows does not allow a temporary file to be opened if it is already open, so the underlying file must be closed after opening before it can be opened again.