MaskedArray.put()

MaskedArray.put(indices, values, mode='raise') [source]

Set storage-indexed locations to corresponding values.

Sets self._data.flat[n] = values[n] for each n in indices. If values is shorter than indices then it will repeat. If values has some masked values, the initial mask is updated in consequence, else the corresponding values are unmasked.

Parameters:

Parameters:	indices : 1-D array_like Target indices, interpreted as integers. values : array_like Values to place in self._data copy at target indices. mode : {?raise?, ?wrap?, ?clip?}, optional Specifies how out-of-bounds indices will behave. ?raise? : raise an error. ?wrap? : wrap around. ?clip? : clip to the range.

indices : 1-D array_like

Target indices, interpreted as integers.

values : array_like

Values to place in self._data copy at target indices.

mode : {?raise?, ?wrap?, ?clip?}, optional

Specifies how out-of-bounds indices will behave. ?raise? : raise an error. ?wrap? : wrap around. ?clip? : clip to the range.

Notes

values can be a scalar or length 1 array.

Examples

>>> x = np.ma.array([[1,2,3],[4,5,6],[7,8,9]], mask=[0] + [1,0]*4)
>>> print(x)
[[1 -- 3]
 [-- 5 --]
 [7 -- 9]]
>>> x.put([0,4,8],[10,20,30])
>>> print(x)
[[10 -- 3]
 [-- 20 --]
 [7 -- 30]]

>>> x.put(4,999)
>>> print(x)
[[10 -- 3]
 [-- 999 --]
 [7 -- 30]]

Links:

https://docs.scipy.org/doc/numpy-1.11.0/reference/generated/numpy.ma.MaskedArray.put.html

doc_NumPy

2025-01-10 15:47:30

Comments