numpy.clip

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

剪辑（限制）数组中的值。

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

参数：

a：array_like

数组包含要剪辑的元素。

a_min：scalar或array_like

最小值。

a_max：scalar或array_like

最大值。如果a_min或a_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])