bundles / numpy 2.4.3 / numpy / delete
_ArrayFunctionDispatcher
numpy:delete
Signature
def delete ( arr , obj , axis = None ) Summary
Return a new array with sub-arrays along an axis deleted. For a one dimensional array, this returns those entries not returned by arr[obj].
Parameters
arr: array_likeInput array.
obj: slice, int, array-like of ints or boolsIndicate indices of sub-arrays to remove along the specified axis.
axis: int, optionalThe axis along which to delete the subarray defined by
obj. Ifaxisis None,objis applied to the flattened array.
Returns
out: ndarrayA copy of
arrwith the elements specified byobjremoved. Note that delete does not occur in-place. Ifaxisis None, out is a flattened array.
Notes
Often it is preferable to use a boolean mask. For example:
>>> arr = np.arange(12) + 1 >>> mask = np.ones(len(arr), dtype=bool) >>> mask[[0,2,4]] = False >>> result = arr[mask,...]
Is equivalent to np.delete(arr, [0,2,4], axis=0), but allows further use of mask.
Examples
import numpy as np arr = np.array([[1,2,3,4], [5,6,7,8], [9,10,11,12]]) arr np.delete(arr, 1, 0)✓
np.delete(arr, np.s_[::2], 1) np.delete(arr, [1,3,5], None)✓
See also
- append
Append elements at the end of an array.
- insert
Insert elements into an array.
Aliases
-
numpy.delete