bundles / numpy latest / numpy / delete
_ArrayFunctionDispatcher
numpy:delete
source: /dev/numpy/build-install/usr/lib/python3.14/site-packages/numpy/lib/_function_base_impl.py:5195
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)✓
array([[ 1, 2, 3, 4],
[ 9, 10, 11, 12]])
np.delete(arr, np.s_[::2], 1) np.delete(arr, [1,3,5], None)✓
array([ 1, 3, 5, 7, 8, 9, 10, 11, 12])
See also
Aliases
numpy.delete