numpy.clip

原文:https://docs.scipy.org/doc/numpy/reference/generated/numpy.clip.html

译者:飞龙 UsyiyiCN

校对:(虚位以待)

numpy.clip(a, a_min, a_max, out=None)[source]

剪辑(限制)数组中的值。

给定间隔,间隔之外的值被剪切到间隔边缘。例如,如果指定[0, 1]的间隔,则小于0的值变为0,并且大于1的值变为1 。

参数:

a:array_like

数组包含要剪辑的元素。

a_min:scalar或array_like

最小值。

a_max:scalar或array_like

最大值。如果a_mina_max是array_like,则它们将被广播为a的形状。

out:ndarray,可选

结果将放置在此数组中。它可以是用于就地裁剪的输入数组。out必须是保持输出的正确形状。其类型保留。

返回:

clipped_array:ndarray

An array with the elements of a, but where values < a_min are replaced with a_min, and those > a_max with a_max.

也可以看看

numpy.doc.ufuncs
节“输出参数”

例子

>>> a = np.arange(10)
>>> np.clip(a, 1, 8)
array([1, 1, 2, 3, 4, 5, 6, 7, 8, 8])
>>> a
array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])
>>> np.clip(a, 3, 6, out=a)
array([3, 3, 3, 3, 4, 5, 6, 6, 6, 6])
>>> a = np.arange(10)
>>> a
array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])
>>> np.clip(a, [3,4,1,1,1,4,4,4,4,4], 8)
array([3, 4, 2, 3, 4, 5, 6, 7, 8, 8])