NumPy的实用函数整理之clip

NumPy函数clip()用于保留数组中在间隔范围内的值。给定一个范围，范围外的值将剪裁到范围边界。例如，如果指定的范围为[0，1]，则小于0的值变为0，大于1的值变为1。

clip()

clip(a, a_min, a_max, out=None, **kwargs)

其中参数：

• a:要被剪裁的NumPy数组
• a_min: 是最小值，可以是数值，NumPy数组或者空值None
• a_max: 是最最大值，可以是数值，NumPy数组或者空值None。最大值和最小值最多只有一个可以为空值None。如果a_min或者a_max是数组那么其维度必须与a相同。
• out：数组，默认为None。结果将放置在此数组中。可以为输入阵列。out必须具有正确的维度才能保存输出。

函数返回值：

NumPy数组，维度与a相同，数组a不会被改变。

具体例子如下：
例一：
输入：

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

输出：

array([3, 3, 3, 3, 4, 5, 6, 6, 6, 6])

此时a会改变为剪裁后的数组

例三：

输入：

a = np.arange(10)

输入：

np.clip(a, [2, 4, 6, 1, 1, 4, 4, 4, 4, 4], 8)

输出：

np.clip(a, [2, 4, 6, 1, 1, 4, 4, 4, 4, 4], 8)

最小值数组表示a中对应元素的最小值，例如a中的第一个数值对应的最小值是2，最大值是8。最小值和最大值参数可以同时为数组，如下例：

例四：
输入：

np.clip(a, [2, 4, 3, 1, 1, 4, 4, 4, 4, 4], [9, 7, 6, 5, 5, 8, 9, 7, 8, 6])

输出：

array([2, 4, 3, 3, 4, 5, 6, 7, 8, 6])

此时a中的第一个数值对应的最小值是2，最大值是9。