NumPy: numpy.asanyarray() function

numpy.asanyarray() function

The numpy.asanyarray() function is used to convert the input to an ndarray, but pass ndarray subclasses through.

Syntax:

numpy.asanyarray(a, dtype=None, order=None)

Parameters:

Return value:

[ndarray]
Array interpretation of a. No copy is performed if the input is already an ndarray with matching dtype and order. If a is a subclass of ndarray, a base class ndarray is returned.

Example: Convert a list to a numpy array using asanyarray()

>>> import numpy as np
>>> a = [2, 4]
>>> np.asanyarray(a)
array([2, 4])

In the above code the input a is a Python list and not a NumPy array, asanyarray() creates a new NumPy array of dtype int64 by default to represent the elements of the input list. The resulting NumPy array can be used for further mathematical computations and operations.

Pictorial Presentation:

Example: np.asanyarray() with NumPy recarrays

>>> import numpy as np
>>> a = np.array([(2.0, 3), (3.0, 5)], dtype='f4,i4').view(np.recarray)
>>> np.asanyarray(a) is a
True

In the above code, first, a NumPy record array 'a' is created using the np.array() function and the view() method to convert a structured array to a record array. Then, the np.asanyarray() function is used to return 'a' as an array object. Finally, the code uses the 'is' operator to compare if the returned array object is the same as the original record array a. The code returns True indicating that the returned array object is the same as the original record array.

Python - NumPy Code Editor:

Previous: asarray()
Next: ascontiguousarray()