polars.Series.to_numpy#
- Series.to_numpy(*args: Any, zero_copy_only: bool = False, writable: bool = False, use_pyarrow: bool = True) ndarray[Any, Any] [source]#
Convert this Series to numpy. This operation clones data but is completely safe.
If you want a zero-copy view and know what you are doing, use .view().
- Parameters:
- *args
args will be sent to pyarrow.Array.to_numpy.
- zero_copy_only
If True, an exception will be raised if the conversion to a numpy array would require copying the underlying data (e.g. in presence of nulls, or for non-primitive types).
- writable
For numpy arrays created with zero copy (view on the Arrow data), the resulting array is not writable (Arrow data is immutable). By setting this to True, a copy of the array is made to ensure it is writable.
- use_pyarrow
Use pyarrow for the conversion to numpy.
Examples
>>> s = pl.Series("a", [1, 2, 3]) >>> arr = s.to_numpy() >>> arr array([1, 2, 3], dtype=int64) >>> type(arr) <class 'numpy.ndarray'>