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_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])