numpy.fromiter
- numpy. fromiter ( iter, dtype, count=- 1, *, like=None )
-
Create a new 1-dimensional array from an iterable object.
- Parameters
-
- iter iterable object
-
An iterable object providing data for the array.
- dtype data-type
-
The data-type of the returned array.
- count int, optional
-
The number of items to read from iterable. The default is -1, which means all data is read.
- like array_like
-
Reference object to allow the creation of arrays which are not NumPy arrays. If an array-like passed in as
like
supports the__array_function__
protocol, the result will be defined by it. In this case, it ensures the creation of an array object compatible with that passed in via this argument.New in version 1.20.0.
- Returns
-
- out ndarray
-
The output array.
Notes
Specify
count
to improve performance. It allowsfromiter
to pre-allocate the output array, instead of resizing it on demand.Examples
>>> iterable = (x*x for x in range(5)) >>> np.fromiter(iterable, float) array([ 0., 1., 4., 9., 16.])
© 2005–2021 NumPy Developers
Licensed under the 3-clause BSD License.
https://numpy.org/doc/1.22/reference/generated/numpy.fromiter.html